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