单页应用部署到Nginx后刷新404等问题源于rewrite与try_files职责混淆；应严格分离：rewrite仅做路径标准化，try_files仅负责资源判别与fallback，二者不得共存于同一location块，API须独立location代理，静态资源需精准匹配直通。
单页应用（SPA）部署到 Nginx 后，刷新页面报 404 是典型问题；但更棘手的是：改了 try_files 却触发 403、静态资源加载失败、API 请求被错误重写——这说明 rewrite 和 try_files 没协同好，形成了“路由死锁”。关键不是单独用哪个指令，而是让它们各司其职、不越界。
明确分工：rewrite 负责路径预处理，try_files 负责兜底返回
很多配置把两者混用，比如在 location / 里既写 rewrite 又写 try_files，容易引发循环或权限校验失败。正确逻辑是：
-
rewrite 只做路径标准化：把带前缀的请求（如
/app/user）剥离前缀，转成前端能识别的干净路径（/user），不涉及文件查找 -
try_files 只做资源判别：检查真实文件（js/css/img）、目录、最后才 fallback 到
/index.html，不参与路径改写 - 二者不能出现在同一个 location 块中做主逻辑，否则 Nginx 可能因重写后路径未重匹配而拒绝访问，导致 403
子路径部署必须分层配置，避免 rewrite 泄露到静态资源
应用部署在 /admin/ 下时，常见错误是用一个 location /admin/ 包揽所有，结果 js 文件请求 /admin/static/app.js 被 rewrite 成 /static/app.js，而该路径又没配静态服务，直接 404 或 403。
正确做法是拆开处理：
- 用独立
location ^~ /admin/做路径剥离：
rewrite ^/admin/(.*)$ /$1 break; - 用精准匹配
location ~* \.(js|css|png|woff2)$直接服务静态文件，跳过 rewrite 和 try_files - 主路由用
location /（注意：不是/admin/）配try_files $uri $uri/ /admin/index.html，确保 fallback 正确指向子路径下的入口文件
API 与前端路由必须物理隔离，防止 proxy_pass 干扰 try_files
如果把 proxy_pass 写在和 try_files 同一个 location 里，Nginx 会尝试先找文件再代理，或代理时误把路由当接口调用，轻则 404，重则 403（后端拒绝非法 Host 或路径）。
- API 必须用独立 location 块，路径有明确前缀（如
/api/、/v1/） - 该 location 内禁用
try_files，只保留proxy_pass和必要 header 设置 - 避免使用模糊匹配如
location /+proxy_pass，这是 403 高发区
终极精简配置模板（含 HTTPS 和子路径）
以下配置已验证可同时解决 404、403、静态资源 403、API 502 等连环问题：
server {
listen 443 ssl;
server_name app.example.com;
root /var/www/my-spa;
<h1>静态资源直通（跳过所有 rewrite/try_files）</h1><p>location ~* .(js|css|png|jpg|gif|ico|woff2|svg)$ {
expires 1y;
add_header Cache-Control "public, immutable";
}</p><h1>API 接口代理（严格路径前缀）</h1><p>location /api/ {
proxy_pass <a href="https://www.php.cn/link/d55f42621864ab6071c77e68f1e70053">https://www.php.cn/link/d55f42621864ab6071c77e68f1e70053</a>;
proxy_set_header Host backend-api.example.com;
proxy_set_header X-Real-IP $remote_addr;
}</p><h1>主路由：兜底到 index.html，不干扰任何其他规则</h1><p>location / {
try_files $uri $uri/ /index.html;
}
}若部署在子路径（如 https://example.com/myapp/），只需两处改动：
① 把 root 改为 root /var/www/myapp;；
② 把主 location 的 try_files 改为 try_files $uri $uri/ /myapp/index.html;。
无需 rewrite，不引入额外变量，不触发重定向循环。
