错误类型

常见场景

核心原因

实操解决方式（补充完善）

404 Not Found（客户端错误）

1. 浏览器访问页面时，地址栏报404

页面路径错误（如拼写错误、路径层级错误）；页面文件被删除、移动，未更新访问路径；路由配置错误（前端Vue/React路由、后端路由）

1. 路径排查：检查地址栏路径，逐字符核对拼写（区分大小写，如/api/user和/api/User在Linux服务器中会被识别为不同路径），确认路径层级无误（如多写/或少写/）；

2. 文件核对：找到对应页面文件，确认未被删除、移动，若位置变更，同步更新所有关联的访问路径（如前端跳转链接、后端路由配置）；

3. 路由检查：前端（Vue/React）核对路由配置文件，确认路由路径与访问路径一致，未遗漏路由注册；后端核对接口路由（如Spring Boot的@RequestMapping、Node.js的router.get），确保路径配置正确；

4. 静态资源校验：若为静态页面报错，检查页面内引用的CSS、JS、图片路径，确保与文件实际位置匹配。

2. 前端请求接口时，控制台报404

接口地址（URL）错误；接口未部署或已删除；前后端接口路径不一致（如前端写/api/login，后端实际是/api/user/login）；跨域配置中未允许该接口路径

1. 接口测试：复制控制台报错的请求URL，直接粘贴到浏览器地址栏访问，查看是否返回正常响应，排除前端请求方式（GET/POST）错误；

2. 接口核对：对照前后端接口文档，逐段核对接口路径、请求参数、请求方式，确保完全一致，避免前端拼接路径时出现多余字符（如多拼接/、参数缺失）；

3. 后端校验：检查后端服务是否正常启动，接口是否被删除、注释，若为微服务项目，确认对应服务已注册到注册中心；

4. 跨域处理：后端检查CORS配置，确保允许前端请求的域名、路径，若使用Nginx代理，确认代理配置中接口路径转发正确。

3. 静态资源（图片、CSS、JS）加载失败，控制台报404

资源路径错误（相对路径/绝对路径使用不当）；资源文件缺失、命名错误（区分大小写）；服务器未配置静态资源访问权限

1. 路径修正：相对路径（如../img/xxx.png）核对层级，确保从当前页面到资源文件的层级正确；绝对路径确认域名、端口无误，避免跨域引用未授权的资源；

2. 资源检查：确认资源文件已上传至对应目录，文件名拼写、后缀完全正确（如xxx.jpg与xxx.png不可混淆），避免文件名包含特殊字符；

3. 后端配置：Spring Boot项目确保资源放在static目录下，或通过@ResourceHandler配置静态资源映射；Node.js项目通过express.static配置静态资源目录；

4. 服务器配置：Nginx/Apache配置静态资源访问路径，如Nginx中添加location /static { root /usr/local/project; }，确保服务器有权限读取静态资源文件。

4. 部署后访问项目报404

服务器配置错误（如Nginx未配置项目根路径）；项目部署路径错误；域名解析错误，指向的服务器未部署该项目

1. 服务器配置：检查Nginx/Apache配置文件，确认root指令指向项目打包后的dist（前端）或target（后端）目录，index指令设置为项目入口文件（如index.html、index.jsp）；

2. 部署路径：登录服务器，核对项目部署路径，确保打包文件完整上传，无缺失（如前端dist目录、后端jar包）；

3. 域名与端口：检查域名解析记录，确认域名指向的服务器IP正确；服务器开放对应端口（如80、443、8080），关闭防火墙或添加端口放行规则；

4. 重启服务：修改配置后，重启Nginx/Apache和项目服务，确保配置生效。

5. 刷新SPA（单页应用）报404

SPA路由为前端路由（如Vue/React Router的history模式），服务器未配置 fallback 路由，刷新时服务器无法识别前端路由路径

1. 前端方案：将Vue/React Router路由模式改为hash模式（URL带#），无需修改服务器配置，简单快捷，但URL会包含#符号；

2. 服务器方案（推荐）：Nginx配置fallback路由，在server块中添加try_files $uri $uri/ /index.html;，让所有未匹配的路径都指向index.html；

3. 后端方案：Spring Boot项目通过配置WebMvcConfigurer，添加forward:/index.html，将所有前端路由请求转发到入口文件；

4. 验证：配置完成后，重启服务，刷新页面，确认无404报错。

500 Internal Server Error（服务器错误）

1. 前端请求接口时，控制台报500

后端代码报错（如空指针异常、数组越界、语法错误）；后端接口逻辑错误；数据库连接失败、SQL语句错误；后端依赖缺失、配置错误

1. 日志排查（核心）：查看后端日志（Java：Tomcat的logs/catalina.out、Spring Boot的控制台日志；Node.js：控制台输出、PM2日志），定位报错代码行和具体异常信息；

2. 代码修复：根据日志提示，排查异常原因（如空指针：添加非空判断；数组越界：检查数组长度；语法错误：修正代码语法）；

3. 数据库检查：核对数据库连接配置（application.yml、config.js），确认地址、用户名、密码正确，测试数据库能否正常连接；检查SQL语句，避免语法错误、字段名错误、表名错误；

4. 依赖与配置：确认后端依赖已完整安装（Maven：pom.xml依赖齐全，执行mvn clean install；Node.js：npm install安装所有依赖）；检查配置文件无语法错误（如yml文件缩进错误）。

2. 项目启动后，访问接口直接报500

服务器环境异常（如JDK版本不匹配、Node.js版本过低）；后端服务未正常启动；端口被占用，导致服务启动失败但未提示；服务器内存不足，无法处理请求

1. 环境校验：检查服务器JDK/Node.js版本，确保与项目要求一致（如Spring Boot 3.x需JDK 17+，Vue 3需Node.js 14+），版本不匹配则升级或降级环境；

2. 服务检查：查看后端服务启动日志，确认服务已正常启动，无端口占用、依赖缺失等报错；若服务未启动，手动启动并排查启动失败原因；

3. 端口处理：Windows用netstat -ano | findstr 端口号，Linux用netstat -tuln | grep 端口号，查看端口占用情况，杀死占用进程或修改项目端口；

4. 内存优化：检查服务器内存使用情况（Windows：任务管理器；Linux：top命令），关闭无用进程释放内存，若内存不足，可增加服务器内存或优化项目内存配置（如JVM参数）。

3. 部分请求正常，部分请求报500

请求参数异常（如参数类型不匹配、参数缺失，导致后端处理报错）；后端接口未处理异常场景（如传入非法参数、数据库查询无结果时未返回正确响应）；服务器负载过高，部分请求处理超时

1. 参数校验：前端检查请求参数，确保参数类型、格式、必填项与后端接口要求一致（如后端要求int类型，前端不可传字符串），避免传入null、空字符串等非法参数；

2. 异常处理：后端完善接口异常捕获，用try-catch捕获所有可能出现的异常，返回统一的错误响应（如状态码、错误信息），避免未处理的异常导致服务崩溃；

3. 性能优化：优化接口处理逻辑，减少冗余代码；优化数据库SQL查询，添加索引，避免全表扫描；若服务器负载过高，可扩容服务器或开启缓存（如Redis）；

4. 超时设置：调整后端接口超时时间（如Spring Boot的server.timeout、Node.js的axios超时设置），避免请求因处理时间过长报错。

4. 部署后报500，本地运行正常

部署环境与本地环境不一致（如数据库地址、配置文件不同）；部署包缺失文件（如依赖包、配置文件）；服务器权限不足，无法读取项目文件、连接数据库

1. 环境对比：逐一对比本地与部署环境的配置（数据库地址、端口、环境变量、依赖版本），确保部署环境配置与项目要求一致，避免直接复用本地配置；

2. 部署包检查：解压部署包，确认所有依赖文件、配置文件、静态资源完整，无缺失、损坏（如后端jar包完整、前端dist目录文件齐全）；

3. 权限设置：给服务器项目目录、数据库连接赋予足够权限（Linux：chmod -R 755 项目目录；数据库：给连接用户分配查询、新增、修改权限）；

4. 日志定位：查看服务器部署日志和项目运行日志，找到具体报错信息，针对性解决（如配置错误则修改配置，权限不足则调整权限）。

5. 服务器重启后，访问报500

服务器重启后，后端服务未自动启动；数据库未启动，导致后端无法连接；服务器配置文件（如Nginx、Tomcat）重启后失效

1. 服务启动：手动启动后端服务，测试接口是否正常；设置服务自动启动（Linux：systemctl enable 服务名；Windows：将服务设置为自动启动）；

2. 数据库检查：启动数据库服务，确认数据库正常运行，能正常连接，若数据库启动失败，排查数据库配置、日志；

3. 配置校验：检查Nginx、Tomcat等服务器配置文件，确认配置未丢失、无语法错误，重启对应服务（Nginx：nginx -s reload；Tomcat：sh startup.sh）；

4. 验证：重启所有相关服务后，访问项目和接口，确认500错误已解决。