Hyperledger Composer Rest Server v0.18.1 POST请求超时故障求助

我之前帮团队排查过类似的Composer REST Server超时问题，结合你描述的场景——运行6-7小时后POST交易调用返回500 REQUEST_TIMEOUT错误，但GET查询仍能正常获取数据，大概率是以下几个方向的问题，给你梳理下排查思路和解决办法：

1. REST Server连接池资源泄漏/失效 #

Composer REST Server默认的连接池机制，长时间运行后可能出现连接泄漏：发起交易时需要占用连接资源，但部分连接因为异常没有被回收，导致后续交易请求无法获取可用连接。而GET查询请求因为不需要执行链码交易，资源占用逻辑更轻，所以不受影响。

• 排查动作：
  • 查看REST Server的运行日志，搜索是否有connection pool exhausted或no available connections这类关键词的报错；
  • 登录IBM Blockchain控制台，查看Peer节点的连接数统计指标，确认是否到达连接上限。
• 解决办法：
  • 启动REST Server时手动调整连接池参数，比如设置空闲连接超时回收时间、延长连接超时：

    composer-rest-server -c admin@your-business-network -n true -w true --connectionTimeout 30000 --maxIdleTime 3600000
    

    其中--maxIdleTime设置为1小时（3600000毫秒），让闲置超过1小时的连接自动回收，避免无效占用；
  • 配置定期重启机制（比如用Linux cron任务每天凌晨重启一次REST Server），这是临时但有效的缓解方案。

2. IBM Blockchain Started Plan的资源配额限制 #

Started Plan作为IBM的入门级区块链服务，有明确的CPU、内存和并发交易配额。长时间运行后，交易队列堆积或者节点资源耗尽，会导致链码执行超时；而GET查询因为不需要写入账本，资源需求更低，优先级更高，所以能正常响应。

• 排查动作：
  • 登录IBM Blockchain控制台，查看Peer节点的监控面板，重点关注CPU使用率、内存使用率、交易队列长度这几个指标，如果接近上限，说明资源不足。
• 解决办法：
  • 优化交易逻辑：减少单个交易的数据量、拆分复杂交易为多个小交易，降低链码执行的资源消耗；
  • 考虑升级到Standard Plan套餐，获得更高的资源配额和并发支持，从根本上解决资源瓶颈。

3. 长连接被网络中间件断开 #

REST Server与Peer节点之间的长连接，可能被IBM的网络防火墙、负载均衡器因为长时间闲置而主动断开。当发起交易时，REST Server需要重新建立连接，但默认的请求超时时间过短，导致连接未建立完成就触发超时；而GET查询可能复用了短连接或者重连逻辑更快，所以不受影响。

• 排查动作：
  • 查看Peer节点的日志，搜索是否有session closed by remote这类连接断开的报错；
  • 用工具抓包分析REST Server与Peer之间的TCP连接状态，确认是否有大量TIME_WAIT或CLOSED状态的连接。
• 解决办法：
  • 启动REST Server时延长请求超时时间，同时开启长连接保活：

    composer-rest-server -c admin@your-business-network -n true -w true --requestTimeout 60000 --keepAlive true
    

    --requestTimeout设置为60秒，给重新连接留足够时间；--keepAlive开启后会定期发送心跳包，避免连接被中间件断开。

4. 直接提交交易的验证测试 #

你提到尝试绕过Composer REST Server直接提交交易，这一步非常关键，可以帮你快速定位问题根源：

• 验证操作：用composer network submit命令直接提交交易，观察是否同样超时：

  composer network submit -c admin@your-business-network -d '{"$class":"your.namespace.YourTransaction", "property":"your-value"}'
  

• 结果分析：
  • 如果直接提交成功：说明问题完全在Composer REST Server层面，重点排查连接池配置、资源泄漏；
  • 如果直接提交也超时：说明是区块链网络本身的问题（资源不足、Peer节点异常），可以联系IBM区块链技术支持团队协助排查。

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