404错误表示请求已抵达服务器但资源路径未找到,排查需同步分析浏览器实际请求URL与服务器资源匹配逻辑;关键步骤是通过F12 Network面板确认Request URL、Status Code和Content-Type,并重点检查相对路径计算、大小写敏感、History模式fallback配置及前后端路由冲突。

404 错误不是网络不通,而是请求已抵达服务器、但服务器明确告诉你“这个路径我找不到对应资源”——排查必须从“路径怎么算出来的”和“服务器怎么找的”两头同时下手。
浏览器 Network 面板里看清楚到底在请求什么
这是最直接、最不可跳过的一步。按下 F12 → 切到 Network 标签页 → 刷新页面或触发跳转 → 找到状态码为 404 的那条请求,点开它看三个关键字段:
-
Request URL:浏览器实际发出的完整地址,不是你写的相对路径,而是拼接后的结果 -
Status Code:确认是404 Not Found(不是403或502) -
Response Headers中的Content-Type:如果是application/json,说明后端 API 拦截了,不是前端路由问题
常见陷阱:当前页面是 https://example.com/admin/,你写 location.href = "user",Network 里看到的却是 https://example.com/admin/user —— 这就是相对路径计算导致的错位。
静态资源路径是否被大小写或扩展名坑了
Windows 开发时一切正常,一上 Linux 服务器就 404,大概率是大小写不一致。比如 HTML 里写 ,但文件实际叫 
img/logo.png。
- 检查文件系统中真实文件名,包括大小写、空格、隐藏扩展名(如
index.html.txt) - 在 Windows 上打开“文件夹选项” → 勾选“显示文件扩展名”,避免误判
- 用
curl -I http://localhost/path/to/file直接测服务器响应,绕过浏览器缓存干扰
特别注意:file:/// 协议下路径解析规则和 http:// 完全不同,本地双击 HTML 能打开 ≠ 部署后能访问。
HTML5 History 模式没配 fallback 就刷新必 404
Vue Router、React Router 等启用 history 模式后,URL 看似干净(如 /about),但刷新时浏览器会直接向服务器请求该路径。如果 Nginx/Apache 没做 fallback,就会返回 404 —— 因为服务器根本没有 /about 这个物理文件。
- Nginx 配置需加:
try_files $uri $uri/ /index.html;(放在location /块内) - Apache 需启用
mod_rewrite,并在.htaccess中添加重写规则 - 静态托管平台(Vercel/Netlify)通常默认支持,但自建服务几乎一定需要手动补
漏掉这步,开发时一切正常,上线后只要刷新页面就 404,非常典型且容易忽略。
后端路由或安全配置意外拦截了前端路径
前后端同域部署(如都走 https://api.example.com)时,/order/list 这种路径可能被后端框架(Spring Boot、Express)提前匹配并返回 JSON 或空响应,导致前端路由根本没机会执行。
- 看 Network 中 404 请求的
Response Headers:若Content-Type: application/json,说明后端处理了 - 检查后端日志,确认该路径是否有 handler;或者临时把后端路由前缀统一改成
/api/xxx - Spring Boot 项目若用了 Spring Security,要确保
/doc.html、/swagger-ui.html等前端资源路径未被拦截
这类问题表面是 404,实则是前后端路由冲突或权限策略覆盖,不能只盯着前端代码改。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











