Blocklet Server 故障排查自查清单

前言#

Blocklet Server 在启动，运行的过程中，可能会遇到一些常见的问题。有可能是开发者环境代理导致的应用无法访问，也有可能是 Blocklet Server 更新机制导致的域名解析错误。

比如网络切换之后，Blocklet Server 没有重启，导致域名解析记录未能及时更新，进而导致应用无法访问等等。

为了帮助开发者排查这些常见的问题，特意编写这篇自查清单，以帮助开发者迅速定位，解决一些常见的问题。

阅读对象#

本文面向的对象是具备一定开发经验的开发者。

适用范围#

此清单适用于参照

检查清单#

• 确保 server 完全关闭: 如果本地的 server 无法启动，在执行 blocklet server start 之前，请执行 blocklet server stop -f，然后检查问题是否解决
• 检查网络代理：Blocklet Server 和其中的 Blocklet 都运行在本地，访问本机上的 Server 和 Blocklet 时不应该开启全局代理，可以尝试关闭全局代理，然后检查问题是否解决
• 检查域名解析：Blocklet Server 和 Blocklet 都运行在本地，所以其 DNS 应该是解析到本机 IP？请使用 dig 之类的命令来检查 DNS 解析是否正确，如果不正确，需要看看你的路由器是有什么特别的配置
• 检查网络变化：鉴于前两条，如果本地网络切换过了，需要执行 blocklet server start ，重启后大概率问题会消失
• 检查 Blocklet Server 版本：如果 server 不是最新的 beta 版，使用 npm install -g @blocklet/cli@beta 升级之后，重启 server，问题消失了吗？
• 检查 Node.js 安装方式: 如果node.js 使用的是 fnm 安装，推荐尝试使用 nvm 安装 node.js
• 检查 Node.js 版本：特别地，在 v22.5.x 下会有问题，建议使用的版本为 21.6.0~22.4.x。切换 node.js 之后问题解决了吗？
• 检查 blocklet cli 的包管理器：如果你的 @blocklet/cli 不是使用 npm 安装的，建议卸载 @blocklet/cli，使用 npm 全局安装后重启 server，观察问题是否解决？

获得帮助#

如果上面的方案依然无法解决你的问题，请到我们的社交论坛 https://community.arcblock.io/ 寻求帮助。