Docker环境下Node.js单元测试调用外部API出现ECONNRESET问题求助

问题核心 #

本地运行Node.js单元测试调用Stripe/PayPal API完全正常，但在Docker（Jenkins容器）内运行时触发ECONNRESET连接重置错误。

排查与解决步骤 #

1. 澄清端口暴露的误区 #

你当前的docker run命令映射的8080、50000端口，是用于外部访问容器内服务的。而容器调用外部API是主动向外发起请求，不需要暴露端口，所以问题不在端口映射上。

2. 验证容器基础网络连通性 #

先进入Jenkins容器内部，测试网络是否正常：

docker exec -it <容器ID/名称> bash
# 测试DNS解析是否正常
nslookup api.stripe.com
nslookup api-m.sandbox.paypal.com
# 测试HTTPS连接是否能建立
curl -v https://api.stripe.com/v1/charges

如果DNS解析失败，可在启动容器时手动指定公共DNS：

docker run --dns 8.8.8.8 --dns 8.8.4.4 -p 8080:8080 -p 50000:50000 -v /Users/nicolovanzo/Documents/jenkins:/var/jenkins_home -v /Users/nicolovanzo/Documents/work/storm/backups/firestore:/var/jenkins_home/firestore  -v /Users/nicolovanzo/Documents/work/storm/firebase_keys/dev.json:/var/jenkins_home/firebase_keys/dev.json jenkins/jenkins

3. 排查宿主机网络限制 #

• 关闭宿主机的代理软件（如VPN、Charles）后重新测试，避免代理拦截容器的外部请求
• 检查宿主机防火墙规则，确保允许Docker默认子网（通常是172.17.0.0/16）向外发起443端口的HTTPS请求

4. 调整Node.js SDK配置 #

• 确认Stripe/PayPal SDK没有强制使用代理，容器内无代理配置时需手动关闭：

  const stripe = require('stripe')('你的密钥', {
    httpAgent: new require('https').Agent({ proxy: false })
  });
  

• 延长SDK请求超时时间，避免因网络延迟导致连接重置：

  const stripe = require('stripe')('你的密钥', {
    timeout: 30000 // 设置为30秒超时
  });
  

5. 修复容器环境限制 #

• Jenkins官方镜像默认用户权限较低，可尝试以root用户启动容器：

  docker run -u root -p 8080:8080 -p 50000:50000 -v /Users/nicolovanzo/Documents/jenkins:/var/jenkins_home -v /Users/nicolovanzo/Documents/work/storm/backups/firestore:/var/jenkins_home/firestore  -v /Users/nicolovanzo/Documents/work/storm/firebase_keys/dev.json:/var/jenkins_home/firebase_keys/dev.json jenkins/jenkins
  

• 容器内缺少CA证书可能导致HTTPS证书验证失败，安装证书包（Debian/Ubuntu系）：

  apt-get update && apt-get install -y ca-certificates
  

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