Nginx需正确区分Vue静态资源与PHP接口路由：一、配置root和try_files支持SPA；二、用proxy_pass代理/api/至PHP后端；三、通过rewrite或try_files处理.php扩展名；四、禁用dist目录下PHP执行；五、调大超时与缓冲区参数防502/504。
如果您已完成Vue项目的打包并拥有运行中的PHP后端接口，但在访问时出现静态资源加载失败或API请求返回404、502等错误，则很可能是Nginx未正确区分前端静态资源与PHP后端接口的路由处理。以下是解决此问题的步骤：
一、配置Nginx服务根目录并启用SPA路由支持
该步骤确保Vue构建的单页应用（SPA）在刷新或直接访问嵌套路由（如/user/profile）时不会返回404，而是由前端路由接管。Nginx需将所有非静态资源请求回退至index.html。
1、打开Nginx主配置文件或站点配置文件（例如/etc/nginx/conf.d/vue-php.conf）。
2、在server块中设置root指向Vue打包后的dist目录绝对路径，例如/var/www/my-vue-app/dist。
立即学习“PHP免费学习笔记（深入）”；
3、添加location /块，并在其中配置try_files $uri $uri/ /index.html;指令。
4、确认index指令包含index.html，例如index index.html;。
二、代理PHP API接口请求至后端服务
该步骤将匹配特定前缀（如/api/）的HTTP请求，通过反向代理转发给本地或远程PHP服务（如Apache、PHP-FPM监听端口），避免浏览器跨域限制，同时隐藏后端真实地址。
1、在同一个server块内新增location /api/配置段。
2、设置proxy_pass为目标PHP服务地址，例如http://127.0.0.1:8000/（注意末尾斜杠必须保留，否则会导致路径拼接错误）。
3、添加必要代理头：包括proxy_set_header Host $host、proxy_set_header X-Real-IP $remote_addr、proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for。
4、若PHP服务部署在Apache上且监听localhost:8080，则proxy_pass应写为http://localhost:8080/api/，同时确保后端能正确解析PATH_INFO。
三、处理PHP接口路径重写与大小写敏感问题
当PHP后端使用.php扩展名（如/api/login.php）但前端调用路径不含扩展名（如/api/login）时，需在Nginx中自动补全或重写路径，否则将返回404。
1、在location /api/块内部添加rewrite ^/api/(.*)$ /api/$1.php break;（适用于所有API均为.php文件的场景）。
2、若部分接口为.php、部分为伪静态路由，改用try_files方式：try_files $uri $uri.php $uri/index.php =404;。
3、为兼容前端可能发送的大写路径（如/API/login），在location中使用正则匹配：location ~* ^/api/，并配合proxy_pass http://127.0.0.1:8000/;（不带路径后缀）。
四、禁用PHP脚本在前端资源目录中的执行权限
该步骤防止攻击者上传恶意.php文件到Vue的dist目录并直接执行，是关键安全加固措施。Nginx需明确拒绝在静态资源路径下解析PHP。
1、在location /块内添加嵌套的location ~ \.php$配置。
2、在该嵌套块中设置return 403;或deny all;。
3、确保该配置位于location /api/之前，避免被覆盖。
4、务必验证：访问 http://your-domain.com/dist/test.php 应返回 403 Forbidden，而非执行PHP代码。
五、调整Nginx超时与缓冲区参数以适配PHP响应特性
PHP脚本（尤其含文件上传、数据库慢查询或Excel导出）可能执行时间较长或返回较大响应体，若Nginx默认超时值过小，将触发504 Gateway Timeout；缓冲区不足则导致502 Bad Gateway。
1、在location /api/块内设置proxy_connect_timeout 300;、proxy_send_timeout 300;、proxy_read_timeout 300;（单位：秒）。
2、增加缓冲区配置：proxy_buffer_size 128k;、proxy_buffers 4 256k;、proxy_busy_buffers_size 256k;。
3、若PHP接口返回JSON数据量大且含中文，添加proxy_set_header Accept-Encoding "";禁用压缩，避免解码异常。
4、关键提示：修改后必须执行 nginx -t 验证语法，再运行 nginx -s reload 重载配置，不可仅重启服务。
