Nginx反向代理动态端口Node服务Swagger访问异常问题咨询

数据老陈

2026-10-9

问题根因

Nginx的proxy_pass指令包含变量时，不会启用默认的隐式路径替换与本地地址解析逻辑，需要额外配置解析规则。同时你当前Node服务的中间件加载顺序、Swagger静态配置也会引发访问异常。

解决方案步骤

1. 验证正则捕获变量有效性

首先确认server_name正则提取的$PORTSERVER变量正确，在server块中添加测试路由：

location /test-port {
    return 200 "Current port: $PORTSERVER";
}

访问http://backendxxx.domain.com/test-port，确认返回的端口值和你启动的Node服务端口一致，无多余字符。

2. 调整Nginx反向代理配置

在server块中新增resolver配置，同时调整proxy_pass的写法：

server_name ~^backend(?<PORTSERVER>[^.]+)\.domain\.com$;

# 替换为你服务器/etc/resolv.conf中的nameserver地址即可，本地测试也可以填8.8.8.8
resolver 127.0.0.53 valid=300s ipv6=off;
resolver_timeout 5s;

# 统一添加代理头，避免Node服务拿到错误的请求信息
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;

location /swagger/ {
    set $target http://127.0.0.1:$PORTSERVER$request_uri;
    proxy_pass $target;
}

location /api/ {
    set $target http://127.0.0.1:$PORTSERVER$request_uri;
    proxy_pass $target;
}

3. 调整Node服务配置

3.1 修正cors中间件加载顺序

cors中间件需要放在所有路由配置之前，否则接口和Swagger请求不会生效跨域配置：

const app = express();
// 移到最开头
app.use(cors());
app.use(bodyParser.json());
app.use(bodyParser.urlencoded());
// 其余原有配置保持不变

3.2 动态适配Swagger域名

修改Swagger初始化逻辑，动态替换配置中的host字段，避免Swagger请求打到固定地址：

// 替换原有的Swagger配置
app.use('/swagger', swaggerUi.serve, (req, res, next) => {
  swaggerDocument.host = req.get('host');
  swaggerUi.setup(swaggerDocument)(req, res, next);
});