node.js使用node-fetch v2.6调用API时URL查询参数失效问题咨询

核心原因分析 #

• 请求方法不匹配：官方curl示例明确使用POST请求，你当前node-fetch配置的请求方法为GET。绝大多数服务端会对不同请求方法做独立的参数处理逻辑，很多接口只会在POST请求下读取URL上的format查询参数，GET请求会默认忽略该参数返回默认JSON格式，这是最高概率的诱因。
• 代码语法错误：你贴出的fetch配置中headers字段后缺少冒号，属于语法错误；另外授权头中使用的$(authcode)是Bash变量写法，JS单引号包裹时不会解析为实际变量值，建议改为模板字符串 `Bearer ${authcode}` 避免授权异常。
• URL拼接异常：检查拼接后的myurl实际值是否正确，是否存在参数截断、特殊字符未转义、多余斜杠或空格的问题，可直接打印myurl和curl示例URL做逐字符对比。
• 重定向丢失参数：curl示例中携带了-L参数自动跟随重定向，如果接口存在3xx重定向逻辑，部分重定向规则会主动丢弃原URL的查询参数，node-fetch默认开启自动跟随重定向，可能因此丢失参数。

排查解决步骤 #

1. 先对齐请求方法和参数：将fetch的method改为POST，同时补充curl示例中要求的FormData表单参数，你当前配置的body: null缺少了data_file和config两个必填字段，示例代码如下：

const FormData = require('form-data');
const fs = require('fs');

const form = new FormData();
form.append('data_file', fs.createReadStream('datafile.xxx'));
form.append('config', fs.readFileSync('config.json', 'utf8'));

fetch(myurl, {
  method: 'POST',
  body: form,
  headers: {
    'Authorization': `Bearer ${authcode}`,
    ...form.getHeaders()
  }
})

2. 用标准URL构造方法避免拼接错误：推荐用URL类生成带查询参数的地址，杜绝手动拼接的格式问题：

const baseUrl = 'API_URL_GOES_HERE/library';
const url = new URL(baseUrl);
url.searchParams.set('format', 'txt');
const myurl = url.toString();

3. 抓包验证实际请求：使用抓包工具（Charles、Fiddler等）捕获node-fetch实际发出的请求，确认URL是否确实携带format=txt参数，排除服务端本身的处理逻辑问题。
4. 显式声明响应格式：如果确认请求已携带参数但仍返回JSON，可在请求头中添加Accept: text/plain，部分接口会优先读取Accept头字段而不是URL参数判断返回格式。

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