如何正确配置Nginx proxy_pass带参数的Express路由？

核心问题分析 #

你的场景里，前端发起DELETE /api/delete/file/[folder名]请求，后端Express路由为/api/delete/file/:folder，出现404/405基本都是Nginx代理的路径转发或请求方法传递环节出了问题。

正确的Nginx配置示例 #

假设你的Express服务运行在localhost:3000，Nginx的server块配置应如下：

server {
    listen 80;
    server_name 你的域名;

    location /api/ {
        # 关键：proxy_pass末尾不要加斜杠，否则会截断/api/前缀
        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拦截DELETE
        proxy_method $request_method;
    }
}

常见错误排查 #

1. 404错误的主要原因

   • 若给proxy_pass加了末尾斜杠（比如http://localhost:3000/），Nginx会把/api/delete/file/xxx转发成/delete/file/xxx，后端/api/delete/file/:folder路由自然匹配不上，直接返回404。
   • 可查看Nginx访问日志，确认转发到后端的请求路径是否与Express路由一致。

2. 405错误的主要原因

   • 确认Express路由是用app.delete('/api/delete/file/:folder', ...)定义的，别误写成app.get或其他方法。
   • 部分场景下Nginx会默认拦截非GET/POST的方法，添加proxy_method $request_method可强制传递请求方法。

验证方法 #

配置完成后重启Nginx（执行nginx -s reload），用curl测试：

curl -X DELETE http://你的域名/api/delete/file/test-folder

若返回正常，则说明配置生效。

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