安装链码后Peer节点未找到链码的Hyperledger Fabric问题排查

首先帮你理清两个查询命令的差异，先消除你的疑惑：

• peer lifecycle chaincode queryinstalled 是Fabric 2.x引入的新链码生命周期专属命令，用来查询当前节点上安装的链码包，所以能查到结果是完全正常的，说明链码确实安装在这个节点上了。
• peer chaincode list --installed 是Fabric 1.x的旧生命周期命令，在2.x环境下只有用旧方式部署的链码才会被它检测到，所以返回空完全正常，不用纠结这个输出。

接下来重点解决你遇到的invoke报错：chaincode definition for 'fabcar' exists, but chaincode is not installed。这个错误的核心原因是：链码的定义已经提交到通道，但执行invoke时涉及的某个背书节点上没有安装对应的链码，或者安装的链码包ID和通道定义中的不匹配。下面是具体的排查和解决步骤：

1. 核对通道链码定义与本地安装的包ID #

首先查询通道上已提交的链码定义，确认它的包ID和你本地安装的是否一致：

peer lifecycle chaincode querycommitted -C appchannel -n fabcar

这个命令会返回类似这样的结果：

Committed chaincode definition for chaincode 'fabcar' on channel 'appchannel':
Version: 1.0, Sequence: 1, Endorsement Plugin: escc, Validation Plugin: vscc, Approvals: [Org1MSP: true, Org2MSP: true], Package ID: fabcar_1:644530ed4e097a65073d6e0fc8a7aaa9282945e55aa1ec7d2014746fd598f631

把这里的Package ID和你用peer lifecycle chaincode queryinstalled查到的对比，如果不一致，说明你安装的链码包和通道上定义的不匹配——你需要重新安装对应ID的链码包，或者重新走一遍approve+commit流程绑定正确的包ID。

2. 确保所有背书节点都安装了链码 #

Fabric的背书策略要求满足策略的所有peer都必须安装对应的链码。比如test-network默认的背书策略是需要Org1和Org2的peer共同背书，那你必须在peer0.org1和peer0.org2上都安装相同的链码包：

操作步骤： #

• 切换到Org2的环境变量（示例配置）：

export CORE_PEER_TLS_ENABLED=true
export CORE_PEER_ADDRESS=peer0.org2.example.com:9051
export CORE_PEER_MSPCONFIGPATH=/opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/peerOrganizations/org2.example.com/users/Admin@org2.example.com/msp
export CORE_PEER_LOCALMSPID="Org2MSP"

• 执行查询命令确认Org2的peer上是否安装了链码：

peer lifecycle chaincode queryinstalled

如果返回空，说明Org2的peer没安装，需要重新安装：

# 用打包好的链码包安装
peer lifecycle chaincode install fabcar.tar.gz
# 或者直接从源码构建安装（根据链码语言调整路径）
peer lifecycle chaincode install -n fabcar -v 1.0 -p github.com/hyperledger/fabric-samples/chaincode/fabcar/go/

安装完成后，再次查询确认Package ID和Org1的一致。

3. 补全链码生命周期的approve与commit步骤 #

如果之前你只做了链码安装，没完成组织approve和通道commit，那链码定义其实没有真正生效（报错里说“definition exists”可能是你之前尝试过commit但没完成）。重新走一遍完整的2.x链码生命周期流程：

a. 安装链码（所有需要背书的peer，已做过可跳过） #

参考上面步骤2的安装命令，确保Org1和Org2的peer都安装了相同的链码包，记下Package ID（比如赋值给PACK_ID）：

PACK_ID=fabcar_1:644530ed4e097a65073d6e0fc8a7aaa9282945e55aa1ec7d2014746fd598f631

b. 每个组织approve链码定义 #

# 切换到Org1环境，执行approve
peer lifecycle chaincode approveformyorg -C appchannel -n fabcar -v 1.0 --package-id $PACK_ID --sequence 1

# 切换到Org2环境，执行approve
peer lifecycle chaincode approveformyorg -C appchannel -n fabcar -v 1.0 --package-id $PACK_ID --sequence 1

这里的--sequence是链码的版本序列，第一次提交用1，后续升级递增。

c. 提交链码定义到通道 #

用任意一个组织的身份执行（需要满足通道的修改策略，test-network默认需要两个组织都同意）：

peer lifecycle chaincode commit -C appchannel -n fabcar -v 1.0 --sequence 1 --peerAddresses peer0.org1.example.com:7051 --peerAddresses peer0.org2.example.com:9051

d. 确认提交状态 #

再次执行查询命令，确保所有组织的Approved状态都是true：

peer lifecycle chaincode querycommitted -C appchannel -n fabcar

4. 检查Docker环境的环境变量设置 #

因为你是自己构建自给自足的Docker环境，很容易出现环境变量配置错误的问题：

• 确认CORE_PEER_ADDRESS指向的是已经安装了链码的peer节点
• 确认CORE_PEER_MSPCONFIGPATH是当前组织Admin用户的MSP目录
• 确认CORE_PEER_LOCALMSPID是对应的组织ID（比如Org1MSP或Org2MSP）

比如在Org1的peer上执行invoke时，环境变量应该类似这样：

export CORE_PEER_TLS_ENABLED=true
export CORE_PEER_ADDRESS=peer0.org1.example.com:7051
export CORE_PEER_MSPCONFIGPATH=/opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/peerOrganizations/org1.example.com/users/Admin@org1.example.com/msp
export CORE_PEER_LOCALMSPID="Org1MSP"

5. 检查链码容器是否正常启动 #

第一次invoke链码时，peer会自动启动对应的链码容器，你可以用docker ps查看是否有类似dev-fabcar-1-xxxx的容器。如果没有，说明链码启动失败，可以查看peer的日志排查：

docker logs peer0.org1.example.com

日志里会显示链码启动失败的具体原因（比如链码代码错误、Docker网络不通等）。

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