Docker容器中Node.js连接Hyperledger Fabric失败问题排查

我之前调试Composer + Fabric容器化应用时也碰到过几乎一模一样的问题，核心就是身份认证环节卡壳了，给你梳理几个关键的排查和解决步骤：

一、先把connection配置的细节抠到位 #

你提到把localhost换成了容器名称，这里要注意几个很容易踩的坑：

• 容器名称必须完全匹配：比如你的peer容器叫peer0.org1.example.com，那connection配置里的peer url就得是grpcs://peer0.org1.example.com:7051，大小写、后缀一个都不能错，Fabric对这个特别敏感。
• CA配置不能瞎写：certificateAuthorities里的caName必须和Fabric CA启动时--ca.name参数的值完全一致，比如你启动CA时用了--ca.name org1-ca，那配置里就不能写Org1CA；另外CA的url要指向CA容器名称+7054端口（默认CA端口）。
• MSP ID要对应：配置里的mspid必须和你的组织MSP ID一致，比如Org1MSP，别写成org1msp或者其他变体。

二、重新检查admin卡片的生成和导入流程 #

如果卡片是在宿主机生成的，直接拿到容器里用大概率会出问题——因为卡片里的证书、密钥路径是宿主机的路径，容器根本访问不到！正确的做法是：

1. 要么在容器内部生成卡片：把connection配置文件复制到容器里，然后在容器内执行composer card create命令生成卡片；
2. 要么把证书密钥同步到容器对应路径：生成卡片时指定的证书、密钥路径，要确保容器里也有相同的文件结构，或者修改connection配置里的路径为容器内的绝对路径。

导入卡片后别着急ping，先确认卡片真的导入成功了：

composer card list

如果能看到admin@biznetwork的卡片，再执行ping命令：

composer network ping --card admin@biznetwork

如果还是报身份未注册，那问题大概率出在CA那边。

三、排查Fabric CA的身份注册状态 #

先看看CA容器的日志，有没有收到注册请求的错误信息：

docker logs ca.org1.example.com

（把ca.org1.example.com换成你的CA容器名称）
如果日志里显示“identity not found”，说明你用的admin身份根本没在CA里注册过。

那你需要先在CA里注册这个admin身份：

1. 进入CA容器：

docker exec -it ca.org1.example.com bash

2. 用CA的初始管理员账号（一般是admin/adminpw，根据你的网络配置调整）注册新的admin身份：

fabric-ca-client register --id.name admin --id.type admin --id.affiliation org1 --url http://localhost:7054 --enroll-id admin --enroll-secret adminpw

注册完成后，再重新生成admin卡片导入容器试试。

四、确认Docker网络的连通性 #

就算你把localhost换成了容器名称，如果应用容器和Fabric容器不在同一个Docker网络里，还是连不上！

1. 先查Fabric用的自定义网络：

docker network ls

一般Fabric启动脚本会创建比如fabric_test或者byfn的网络。
2. 检查你的Node.js应用容器是否在这个网络里：

docker inspect your-node-app-container | grep Networks

如果没找到对应的网络，赶紧把容器连进去：

docker network connect fabric_test your-node-app-container

（替换成你的网络名和应用容器名）

五、应用代码里的细节要注意 #

最后检查下Node.js代码里的卡片调用：

• 确保代码里用的卡片名称和导入的完全一致，比如admin@biznetwork，别打错字；
• 容器里的~/.composer目录要有读写权限，不然应用读不到卡片里的身份信息，可以执行chmod -R 755 ~/.composer调整权限。

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