进阶 docs.nethermind.io 2026-11-13 08:27:03 · 4 阅读
第14章 故障排除
版本:2.2.0故障排除文件描述符限制
某些情况下,文件描述符限制可能导致类似"Too many open files"的错误。解决方法请参考下面对应平台的说明。
LinuxmacOS要提高运行 Nethermind 的用户(进程名为 nethermind)的限制,执行:
sudo echo "nethermind soft nofile 100000" > /etc/security/limits.d/nethermind.conf
sudo echo "nethermind hard nofile 100000" >> /etc/security/limits.d/nethermind.conf
要临时提高限制,执行: ulimit -n 10000
如果上述命令出现问题,请参考 workaround。 注意,以上修改是临时的,系统重启后会失效。若要永久生效,可将它们添加到 ~/.bashrc 或 ~/.bash_profile 等 shell 配置文件中。 数据库损坏问题 数据库损坏是时有发生的问题之一,可能的原因包括: 硬件故障:磁盘损坏、内存错误、硬件过热等 断电或异常关机 遇到这种情况没有捷径,建议的解决方法是从头重新同步 Nethermind。 TrieNodeException 错误 如果 Nethermind 报告 Nethermind.Trie.TrieNodeException 或 Nethermind.Trie.MissingTrieNodeException 错误,通常意味着数据库损坏或数据缺失。可以尝试以下步骤: 如果节点还在同步中,等它完全同步后再观察是否仍有错误 重启节点并观察 升级到最新版本的 Nethermind 如果以上步骤都无效,可能需要重新同步 锁文件问题 如果 Nethermind 报告锁文件相关的错误,可能是以下原因之一: 另一个 Nethermind 进程正在使用同一个数据库 上次运行时数据库没有被正确关闭。
这种情况下,在 Nethermind 数据库目录中执行以下命令: find . -type f -name 'LOCK' -delete
块校验和不匹配 有时 Nethermind 可能会失败并报出类似下面的错误: Corruption: block checksum mismatch: expected 2087346143, got 2983326672 in...
这种情况多发生在内存压力极大的 XFS 文件系统上。可以通过 --Db.UseDirectIoForFlushAndCompactions true 选项缓解,但会牺牲一定的性能。 不过,这类问题往往是由内存条故障引起的。 插件加载失败 如果 Nethermind 启动失败并提示 Failed to load plugin... 之类的错误,通常是插件缺失或版本不兼容导致的。重新安装 Nethermind 一般即可解决。 提示:如果在已有安装的基础上安装 Nethermind,请先删除旧的安装目录,尤其是 plugins 目录。使用包管理器安装时会自动处理。但要注意不要误删存有同步数据的 database 目录。
sudo echo "nethermind hard nofile 100000" >> /etc/security/limits.d/nethermind.conf
要临时提高限制,执行: ulimit -n 10000
如果上述命令出现问题,请参考 workaround。 注意,以上修改是临时的,系统重启后会失效。若要永久生效,可将它们添加到 ~/.bashrc 或 ~/.bash_profile 等 shell 配置文件中。 数据库损坏问题 数据库损坏是时有发生的问题之一,可能的原因包括: 硬件故障:磁盘损坏、内存错误、硬件过热等 断电或异常关机 遇到这种情况没有捷径,建议的解决方法是从头重新同步 Nethermind。 TrieNodeException 错误 如果 Nethermind 报告 Nethermind.Trie.TrieNodeException 或 Nethermind.Trie.MissingTrieNodeException 错误,通常意味着数据库损坏或数据缺失。可以尝试以下步骤: 如果节点还在同步中,等它完全同步后再观察是否仍有错误 重启节点并观察 升级到最新版本的 Nethermind 如果以上步骤都无效,可能需要重新同步 锁文件问题 如果 Nethermind 报告锁文件相关的错误,可能是以下原因之一: 另一个 Nethermind 进程正在使用同一个数据库 上次运行时数据库没有被正确关闭。
这种情况下,在 Nethermind 数据库目录中执行以下命令: find . -type f -name 'LOCK' -delete
块校验和不匹配 有时 Nethermind 可能会失败并报出类似下面的错误: Corruption: block checksum mismatch: expected 2087346143, got 2983326672 in...
这种情况多发生在内存压力极大的 XFS 文件系统上。可以通过 --Db.UseDirectIoForFlushAndCompactions true 选项缓解,但会牺牲一定的性能。 不过,这类问题往往是由内存条故障引起的。 插件加载失败 如果 Nethermind 启动失败并提示 Failed to load plugin... 之类的错误,通常是插件缺失或版本不兼容导致的。重新安装 Nethermind 一般即可解决。 提示:如果在已有安装的基础上安装 Nethermind,请先删除旧的安装目录,尤其是 plugins 目录。使用包管理器安装时会自动处理。但要注意不要误删存有同步数据的 database 目录。