Hyperledger Sawtooth settings tp Docker容器失效及无日志问题咨询

我之前在搭建4节点PBFT共识的Sawtooth网络时也碰到过类似的问题，来分享下排查思路和实际解决方案：

一、sawtooth proposal create无响应的排查方向 #

1. 先确认PBFT共识集群状态是否正常 #

PBFT需要节点间达成共识才能处理提案，如果集群同步异常，提案会一直处于等待状态，导致命令无响应：

• 进入任意Validator容器，执行sawtooth peer list查看节点连接情况，确认4个Validator都已成功加入集群；
• 查看Validator日志（路径一般是/var/log/sawtooth/validator.log），搜索PBFT相关关键词，比如view change、consensus failed，排查是否有节点失联、视图切换失败等报错。

2. 检查提案命令的格式是否正确 #

修改sawtooth.validator.transaction_families这类配置的提案，对参数格式要求严格，很容易因为引号转义或格式错误导致命令卡住：

• 正确的命令示例应该类似：

  sawtooth proposal create --key /root/.sawtooth/keys/validator.priv --url http://localhost:8008 sawtooth.validator.transaction_families='[{"family": "sawtooth_settings", "version": "1.0", "encoding": "protobuf"}]'
  

  注意在Docker容器内执行时，要用单引号包裹整个JSON参数，避免shell解析破坏格式。

3. 确认Settings事务处理器（TP）是否正常运行 #

如果Settings TP没启动或未正确注册到Validator，提案提交后没有对应的处理逻辑，也会导致命令无响应：

• 用docker ps查看settings-tp容器的运行状态，确保容器处于Up状态；
• 在Validator容器内执行curl http://localhost:8008/peers，检查返回结果中是否包含settings-tp的注册信息。

二、Settings TP不生成日志的原因及解决 #

1. 默认日志输出到容器标准输出 #

Sawtooth官方的settings-tp镜像默认是将日志输出到容器的stdout/stderr，而不是写入本地文件。你可以直接用以下命令查看实时日志：

docker logs -f <你的settings-tp容器名称>

2. 未配置日志文件挂载与启动参数 #

如果需要将日志写入文件，需要在Docker Compose的settings-tp服务中做两处配置：

• 添加卷挂载，将容器内的日志目录映射到宿主机：

  volumes:
    - ./sawtooth-logs/settings-tp:/var/log/sawtooth
  

• 修改启动命令，指定日志文件路径：

  command: settings-tp -v --log-file /var/log/sawtooth/settings-tp.log --connect tcp://validator:4004
  

3. 容器未正常启动 #

如果settings-tp容器处于Exited状态，自然不会生成日志。用docker ps -a查看容器状态，检查启动命令中的Validator连接地址是否正确，或者环境变量配置是否有误。

我身边几个做Sawtooth开发的朋友也遇到过类似问题，大部分是PBFT集群同步异常或提案格式错误导致命令无响应，日志问题基本都是因为默认输出到stdout而非文件，用docker logs就能解决。

内容的提问来源于stack exchange，提问作者Haiaty Varotto