Node.js后端集成支付网关遇404：表单无法触发/payment端点

1. 检查反向代理配置（核心问题） #

你的Express服务跑在3000端口，但域名直接访问的是80/443端口，必须通过反向代理把/backend路径的请求转发到3000端口的Express服务，否则Web服务器（如Nginx/Apache）会把/backend/payment当成静态页面路径返回404。

Nginx配置示例（修改/etc/nginx/sites-available/你的域名.conf） #

server {
    listen 443 ssl;
    server_name dystryx.online;

    # 静态文件指向public_html目录
    location / {
        root /path/to/your/public_html;
        index index.html;
    }

    # 转发/backend开头的请求到Express服务
    location /backend {
        proxy_pass http://localhost:3000;
        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;
    }
}

修改后重启Nginx：sudo systemctl restart nginx

2. 验证Express路由配置 #

确保路由正确挂载/payment端点，且HTTP方法与表单提交方式一致（表单默认是GET，若用POST必须显式声明）：

routes.js示例 #

const express = require('express');
const router = express.Router();
const paymentController = require('./payment');

// 表单用POST提交时，必须使用router.post
router.post('/payment', paymentController.handlePayment);

module.exports = router;

server.js中挂载路由 #

const express = require('express');
const app = express();
const routes = require('./routes');

// 解析表单数据（必须添加，否则无法获取POST参数）
app.use(express.urlencoded({ extended: true }));
app.use(express.json());

// 挂载带/backend前缀的路由
app.use('/backend', routes);

app.listen(3000, () => {
    console.log('Server running on port 3000');
});

3. 检查表单action配置 #

确保表单的method与后端路由方法匹配，action路径使用相对路径避免解析错误：

<form action="/backend/payment" method="POST">
    <!-- 表单字段 -->
    <button type="submit">支付</button>
</form>

4. 排除静态文件冲突 #

如果server.js中配置了静态文件服务，需将自定义路由挂载在静态资源配置之前，避免静态资源路由优先级覆盖自定义路由：

// 先挂载自定义路由
app.use('/backend', routes);
// 再配置静态文件目录
app.use(express.static('public_html'));

5. 测试端点可用性 #

通过SSH在服务器上用curl直接测试Express端点：

curl -X POST http://localhost:3000/backend/payment -d "amount=100"

若返回正常，说明Express服务无问题，问题出在反向代理或前端路径；若返回404，说明路由配置有误。

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