前端路由缺失导致404的本质是Nginx未将非根路径请求兜底至index.html，而是直接查找不存在的物理文件；需通过error_log中“open() failed”报错、access_log中无后缀404请求及curl验证确认，并在location /中配置try_files $uri $uri/ /index.html解决。
前端路由缺失导致的 404 飙升，本质不是接口或后端出错，而是用户访问了某个前端路径（比如 /login、/user/123），但 Nginx 没把请求兜底到 index.html，反而去文件系统里找真实存在的 /login 文件——当然找不到，于是返回 404。这类 404 在日志里集中出现在非根路径、无后缀、非静态资源的请求上，且状态码是 Nginx 原生返回（不是后端吐的），排查要从“请求是否进错了地方”开始。
看 Nginx error_log 和 access_log 定位真实来源
打开 Nginx 错误日志（如 /var/log/nginx/error.log），搜索 "open() ... failed (2: No such file or directory)"，这类报错说明 Nginx 尝试读取一个物理路径但失败了，正是 history 路由未兜底的典型痕迹。
同时查 access_log，过滤出大量 404 请求，重点关注：
- 请求 URI 是否集中在
/xxx（无扩展名）、/xxx/或带参数的路径（如/dashboard?tab=2） - 响应体是否为 Nginx 默认 404 页面（含
nginx字样或标准 HTML 结构） - 这些请求的
Referer是不是来自你自己的域名（说明是 SPA 内部跳转后刷新触发）
验证是否为前端路由兜底缺失
用 curl 直接模拟刷新行为：
立即学习“前端免费学习笔记（深入）”；
-
curl -I https://yoursite.com/login→ 若返回404 Not Found且Content-Type: text/html，基本确认是 Nginx 层问题 -
curl -I https://yoursite.com/→ 应返回200 OK，说明首页能正常加载 -
curl -I https://yoursite.com/index.html→ 也应返回200，证明静态文件本身存在
如果前两者结果不一致，就不是代码或网络问题，而是 Nginx 没把所有非静态路径都 fallback 到 index.html。
检查 Nginx location 配置是否启用 try_files
核心配置必须包含这行：
location / { try_files $uri $uri/ /index.html; }
常见错误配置包括：
- 只写了
index index.html;，没配try_files—— 这对/login这类路径完全无效 - 把
try_files写在子 path 下（如location ^~ /api/），而主 location 缺失兜底 - root 路径写错，或用了
alias却没注意末尾斜杠规则，导致/index.html实际找不到
排除静态资源干扰，确认 404 真实归属
前端路由缺失引发的 404，通常不发生在 js/css/img 等资源上。可在 access_log 中加条件过滤：
- 排除常见静态后缀：
grep -v "\.\(js\|css\|png\|jpg\|gif\|ico\|woff\|ttf\)$" access.log | grep " 404 " - 若剩下大量
/xxx类路径，且 user-agent 是浏览器，基本锁定为 SPA 路由问题 - 如果 404 同时出现在
/static/js/app.js上，则是部署路径或 root 配置错误，和路由兜底无关
不复杂但容易忽略
