前端请求后端返回 404/405/500 状态码：完整排查与解决指南
前端请求后端接口返回 404 / 405 / 500 是开发中最常见的三大'拦路虎'。以下是实战中最完整的排查与解决指南，按状态码分类，结合真实项目经验（axios/fetch + Spring/Node.js/Go 等常见后端）整理成分层排查流程。
通用排查前置步骤（适用于所有状态码）
- 浏览器 Network 面板第一眼看什么
- 请求完整的 URL（含域名、路径、query params）
- 请求方法（GET/POST/PUT/DELETE/…）
- 请求头（尤其是 Content-Type、Authorization、Origin）
- 请求体（Payload / Form Data）是否正确序列化
- 响应头中是否有
X-Error-Code、X-Message等自定义错误信息
- 确认环境
- 本地开发？测试环境？生产环境？
- 走不走网关/代理/Nginx？
- 是否有 CDN、WAF、API 网关拦截？
- 复制 cURL 命令重放
在 Network 面板右键请求 → Copy as cURL → 在终端/ Postman 执行，排除前端库（axios/fetch）问题。
现在进入具体状态码排查。
1. 404 Not Found（资源未找到）—— 最常见，责任通常在前/后端路径不匹配
常见原因排序（概率从高到低）
| 概率 | 原因 | 典型表现 | 排查/解决步骤 |
|---|---|---|---|
| ★★★★★ | URL 路径写错 / 多/少字符 | /api/user → /api/users 或 /v1/ 漏写 | 1. 复制后端 Swagger/Postman 文档中的准确路径 2. 检查大小写（Node.js/Linux 敏感） 3. 确认 baseURL 是否正确（axios.defaults.baseURL） |
| ★★★★ | 后端服务未重启 / 路由未注册 | 新增接口上线后立即 404 | 后端：重启服务 / 检查 @RequestMapping / router.get 是否加载 |
| ★★★ | Nginx/网关 location 配置错误 | 所有接口 404，但 Postman 直连后端成功 | 检查 upstream 是否指向正确端口，proxy_pass 是否带 / |
| ★★★ | 代理/网关路径重写丢失 | /api/* → / 丢失 api 前缀 | Nginx: proxy_pass http://backend/; → proxy_pass http://backend; （注意斜杠） |
| ★★ | 微服务 / 网关路由未配置 | gateway + nacos/eureka 路由表没同步 | 检查服务发现、路由断言（path=/user/** → stripPrefix=0/1） |
| ★ | 接口版本前缀不匹配 | /v1/users 但前端请求 /v2/users | 统一版本约定或前端动态读取版本 |
快速自查清单（5 分钟内完成）
