在WSL Ubuntu本地部署Avalanche EVM子网时遇健康检查超时错误

1. 先找对日志位置 #

avalanche-cli本地部署的日志不在/var/log/目录，默认存在用户主目录的隐藏文件夹里，具体路径是：
~/.avalanche-cli/local/chains/somechain/
进入该目录后能看到各个节点的日志文件（比如node0.log），查看日志里的具体报错是最直接的排查方式。

2. 调整WSL资源配置 #

WSL默认分配的内存、CPU资源可能不足以支撑avalanche本地节点运行，容易导致启动超时或崩溃：

• 打开Windows用户目录（C:\Users\你的用户名），创建或编辑.wslconfig文件，添加以下配置：

[wsl2]
memory=8GB
processors=4
swap=4GB
localhostForwarding=true

• 保存后重启WSL：在Windows终端执行wsl --shutdown，再重新打开Ubuntu环境。

3. 排查端口冲突 #

avalanche本地节点默认使用9650、9651等端口，先检查这些端口是否被其他进程占用：

sudo lsof -i :9650
sudo lsof -i :9651

如果发现占用，杀掉对应进程，或者修改avalanche-cli的部署端口配置。

4. 修复WSL网络异常 #

WSL网络配置偶尔会出现异常，导致CLI与节点的RPC通信超时：

• 先尝试重启WSL网络服务：

sudo service networking restart

• 若无效，重置WSL网络：在Windows终端执行wsl --shutdown，打开控制面板\网络和 Internet\网络连接，找到名为vEthernet (WSL)的虚拟网卡，禁用后再启用，最后重新启动WSL。

5. 升级avalanche-cli版本 #

旧版本CLI可能存在兼容性问题，先升级到最新版：

avalanche-cli upgrade

若升级失败，直接重新安装：

curl -sSfL https://raw.githubusercontent.com/ava-labs/avalanche-cli/main/scripts/install.sh | sh -s

内容的提问来源于stack exchange，提问作者Nikita Kulikov