NodeJS下Fetch-API的Referrer异常：无法保留含路径的完整来源URL

问题核心 #

你在Node.js环境使用Fetch API时，设置带路径的Referrer（如https://www.httpdebugger.com/Tools/），但服务器仅接收到根域名；同时发现referrerPolicy配置被忽略，而浏览器中XMLHttpRequest无此问题。

问题原因 #

1. 错误的referrerPolicy配置：你代码中设置了referrerPolicy: "no-referrer"，该策略会直接禁止发送Referer头，实际服务器能收到根域名，说明你使用的Fetch实现（如jsdom或node-fetch）对该策略的处理不符合预期。
2. Node.js Fetch实现的差异：Node.js原生无Fetch API，常用的jsdom模拟版或node-fetch库，在跨源场景下的Referrer截断逻辑和浏览器不一致。
3. 跨源规则的环境差异：浏览器中XHR和Fetch的默认Referrer策略不同，且Node.js作为服务端环境，本身不受浏览器同源策略的严格限制，但部分Fetch实现会模拟浏览器规则截断路径。

修复方案 #

方案1：修正配置并使用jsdom模拟浏览器环境 #

如果依赖jsdom模拟浏览器行为，需先初始化环境，确保Fetch遵循浏览器规则：

const { JSDOM } = require("jsdom");

// 初始化jsdom，设置当前页面URL作为Referrer基准
const dom = new JSDOM("", {
  url: "https://www.httpdebugger.com/Tools/"
});
global.fetch = dom.window.fetch;

fetch("https://www.httpdebugger.com/Tools/ViewBrowserHeaders.aspx", {
  referrer: "https://www.httpdebugger.com/Tools/",
  credentials: 'include',
  mode: 'cors',
  referrerPolicy: "unsafe-url" // 强制发送完整Referrer路径
})
.catch(err => console.log(err))
.then(result => result.text())
.then(result => console.log(result));

• unsafe-url：会发送完整的Referrer URL（含路径），适合需要跨源传递完整路径的场景；若需更严格的策略，可改用origin-when-cross-origin（同源发完整路径，跨源发根域名）。

方案2：改用node-fetch手动设置Referer头 #

node-fetch支持直接手动设置请求头，绕过模拟的浏览器规则：

1. 安装依赖：

npm install node-fetch@2

2. 修改代码：

const fetch = require('node-fetch');

fetch("https://www.httpdebugger.com/Tools/ViewBrowserHeaders.aspx", {
  headers: {
    'Referer': 'https://www.httpdebugger.com/Tools/' // 手动指定完整Referer
  },
  credentials: 'include',
  mode: 'cors'
})
.catch(err => console.log(err))
.then(result => result.text())
.then(result => console.log(result));

方案3：切换到axios客户端 #

axios作为更成熟的HTTP客户端，处理请求头更直接：

1. 安装依赖：

npm install axios

2. 代码示例：

const axios = require('axios');

axios.get("https://www.httpdebugger.com/Tools/ViewBrowserHeaders.aspx", {
  headers: {
    'Referer': 'https://www.httpdebugger.com/Tools/'
  },
  withCredentials: true
})
.then(response => console.log(response.data))
.catch(err => console.log(err));

关键提示 #

Node.js环境下的HTTP客户端本质是服务端请求，不受浏览器同源策略限制，手动设置Referer头即可直接发送完整路径，无需依赖referrerPolicy的模拟规则。

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