macOS系统brew安装的Nginx反向代理不生效返回404如何解决？

问题解决步骤 #

1. 先重载Nginx配置 #

修改配置后必须重载才能生效，先执行命令验证配置语法是否合法：
nginx -t
如果返回syntax is ok、test is successful，再执行重载命令：
nginx -s reload
如果重载失败，直接重启Nginx服务：
brew services restart nginx

2. 调整反向代理配置 #

你遇到的404问题核心是proxy_pass的路径匹配规则，Nginx对proxy_pass末尾是否带斜杠有严格的逻辑区分，按你的需求调整配置如下：

location /p1/ {
   # 末尾加斜杠：访问 localhost:8080/p1/xxx 会代理到 http://127.0.0.1:5000/api/product/xxx
   proxy_pass http://127.0.0.1:5000/api/product/;
   # 增加标准代理头，避免后端服务识别异常
   proxy_set_header Host $host;
   proxy_set_header X-Real-IP $remote_addr;
   proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
}

location /p2/ {
   # 末尾加斜杠：访问 localhost:8080/p2/xxx 会代理到 http://www.google.com/xxx
   proxy_pass http://www.google.com/;
   proxy_set_header Host www.google.com;
   proxy_set_header X-Real-IP $remote_addr;
   proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
}

如果你不需要去掉/p1/前缀直接拼接路径，再把proxy_pass的末尾斜杠去掉即可。

3. 辅助排查项 #

• 确认Nginx配置的server块listen端口和你访问的端口一致，默认brew安装的Nginx监听端口为8080，如果配置被修改为其他端口要对应调整访问地址。
• 确认/usr/local/var/log/nginx/、/usr/local/var/run/nginx/目录权限归属mobi用户，避免权限不足导致转发失败。
• 如果仍然报错，查看错误日志/usr/local/var/log/nginx/error.log获取具体错误信息。

内容的提问来源于stack exchange，提问作者Mubashir 'Mobi' Ayub