node-fetch v2中GitHub API授权正常，升级v3后授权失败求助

云上老周

2026-8-24

问题排查与解决方案

你的问题大概率是node-fetch v3在Agent处理、请求头校验上的隐性变更导致的，以下是具体排查点和修复方案：

1. 移除无效的`Content-Type`请求头

GET请求本身没有请求体，设置Content-type: application/json属于冗余配置。node-fetch v3对请求头的合法性校验更严格，服务器可能因为这个无效头拒绝授权，直接返回登录页。

修改后的headers：

headers: {
  Authorization: 'Basic toookenn',
  Cookie: 'yummycookie'
}

2. 显式设置Agent而非`undefined`

node-fetch v3中，agent: undefined的行为和v2不一致——v2会自动使用Node.js默认的http/https Agent，而v3可能会跳过默认Agent的初始化，导致Cookie、连接复用等功能异常。

显式声明Agent（需要先引入对应模块）：

const https = require('https'); // CommonJS环境
// 或 import https from 'https'; // ESM环境

const options = {
  agent: new https.Agent(),
  method: 'GET',
  headers: {
    Authorization: 'Basic toookenn',
    Cookie: 'yummycookie'
  }
}

3. 验证Cookie的传递有效性

如果你的授权依赖Cookie维持会话，node-fetch v3默认不再自动维护Cookie Jar（v2存在隐性处理逻辑）。需要使用fetch-cookie库包装fetch，确保Cookie在请求中正确传递：

安装依赖后修改代码：

// CommonJS环境
const fetch = require('fetch-cookie')(require('node-fetch'));
// ESM环境
import fetchCookie from 'fetch-cookie';
import fetch from 'node-fetch';
const fetch = fetchCookie(fetch);