部署Node.js站点至Heroku后无法连接外部API，本地运行正常

这种情况我之前踩过不少坑，Heroku的网络环境和本地确实存在差异，给你几个实用的排查方向：

• 先排除Heroku网络层面的问题
  直接在Heroku控制台里用curl命令调用目标API，比如：

  heroku run curl -v https://your-target-api.com/endpoint
  

  如果这个命令也返回503，那基本可以确定是Heroku和外部API之间的网络问题（比如API屏蔽了Heroku的IP池、端口限制），和你的代码无关；如果curl能正常拿到响应，再去排查代码逻辑。

• 核对请求头的一致性
  本地和Heroku环境的默认请求头可能不一样，很多API会对User-Agent、Authorization这类头做校验：

  • 显式设置User-Agent，避免Heroku的默认UA被API拦截：

    import got from 'got';
    const response = await got('https://your-api-url', {
      headers: {
        'User-Agent': 'Your-Heroku-App/1.0.0', // 自定义UA
        'Authorization': `Bearer ${process.env.API_TOKEN}` // 确保密钥从环境变量读取
      }
    });
    

  • 检查Content-Type是否匹配API要求，比如API需要application/json，就不要传text/plain。

• 深挖Heroku日志的细节
  用实时日志排查最靠谱，执行命令：

  heroku logs --tail
  

  触发API调用后，看日志里的具体报错：

  • 如果是ETIMEDOUT或ENOTFOUND，说明是DNS解析或连接超时，大概率是外部API的网络限制；
  • 如果日志显示是外部API返回的503，那要去看API的限流规则或状态公告；
  • 如果是Heroku的反向代理返回的503，可能是你的应用超时或资源不足。

• 检查外部API的访问限制
  有些API会屏蔽云服务商的IP段（比如Heroku的出站IP是动态的），或者需要IP白名单：

  • 查看目标API的文档，确认是否有云平台访问限制；
  • 如果需要固定IP，可以用Heroku的第三方插件来获取静态出站IP，再把这个IP加入API的白名单。

• 验证HTTPS和SSL证书
  Heroku环境对SSL的要求比本地严格：

  • 确保你调用的是HTTPS地址，不要写死HTTP；
  • 测试是否是证书信任问题（仅用于排查，不要上线）：

    const response = await got('https://your-api-url', {
      https: { rejectUnauthorized: false }
    });
    

    如果这样能成功，说明API的SSL证书在Heroku的信任链里不被认可，需要联系API方修复证书，或者手动添加证书到你的应用。

• 确认环境变量配置
  本地的.env文件里的配置，要确保在Heroku上已经通过heroku config:set设置好，比如API密钥、API地址这些：

  heroku config:set API_URL=https://your-target-api.com API_TOKEN=your-secret-token
  

  避免因为环境变量缺失导致请求到错误的地址，返回503。

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