部署Sawtooth PoET测试网报message type 700 无对等节点连接

问题现象 #

• 部署环境：Docker 20.10.12（build 20.10.12-0ubuntu2~20.04.1）、docker-compose 1.25.0，使用官方sawtooth-default-poet.yaml配置文件部署PoET共识测试网络
• 异常表现：
  • 执行启动命令docker-compose -f sawtooth-default-poet.yaml up后，初始启动日志输出完成后，持续重复打印错误行Received message type 700 while waiting for activation message
  • 执行docker ps -a检查，所有相关容器均显示运行状态
  • 进入sawtooth-shell-default容器后执行curl http://sawtooth-rest-api-default-0:8008/peers，接口始终返回空对等节点列表，等待45分钟以上无变化，网络无法完成初始化

根因排查与对应解决方法 #

1. docker-compose 1.25.0版本网络兼容问题 #

docker-compose 1.25.0存在已知的用户定义网桥DNS解析偶发失效bug，会导致PoET共识激活阶段，验证节点之间无法通过服务名互相通信，gossip消息无法正常传递，节点一直卡在等待激活的状态，误将收到的未识别gossip消息（消息类型700）打印为错误。

• 排查操作：进入任意验证节点容器，执行ping sawtooth-validator-default-1测试跨容器连通性，若解析失败或丢包率100%即可确认该问题。
• 解决步骤：
  1. 执行docker-compose -f sawtooth-default-poet.yaml down -v清理异常环境，必须添加-v参数删除持久化存储卷，否则旧的错误状态会残留导致修复失效
  2. 将docker-compose升级至1.29.2及以上1.x稳定版本，或切换使用Docker官方compose v2插件
  3. 重新执行启动命令拉起网络

2. PoET组件启动时序不匹配 #

官方默认PoET配置的初始节点激活等待窗口为300秒，在低性能主机、资源受限的云服务器上，PoET依赖的模拟SGX服务、交易处理器启动速度慢于验证节点，会导致验证节点错过激活窗口，持续卡在等待激活状态。

• 排查操作：查看poet-validator-registry-tp容器日志，若存在重复的wait certificate not ready日志即可确认该问题。
• 解决步骤：
  1. 编辑sawtooth-default-poet.yaml配置文件，在所有validator服务的启动命令段添加两个参数：--poet.initial_wait_time 120、--poet.target_wait_time 60，缩短初始激活等待时长
  2. 同样执行docker-compose -f sawtooth-default-poet.yaml down -v清理旧环境残留数据
  3. 重新启动网络，等待2-5分钟后再查询节点状态

3. 主机端口冲突干扰gossip通信 #

若主机上残留之前运行的Sawtooth网络进程，或其他服务占用了8800（验证节点gossip通信端口）、4004（共识通信端口）、8008（REST API端口），会导致当前部署的节点收到外部无关的类型700消息，干扰正常的共识激活流程。

• 排查操作：在主机执行netstat -tulpn | grep -E '8800|4004|8008'，若存在非当前docker-compose进程占用对应端口即可确认该问题。
• 解决步骤：停止占用端口的无关进程，或修改yaml文件中的端口映射规则避开冲突端口，清理旧卷后重启网络即可。

修复生效判断标准：验证节点日志不再重复打印类型700消息错误，调用peers查询接口可返回至少3个对等节点地址，执行sawtooth block list命令可查询到持续生成的新区块。

内容的提问来源于stack exchange，提问作者negin kheirmand