使用fetch调用外部API超时但curl可正常请求的问题排查

以下是针对该问题的具体排查方向和解决方法：

1. 给Fetch添加超时控制 #

Node.js原生Fetch（包括node-fetch）默认无超时限制，而curl自带超时逻辑。如果API服务器对Node.js请求响应较慢，易导致超时。可通过AbortController手动设置超时：

const controller = new AbortController();
const timeoutId = setTimeout(() => controller.abort(), 10000); // 设置10秒超时

try {
  const response = await fetch(EXTERNAL_URL, {
    method: 'POST',
    headers: {
      'Content-Type': 'application/x-www-form-urlencoded',
    },
    body: data,
    signal: controller.signal
  });
  clearTimeout(timeoutId);
  const responseData = await response.json();
  // 业务处理逻辑
} catch (error) {
  if (error.name === 'AbortError') {
    console.log('请求超时');
  } else {
    console.error('请求出错:', error);
  }
}

2. 确保请求体编码与curl一致 #

curl的-d参数会自动将键值对编码为application/x-www-form-urlencoded格式，但Node.js中直接传入普通对象作为body时，Fetch不会自动编码，导致请求体格式错误。需将data转换为URLSearchParams实例：

// 假设data是普通对象：{ grant_type: 'XXX', scope: 'XXX', ... }
const formData = new URLSearchParams(data);

const response = await fetch(EXTERNAL_URL, {
  method: 'POST',
  headers: {
    'Content-Type': 'application/x-www-form-urlencoded',
  },
  body: formData,
});

3. 对齐代理与网络配置 #

curl会自动读取系统代理环境变量（如http_proxy、https_proxy），但Node.js的Fetch默认不会。若服务器依赖代理访问外部API，可通过以下方式配置：

方法1：设置环境变量 #

启动Node.js应用前执行：

export http_proxy=http://your-proxy:port
export https_proxy=http://your-proxy:port
node your-app.js

方法2：在Fetch中配置Agent #

先安装依赖包：npm install https-proxy-agent，再配置：

import { HttpsProxyAgent } from 'https-proxy-agent';

const agent = new HttpsProxyAgent('http://your-proxy:port');

const response = await fetch(EXTERNAL_URL, {
  method: 'POST',
  headers: {
    'Content-Type': 'application/x-www-form-urlencoded',
  },
  body: formData,
  agent: agent
});

4. 匹配TLS/SSL版本 #

Ubuntu 22.04的curl默认支持的TLS版本可能与Node.js不同，若API服务器仅支持旧版TLS（如TLS 1.0/1.1），Node.js默认会拒绝连接。可在Fetch中配置允许旧版TLS：

import https from 'https';

const agent = new https.Agent({
  secureProtocol: 'TLSv1_2_method', // 可根据API要求调整为TLSv1_1_method等
  // rejectUnauthorized: false, // 仅测试时使用，生产环境不建议关闭证书验证
});

const response = await fetch(EXTERNAL_URL, {
  method: 'POST',
  headers: {
    'Content-Type': 'application/x-www-form-urlencoded',
  },
  body: formData,
  agent: agent
});

5. 模拟curl的请求头 #

curl会自动添加默认请求头（如User-Agent），而Node.js的Fetch默认User-Agent为Node.js/xxx，部分API会拦截这类请求。可手动设置与curl一致的请求头：

const response = await fetch(EXTERNAL_URL, {
  method: 'POST',
  headers: {
    'Content-Type': 'application/x-www-form-urlencoded',
    'User-Agent': 'curl/7.81.0' // Ubuntu 22.04默认curl版本
  },
  body: formData,
});

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