Node.js获取页面完整URL时HTTPS被识别为HTTP如何解决

DevOps 小满

2026-8-28

问题根因

HTTPS协议识别错误基本都是因为服务部署在反向代理（Nginx、负载均衡、CDN等）后：TLS握手在代理层完成，代理转发到Node服务时走的是内部HTTP链路，同时Web框架默认不信任代理透传的请求头，导致req.protocol只能拿到内部转发的HTTP值，和用户实际访问的协议不一致。

修复步骤

第一步：开启框架的代理信任配置
如果你使用Express框架，在服务初始化逻辑中添加如下配置：
```
// 放在路由注册前执行
app.set('trust proxy', true);
```
如果你使用Koa框架，初始化实例时直接开启proxy参数：
```
const app = new Koa({ proxy: true });
```
配置开启后，框架会自动从反向代理透传的X-Forwarded-Proto请求头中读取用户真实访问协议，此时req.protocol就能正确返回HTTPS值。框架内置的代理信任逻辑会校验请求来源IP是否属于可信代理段，避免用户伪造请求头篡改协议。
第二步：确认反向代理正确透传协议头
以最常用的Nginx反向代理为例，需要在转发规则中添加如下头配置，确保真实协议被传递到Node服务：
```
location / {
    proxy_pass http://你的node服务地址;
    proxy_set_header X-Forwarded-Proto $scheme;
    proxy_set_header Host $host;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
}
```
如果使用云厂商的负载均衡、CDN服务，直接在控制台对应配置项中开启X-Forwarded-Proto头透传即可。

代码优化

你原来的URL拼接逻辑存在小缺陷：req.originalUrl本身包含查询字符串部分，直接传入pathname字段会导致query部分被错误转义，修正后的完整实现可以参考两种写法：

const url = require('url');

// 写法1：用url.format规范拼接
function fullUrl(req) {
    return url.format({
        protocol: req.protocol,
        host: req.get('host'),
        pathname: req.path,
        query: req.query
    });
}

// 写法2：直接字符串拼接，更简洁
function fullUrl(req) {
    return `${req.protocol}://${req.get('host')}${req.originalUrl}`;
}

注意：不要在未开启代理信任配置的情况下，手动读取X-Forwarded-Proto头取值，未做来源校验的请求头可以被任意用户伪造，存在安全隐患。

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