使用window.location.href跳转PHP文件时出现Nginx 502错误，刷新后恢复

我有一个通过PM2运行在8080端口的Node.js应用，使用Nginx将80端口的请求反向代理至8080端口。所有功能正常运行，但当通过JavaScript的window.location.href跳转到某一PHP文件时，出现Nginx 502 Bad Gateway错误。但在报错页面刷新后，错误消失，可正常加载目标页面。

以下是相关配置与代码：

Nginx配置 #

server {
    server_name myDomainName;
    
    location / {
        proxy_pass http://127.0.0.1:8080;
        proxy_http_version 1.1;
    }
}

Node.js服务代码 #

var path = require("path");
const http = require('http');
const https = require('https');
const fs = require('fs'); 
const express = require("express");
const compression = require('compression');
const bodyParser = require("body-parser");
const cors = require("cors"); 
var phpExpress = require("php-express")({
  binPath: "php",
});
require('dotenv').config()

// express settings 
const app = express();

app.use(express.static(`${path.resolve(__dirname, '..')}/frontend/public`));
app.use('/documents',express.static(`${path.resolve(__dirname, '..')}/backend/documents`));
app.use(express.json());
app.use(bodyParser.urlencoded({
  extended: true
}));
app.use(compression());

// php settings
app.set("views", `${path.resolve(__dirname, '..')}/frontend/views`);
app.engine("php", phpExpress.engine);
app.set("view engine", "php");
app.all(/.+.php$/, phpExpress.router);

// Root route 
app.get("/", (req, res) => {
  if(req.session.isAuthenticated){
    res.redirect("index.php");
  }else{
    res.redirect("login.php");
  }
});

require("./routes/auth.routes.js")(app);


// Listen func
const PORT = 8080;

http.createServer(app).listen(PORT, function(){
    console.log("Server listening on port " + PORT);
});

执行跳转的JS代码 #

$.ajax({
   url: "/auth/register",
   method: "POST",
   processData: false,
   contentType: false,
   data: formData,
   success: function(res){
     if(res.success == 1){
        // window.location.href = window.location.origin+'/register-success.php'
        window.location.href = 'register-success.php'
     }
     else if(res.success === 0){
        $('.error_register').removeClass('d-none')
     }
   }
})

问题排查与解决方法 #

1. 修复相对路径跳转问题 #

当前使用相对路径register-success.php，AJAX请求的页面路径为/auth/register，跳转后实际路径会变成/auth/register-success.php，若该路径无对应PHP文件，会导致Node.js服务处理失败，触发Nginx 502错误。

解决： 改用绝对路径跳转：

window.location.href = '/register-success.php'

2. 补充Nginx代理关键配置 #

当前Nginx代理缺少必要的请求头传递和超时设置，可能导致第一次跳转请求无法被Node.js正确处理。

更新Nginx配置：

server {
    server_name myDomainName;
    
    location / {
        proxy_pass http://127.0.0.1:8080;
        proxy_http_version 1.1;
        # 传递必要请求头，确保Node.js能正确识别请求来源
        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;
        # 延长超时时间，避免PHP进程启动慢导致超时
        proxy_connect_timeout 60s;
        proxy_send_timeout 60s;
        proxy_read_timeout 60s;
    }
}

3. 调整PHP路由匹配规则 #

原正则/.+.php$/存在匹配漏洞，可能无法正确捕获部分路径的PHP请求，导致服务报错。

修改Node.js中的PHP路由：

app.all(/^.*\.php$/, phpExpress.router);

4. 解决PHP进程启动延迟问题 #

第一次请求PHP文件时，php-express需要启动PHP进程，若耗时超过Nginx默认超时时间，会返回502；刷新时进程已启动，因此正常。上述Nginx超时配置可缓解此问题，也可通过预启动PHP进程优化。

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