容器化NodeJS服务调用Avalanche测试网超时问题求助

背景 #

正在排查容器化NodeJS Web服务的问题，该服务需与Avalanche测试网交互铸造NFT，相关代码片段如下：

//...
provider = new HDWalletProvider({
    privateKeys: [walletPrivateKey],
    providerOrUrl: "https://api.avax-test.network/ext/bc/C/rpc",
    pollingInterval: 4000,
});

const myContract = Contract(Contract_NFT);
myContract.setProvider(provider);

const _instance = await myContract.at(process.env.CONTRACT_NFT_ADDRESS);

_instance.mint(provider.getAddress(), mintURL, { from: provider.getAddress() })
//...

注：本人并非该应用开发者。

问题 #

容器启动后首次请求可成功完成，但后续请求均失败，报错code: -32603 message: 'ETIMEDOUT'，错误栈如下：

at new NodeError (node:internal/errors:387:5)
at Web3ProviderEngine.emit (node:events:502:17)
at /app/node_modules/web3-provider-engine/index.js:54:14
at afterRequest (/app/node_modules/web3-provider-engine/index.js:148:21)
at /app/node_modules/web3-provider-engine/index.js:174:21
at /app/node_modules/web3-provider-engine/index.js:232:9
at /app/node_modules/async/internal/once.js:12:16
at replenish (/app/node_modules/async/internal/eachOfLimit.js:61:25)
at /app/node_modules/async/internal/eachOfLimit.js:71:9
at eachLimit (/app/node_modules/async/eachLimit.js:43:36)
at /app/node_modules/async/internal/doLimit.js:9:16
at end (/app/node_modules/web3-provider-engine/index.js:211:5)
at Request._callback (/app/node_modules/web3-provider-engine/subproviders/rpc.js:36:21)
at self.callback (/app/node_modules/request/request.js:185:22)
at Request.emit (node:events:513:28)
at Timeout.<anonymous> (/app/node_modules/request/request.js:851:16)

Error: PollingBlockTracker - encountered an error while attempting to update latest block:
undefined
    at PollingBlockTracker._performSync (/app/node_modules/eth-block-tracker/src/polling.js:51:24)
    at processTicksAndRejections (node:internal/process/task_queues:96:5)

该应用直接在服务器操作系统中运行（非容器化）时，所有请求均可成功完成。

已尝试操作 #

• 搜索论坛调整Timeout/Interval参数，无效；
• 切换不同NodeJS版本（14.XX、16.XX），问题依旧；
• 配置Docker网络（更换驱动、IPAM配置、添加额外主机等），无改善；
• 确认容器内可通过ping、nc、dig访问目标URL，HTTPS连接可成功建立。

咨询问题 #

1. 该问题的成因是什么？
2. 如何让该应用在容器内稳定运行？
3. 是否有遗漏的排查点？

问题分析与解决方案 #

1. 可能成因 #

• 连接池泄漏/复用异常：容器环境下，HDWalletProvider或底层web3-provider-engine的连接池未正确释放，首次请求后连接被占用或失效，后续请求无法建立新连接导致超时。非容器环境因系统级TCP参数（如TIME_WAIT回收机制）更宽松，掩盖了这一问题。
• 区块跟踪器同步失败：错误栈显示PollingBlockTracker同步出错，容器内的网络延迟或DNS缓存异常可能导致轮询请求超时，进而中断后续合约交互的依赖链。
• 容器资源限制：默认的CPU/内存配额可能导致NodeJS进程在处理后续请求时资源不足，无法及时响应网络请求。

2. 修复建议 #

• 复用Provider实例并正确销毁：检查代码是否每次请求都创建新的HDWalletProvider实例，若如此改为全局复用单例；在请求结束后（如Express中间件中）调用provider.engine.stop()释放资源，避免连接泄漏。
• 替换老旧依赖库：web3-provider-engine和request库已停止维护，存在已知网络连接问题。建议替换为ethers.js生态的依赖，稳定性更优。示例代码：

  const { HDWalletProvider } = require("@ethersproject/experimental");
  const { Contract } = require("@ethersproject/contracts");
  
  // 全局复用provider实例
  let provider;
  if (!provider) {
    provider = new HDWalletProvider(walletPrivateKey, "https://api.avax-test.network/ext/bc/C/rpc");
  }
  
  const contract = new Contract(process.env.CONTRACT_NFT_ADDRESS, Contract_NFT.abi, provider.getSigner());
  await contract.mint(provider.getAddress(), mintURL);
  

• 优化容器网络参数：在Docker启动命令或docker-compose中添加--sysctl net.ipv4.tcp_tw_reuse=1 --sysctl net.ipv4.tcp_fin_timeout=30，提升TCP连接回收效率；同时增加容器CPU/内存配额，避免资源瓶颈。
• 添加请求重试机制：在合约调用逻辑外层封装重试逻辑，针对ETIMEDOUT错误自动重试1-2次，提升服务容错性。

3. 遗漏排查点 #

• 容器内网络抓包：用tcpdump在容器内抓取与Avalanche测试网的交互流量，对比首次和后续请求的TCP握手、数据包传输差异，确认是否存在连接重置或丢包情况。
• 依赖版本对比：检查容器内node_modules中web3-provider-engine、eth-block-tracker等依赖的版本，与非容器环境对比，排查版本差异导致的兼容性问题。
• 环境变量差异：对比容器与服务器OS的环境变量（如HTTP_PROXY、NODE_ENV等），确认是否有隐藏的代理或配置差异影响网络请求。
• 开启调试日志：设置环境变量DEBUG=web3-provider-engine:*，开启web3-provider-engine的调试日志，查看每次请求的详细过程，定位超时发生的具体阶段。

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