Node.js使用res.redirect重定向时URL未指向目标域名如何解决

处理GET请求时需要将用户重定向到外部域名地址，执行301重定向逻辑后，地址栏未跳转到目标外部域名，反而停留在本地服务域名localhost:3000，仅拼接了目标路径和查询参数。
已尝试两种重定向写法均未解决问题：

const success_url = 'https://site.online/success'
const query = '?order_id=123123&data=abc'

// 第一种写法
res.status(301).redirect(`${success_url}${query}`);

// 第二种写法
res.redirect(301, `${success_url}${query}`);

预期跳转结果：https://site.online/success?order_id=123123&data=abc
实际跳转结果：http://localhost:3000/success?order_id=123123&data=abc

出现这个问题的核心原因通常是两类：

1. 传入redirect方法的地址缺失协议头（比如漏写https://），框架会将传入值识别为站内相对路径，自动拼接当前服务的域名生成跳转地址。
2. 服务前端部署了反向代理（Nginx、API网关、本地开发代理工具等），但服务框架未开启代理信任配置，框架无法正确识别请求的原始域名信息，在处理重定向时错误将绝对外部地址改写为本地服务域名；部分反向代理默认开启的Location头重写规则，也会直接篡改响应里的重定向目标地址。

按以下顺序逐一排查即可解决：

• 先打印redirect方法传入的最终拼接字符串，确认字符串是带https://协议头的完整绝对地址，不存在协议头遗漏、字符串拼接错误。
• 如果服务前存在反向代理，以最常用的Express框架为例，在路由注册前添加代理信任配置，让框架正确识别代理透传的请求信息，避免错误改写重定向地址：

// 放在所有app.use、路由注册逻辑之前
app.set('trust proxy', true);

• 检查反向代理配置，关闭自动重写Location响应头的规则。以Nginx为例，在代理转发的配置块中添加如下配置，禁止代理层篡改重定向地址：

proxy_redirect off;

• 可临时绕过框架封装的redirect方法做验证，直接手动设置响应头实现重定向，如果该写法能正常跳转到目标地址，即可确认是框架配置问题：

res.status(301)
  .set('Location', 'https://site.online/success?order_id=123123&data=abc')
  .end();

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