Blockscout后端服务崩溃问题分析与解决方案

问题现象

Blockscout区块链浏览器在部署过程中出现后端服务持续崩溃的情况。具体表现为：

1. 后端服务启动后立即退出
2. 前端页面无法正常加载
3. 日志显示大量连接错误

环境配置

该问题出现在以下环境中：

• 使用Docker-compose方式部署
• 后端版本为5dfad474c85d5a8a1fccab28c86ac6539d04a787
• 前端版本相同
• 运行在Linux操作系统上
• 使用Geth作为JSON RPC归档节点
• 部署的是L2链的浏览器

问题排查过程

初步尝试

用户首先尝试了删除数据目录并重新启动服务：

rm -rf services/{blockscout-db-data,logs,redis-data,stats-db-data}

但问题依旧存在。

Nginx配置问题

技术专家指出，默认的Nginx配置中需要将localhost替换为服务器IP或域名。需要修改的关键位置包括：

• 代理设置
• 上游服务器配置
• WebSocket连接配置

前端环境变量

发现前端请求被发送到域名而非IP地址，解决方案有两种：

1. 在Nginx配置中使用域名并确保通过域名访问
2. 在前端环境变量NEXT_PUBLIC_APP_HOST中设置IP地址并通过IP访问

版本回退测试

用户回退到旧版本后端服务后问题解决，表明问题可能与最新版本v6.10.0的某些特性有关。

根本原因

最新版本v6.10.0中引入的NFT媒体处理器(NFT Media Handler)功能可能是导致服务崩溃的原因。该功能在某些环境下可能无法正常工作，特别是在：

• 网络连接不稳定的环境
• 特定区块链网络配置下
• 资源受限的服务器上

解决方案

临时解决方案

对于急于解决问题的用户，可以：

1. 回退到稳定版本
2. 或者禁用NFT媒体处理器功能

禁用NFT媒体处理器的具体方法： 修改common-nft-media-handler.env文件，设置：

NFT_MEDIA_HANDLER_ENABLED=false

长期解决方案

1. 确保Nginx配置正确，所有代理设置都指向正确的IP或域名
2. 检查前端环境变量配置一致性
3. 等待官方修复NFT媒体处理器的问题
4. 考虑服务器资源是否满足最新版本的要求

最佳实践建议

1. 部署前检查：在升级到新版本前，先在测试环境验证
2. 配置管理：统一管理所有环境变量和配置文件
3. 日志监控：设置完善的日志监控系统，便于快速定位问题
4. 资源评估：评估服务器资源是否满足新功能的需求

通过以上分析和解决方案，用户应该能够解决Blockscout后端服务崩溃的问题，并建立更健壮的部署流程。