Hyperledger Fabric JavaScript链码部署失败（容器退出码1）求助

从容器日志里的Error: Cannot find module 'node:path'可以直接定位问题：链码容器内的Node.js版本低于16.x——node:path这种带前缀的模块导入方式是Node.js 16及以上版本才支持的特性。你本地降级Node.js版本没用，因为JavaScript链码是运行在Hyperledger Fabric提供的独立Docker容器中，和本地Node环境完全无关。

1. 更换兼容的Fabric Node链码运行环境镜像 #

Hyperledger Fabric提供了不同Node版本的fabric-nodeenv镜像，需要选择Node≥16的版本，且镜像版本要和你的Fabric集群版本匹配：

• 比如Fabric 2.5版本对应hyperledger/fabric-nodeenv:2.5-node18
• Fabric 2.4版本对应hyperledger/fabric-nodeenv:2.4-node16

部署链码时直接指定该镜像：

peer chaincode install -n fabcar -v 1 -l node -p ./chaincode/fabcar --image hyperledger/fabric-nodeenv:2.5-node18

如果用Fabric Samples脚本部署，可修改脚本中的NODE_RUNTIME_IMAGE变量，替换为上述镜像地址。

2. 清理旧的链码容器与镜像 #

删除之前启动失败的链码容器和镜像，避免缓存干扰：

# 删除失败的链码容器
docker rm -f dev-peer0.org1.example.com-fabcar_1-6ab85d9d0ab315198d930d1b0eb8cf8c3f59849549226a86553e29eb1fbc0a12
docker rm -f dev-peer0.org2.example.com-fabcar_1-6ab85d9d0ab315198d930d1b0eb8cf8c3f59849549226a86553e29eb1fbc0a12

# 删除旧的链码镜像
docker rmi dev-peer0.org1.example.com-fabcar_1-6ab85d9d0ab315198d930d1b0eb8cf8c3f59849549226a86553e29eb1fbc0a12
docker rmi dev-peer0.org2.example.com-fabcar_1-6ab85d9d0ab315198d930d1b0eb8cf8c3f59849549226a86553e29eb1fbc0a12

# 删除旧的nodeenv镜像（如果存在）
docker rmi hyperledger/fabric-nodeenv:旧版本号

3. 修复链码依赖 #

进入链码目录，清理旧依赖后重新安装，确保fabric-shim版本与Fabric集群版本一致：

cd ./chaincode/fabcar
rm -rf node_modules package-lock.json
npm install fabric-shim@2.5.x # 替换为你的Fabric版本对应的shim版本
npm install

4. 重新部署链码 #

完成上述步骤后，重新执行链码安装、实例化/升级操作即可。

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