Hyperledger Fabric调用链码PutState无报错但CouchDB无写入数据

核心原因 #

Hyperledger Fabric的peer chaincode invoke命令默认返回成功仅代表链码提案背书阶段执行成功，不代表交易已经被排序打包、提交到账本生效。你遇到的问题本质是交易在背书后的流程中失败，所以PutState操作不会持久化到CouchDB。

常见具体原因及对应解决办法 #

• 未等待交易提交完成就查询，或交易提交阶段失败无感知
  你当前的invoke命令未添加等待交易提交的参数，仅背书成功就返回，无法捕获后续提交阶段的错误。
  解决：修改invoke命令，添加--waitForEvent --waitForEventTimeout 30s参数，命令会等待交易提交完成后再返回，直接返回提交阶段的错误信息（如背书策略不满足、MVCC冲突等）。
• 背书策略不满足
  如果你的链码实例化时设置的背书策略需要多个组织签名（如需要Org1+Org2共同背书），你当前的调用仅向Org1的节点发起背书请求，收集到的签名不符合策略要求，交易提交时会被节点判定为无效，不会写入账本。
  解决：调用时添加--peerAddresses参数指定多个符合背书策略要求的组织节点，同时对应配置各节点的tls根证书参数。
• MVCC读写冲突
  你的链码中读取了公共keysize，如果同一时间有多个并发的GenerateNumber调用，多个交易读取到的size版本一致，先提交的交易修改size后，后续交易提交时会因size的版本不匹配触发MVCC冲突，交易被标记为无效不会写入。
  解决：可通过串行化调用该接口，或优化公共key的设计避免读写冲突。
• 目标CouchDB查询错误
  确认你查询的是对应peer节点绑定的CouchDB实例，且查询的数据库名为[通道名]_[链码名]（即你的场景下为mychannel_dataGenerator），避免查错实例或数据库。

问题排查方法 #

• 执行invoke时添加等待事件参数后，直接查看返回的错误信息即可定位大部分问题
• 可调用系统链码qscc查询交易状态：peer chaincode query -C mychannel -n qscc -c '{"Args":["GetTransactionByID","mychannel","<交易ID>"]}'，若返回的validationCode不为0则代表交易无效，对应编码可匹配失败原因
• 查看对应peer节点的运行日志，交易提交阶段的失败原因都会在日志中明确打印

额外代码隐患提示 #

你的链码中size,err := stub.GetState("size")这行忽略了err返回值，首次调用时size不存在会返回err，虽然sizeNum默认取0不影响逻辑，但建议补充err判断，避免潜在问题。

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