IBM Hyperledger Fabric运行enrollAdmin.js遇CA连接超时错误

该CONNECTION Timeout报错不属于身份鉴权类错误，是运行enrollAdmin.js的节点与Fabric CA服务端在TCP/TLS建链阶段就未完成连通，请求还未到达CA的业务处理逻辑就触发了超时中断。

• 网络配置偏差：代码中直接读取config.json的caName字段作为CA服务访问地址，未做格式校验与连通性校验，常出现URL漏写http/https前缀、端口配置错误、云端安全组未放行CA服务端口、CA容器未正常启动的问题，直接触发连接超时。
• 运行时与依赖版本不兼容：当前环境使用Node.js v15.4.0 + Hyperledger Fabric v2.2，而evote教程配套的fabric-ca-client、fabric-network依赖为适配旧版Fabric 1.4.x的版本，旧版客户端与Node 15的TCP/TLS栈存在兼容问题，会导致建链流程挂起直至超时。
• 客户端初始化配置缺失：现有代码初始化FabricCAServices实例时仅传入了CA服务URL，未配置TLS信任证书、自定义连接超时参数，依赖的默认超时时长仅3秒左右，云端部署场景下网络延迟稍高就会在TLS握手阶段超时；如果CA采用HTTPS服务且未将CA根证书加入客户端信任池，也会出现TLS握手无响应的超时问题。
• CA服务端绑定异常：Fabric CA容器虽处于运行状态，但进程实际绑定在127.0.0.1回环地址，外部节点无法访问，也会触发连接超时。

• 第一步：验证CA基础连通性
  在执行脚本的节点上，使用curl命令测试CA的信息接口：curl -v <config.json中配置的caURL>/cainfo
  • 若返回Connection refused，说明CA服务未正常启动、端口配置错误、云端安全组未放行对应端口，优先排查服务状态与网络规则
  • 若返回TLS握手类错误，说明是证书信任配置缺失
  • 若返回正常的CA信息JSON，说明网络层连通无问题，故障点在客户端代码配置
• 第二步：对齐适配版本依赖
  卸载项目中原教程自带的旧版Fabric客户端依赖，安装与Fabric v2.2匹配的2.2.x版本客户端：

  npm uninstall fabric-ca-client fabric-network
  npm install fabric-ca-client@2.2.0 fabric-network@2.2.0
  

  该版本客户端可兼容Node.js v15.4.0的运行时，解决旧版客户端的TCP栈兼容问题。
• 第三步：修正CA客户端初始化逻辑
  补充FabricCAServices实例的必要配置，避免默认配置导致的超时问题，核心调整点：
  • 读取本地存储的CA根证书，加入客户端TLS信任池
  • 自定义15秒的连接超时时长，适配云端网络延迟
    调整后的初始化参考代码：

  // 读取CA根证书
  const caRootCert = fs.readFileSync('<本地存储的CA根证书文件路径>');
  const ca = new FabricCAServices(caURL, {
    trustedRoots: caRootCert,
    verify: false, // 排查阶段可暂时关闭证书校验，定位问题后再按需开启
    timeout: 15000
  });
  

• 第四步：排查CA服务端监听配置
  进入Fabric CA容器，执行netstat -tulnp | grep <CA服务端口>，检查CA进程的绑定地址是否为0.0.0.0；如果绑定地址为127.0.0.1，需要修改CA服务的配置文件，将监听地址调整为0.0.0.0后重启CA服务。
• 第五步：清理本地残留状态
  删除项目根目录下已存在的wallet文件夹，避免残留的损坏身份文件干扰流程，再重新执行node enrollAdmin.js脚本验证。

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