fabric应用需反复调用new gateway()和getnetwork()，因其api采用「连接—定位—执行」三段式设计：先初始化tls并建立grpc连接，再校验通道、加载链码定义，最后执行合约；跳过getnetwork()会报network未定义，复用未刷新的network则可能读取过期账本状态。
为什么 Fabric 应用里总要写一堆 new Gateway() 和 getNetwork()？
因为 Fabric Gateway API 的设计本质是「连接—定位—执行」三段式，不是直连 peer 的裸 RPC。跨模块调用变繁琐，根本原因不是代码写得丑，而是每个模块若独立封装连接逻辑，就会重复做三件事：初始化 TLS 证书、建立 gRPC 连接、获取合约实例。一旦某处漏掉 gateway.disconnect()，连接就泄漏；某处复用未刷新的 network 实例，就可能读到过期账本状态。
- 别把
Gateway当成单例全局变量硬塞进 utils — 它带状态（TLS session、channel cache），多模块并发调用时容易错乱 - 不要在每个 service 函数里都
await gateway.getNetwork("mychannel")— 网络对象本身轻量，但反复获取会触发内部 channel discovery，增加毫秒级延迟 - 证书路径、MSP ID、wallet 目录这些参数，必须和链码部署时用的组织身份严格一致，否则
endorsement rejected: identity is not authorized
connect() 后必须立刻 getNetwork() 吗？
不是必须，但跳过这步直接调合约会报 TypeError: network is not defined。getNetwork() 不只是“取个对象”，它实际做了两件事：校验通道是否存在、加载该通道下所有已提交的链码定义（即 ChaincodeDefinition）。如果模块只读不写，且确定链码已安装并提交，可以缓存 network 实例 — 但注意：network 不自动感知链码升级，升级后必须重新 getNetwork()。
- 缓存
network是安全的，只要你不调用network.getChannel().close() - 如果模块需要切换通道（比如从
mychannel切到finance-channel），必须新建network，不能复用旧实例 - 调用
network.getContract("basic")时，传入的链码名必须和peer lifecycle chaincode approveformyorg时指定的--name完全一致（区分大小写）
gRPC 连接失败常见错误和对应检查点
错误往往卡在 TLS 握手或 DNS 解析，而不是合约逻辑层。最典型的三个报错：
-
connect ECONNREFUSED 127.0.0.1:7051：检查GATEWAY_PEER_URL是否指向 peer 节点的grpcport（不是eventport），且该 peer 已加入目标通道 -
connection closed：wallet 里私钥和证书不匹配，或 MSP ID 写错（比如用了Org1MSP却把证书放在Org2目录下） -
UNAVAILABLE: Connection dropped：peer 节点内存不足被 OOM kill，或 Docker 容器没暴露 7051 端口（docker-compose.yml里漏了- "7051:7051"）
建议在 connect 前加一行日志：console.log("connecting to", gatewayPeerUrl)，确认 URL 拼写无空格、协议头是 grpcs://（不是 https://）。
如何让多个业务模块共享同一套连接而不互相干扰？
用工厂函数封装，而非全局变量。例如导出一个 getContract(channelName, chaincodeName)，内部统一管理 gateway 生命周期：
export async function getContract(channelName, chaincodeName) {
const wallet = await Wallets.newFileSystemWallet(path.join(__dirname, 'wallet'));
const gateway = new Gateway();
await gateway.connect(connectionProfile, {
wallet,
identity: 'appUser',
discovery: { enabled: true, asLocalhost: true }
});
const network = await gateway.getNetwork(channelName);
const contract = network.getContract(chaincodeName);
// 不在这里 disconnect() — 让调用方决定何时释放
return { contract, cleanup: () => gateway.disconnect() };
}
关键点：每个业务模块拿到的是独立 contract 实例，但底层共用同一个 gateway 连接池；cleanup 由上层业务决定时机，避免提前断连影响其他并发请求。
真正容易被忽略的是 discovery 配置 — 测试网络默认设 asLocalhost: true，但生产环境必须关掉，否则所有 peer 地址会被强制替换成 localhost，导致跨主机调用失败。
