本文由 简悦 SimpRead 转码， 原文地址 blog.csdn.net
Spring Boot 常见的报错以及解决
1. 端口被占用
一、具体情况
当尝试启动 Spring Boot 应用程序时，如果配置的端口已被其他应用程序占用，那么应用程序将无法在该端口上启动，并会抛出相应的错误。这通常是由于以下原因造成的：
端口冲突：当多个应用程序尝试监听相同的端口时，会发生端口冲突。
遗留进程：有时，即使应用程序已经关闭，它可能仍在后台运行，并占用着端口。
二、解决措施
针对 Spring Boot 端口被占用的问题，可以采取以下解决措施：
检查端口占用情况
使用系统命令（如 netstat）或网络监测工具来检查端口的占用情况。
在 Windows 系统中，可以使用命令 netstat -ano | findstr :<port_number>（将 < port_number > 替换为要检查的端口号）来查看占用该端口的进程的 PID。
停止占用端口的进程
如果发现端口已被占用，可以通过任务管理器（Windows）或类似的进程管理工具来结束占用端口的进程。
在 Windows 系统中，可以通过 Ctrl+Shift+Esc 打开任务管理器，在 “进程” 选项卡中找到占用端口的进程，并右键单击选择“结束任务”。
修改应用程序端口
如果无法结束占用端口的进程，或者不想结束该进程，那么可以修改 Spring Boot 应用程序的端口配置。
在 application.properties 或 application.yml 文件中，修改 server.port 属性，将其更改为一个未被占用的端口。
重启应用程序
在修改端口配置后，需要重启 Spring Boot 应用程序以使新的端口配置生效。
特殊情况处理
如果在更换端口后仍然遇到端口被占用的问题，可能是由于电脑后台运行的应用过多，或者某个项目添加了另一个项目的依赖导致端口冲突。
在这种情况下，可以尝试重启计算机，或者检查项目依赖关系，并删除不必要的依赖。
三、总结
当遇到 Spring Boot 端口被占用的问题时，首先需要确定端口是否已被其他应用程序占用，然后尝试停止占用端口的进程或修改应用程序的端口配置。如果以上方法均无法解决问题，可以尝试重启计算机或检查项目依赖关系。在处理过程中，应注意保留重要的工作成果，并遵循良好的开发习惯。
2. 404 状态码
一、404 错误的具体情况
在 Spring Boot 应用中，当请求的资源未找到时，通常会返回 HTTP 404 状态码。这可能是由于以下原因造成的：
URL 路径错误：请求的 URL 路径不正确，与 Controller 中定义的路径不匹配。
例如，请求的 URL 是 / usr/list，但 Controller 中定义的路径是 / user。
HTTP 方法不匹配：前端请求的 HTTP 方法与后端 Controller 中定义的方法不匹配。
例如，前端使用 GET 方法请求，但后端 Controller 中定义的是 POST 方法。
Controller 配置问题：
Controller 和 RestController 混用：在同一个类中同时使用了 @Controller 和 @RestController 注解，这可能导致路由冲突。
Controller 不在正确的包路径下：Spring Boot 默认扫描启动类所在包及其子包下的 Controller，如果 Controller 不在这些包下，则无法被扫描到。
静态资源未配置：如果请求的是静态资源（如 HTML、CSS、JS 等），但项目中未正确配置静态资源的位置，也会导致 404 错误。
二、解决措施
针对以上情况，可以采取以下解决措施：
检查 URL 路径：
确保请求的 URL 路径与 Controller 中定义的路径完全一致。
注意 URL 中的大小写、特殊字符和路径参数等。
检查 HTTP 方法：
确保前端请求的 HTTP 方法与后端 Controller 中定义的方法一致。
如果需要支持多种 HTTP 方法，可以在 Controller 方法上使用 @GetMapping、@PostMapping 等注解来明确指定。
检查 Controller 配置：
确保 Controller 类上只使用了 @Controller 或 @RestController 注解中的一个。
如果使用 @Controller 注解，需要配合 @ResponseBody 注解来返回数据；如果使用 @RestController 注解，则无需额外配置。
确保 Controller 类位于 Spring Boot 启动类所在包或其子包下，以便被 Spring Boot 自动扫描到。
配置静态资源：
在 application.properties 或 application.yml 文件中配置静态资源的路径。
默认情况下，Spring Boot 会将 / static、/public、/resources 和 / META-INF/resources 目录下的文件作为静态资源。
查看日志和错误信息：
仔细查看 Spring Boot 的启动日志和错误信息，这可能会提供关于 404 错误的更多线索。
可以使用 --debug 或 --trace 标志来启动 Spring Boot 应用，以获取更详细的日志信息。
使用开发工具：
使用 IDE（如 IntelliJ IDEA、Eclipse 等）中的调试功能来逐步跟踪请求的处理过程，查找问题所在。
使用 Postman、curl 等 HTTP 客户端工具来发送请求并检查响应结果。
检查服务器配置：
如果将 Spring Boot 应用部署到外部服务器上（如 Tomcat、Jetty 等），请确保服务器配置正确，并且应用已正确部署到服务器上。
检查服务器的端口和上下文路径是否与请求中使用的 URL 匹配。
3. 500 状态码
一、HTTP 500 状态码代表服务器内部错误，这通常意味着服务器遇到了一个意外的情况，导致它无法完成对请求的处理。在 Spring Boot 应用中，500 状态码可能由多种原因引起，包括但不限于：
业务代码错误：在 Controller 中执行某个方法时，由于业务逻辑错误或代码异常，导致服务器无法继续处理请求。
数据库问题：数据库连接失败、SQL 语句错误、数据库服务未启动等数据库相关问题都可能导致 500 错误。
系统资源不足：服务器硬件资源（如 CPU、内存）不足，或者数据库连接池、线程池等配置不合理，导致服务器无法处理更多的请求。
依赖问题：项目依赖的外部服务、中间件或第三方库出现问题，如 Redis、Kafka 等依赖的服务不可用，或者依赖的 jar 包版本冲突等。
二、解决措施
针对 Spring Boot 500 状态码，可以采取以下解决措施：
查看日志和错误信息：
首先，需要仔细查看 Spring Boot 应用的日志输出，通常可以在启动日志、控制台输出或专门的日志文件中找到具体的错误信息。
关注 Caused by 后面的报错信息描述，这通常会给出导致 500 错误的具体原因。
检查业务代码：
根据日志中的错误信息，定位到出错的业务代码位置，检查是否存在逻辑错误、空指针异常、数组越界等常见问题。
对于复杂的业务逻辑，可以进行单元测试或集成测试，以确保代码的正确性。
检查数据库连接：
确认数据库服务是否已启动并正常运行。
检查数据库连接池的配置是否正确，如最大连接数、空闲时间等。
检查 SQL 语句是否书写正确，可以使用数据库管理工具执行 SQL 语句以验证其正确性。
增加系统资源：
如果服务器硬件资源不足，可以考虑升级服务器硬件、增加 CPU 核心数、扩大内存容量等方式来提高系统资源。
根据业务并发量，合理设置数据库连接池、线程池等配置参数。
检查依赖服务：
确保项目依赖的外部服务、中间件或第三方库都已正确安装并运行。
检查项目中的依赖配置是否正确，如版本号、配置参数等。
使用自定义错误处理：
可以按照 BasicErrorController 类写一个类似的 ServerErrorController，用于处理 500 错误并返回更友好的错误信息给客户端。
在自定义的错误处理类中，可以记录详细的错误信息并发送到日志系统或监控平台，以便后续分析和处理。
优化代码和配置：
对代码进行优化，减少不必要的计算和内存占用。
合理配置应用参数和 JVM 参数，以提高应用的性能和稳定性。
通过以上措施，可以逐步排查并解决 Spring Boot 应用中出现的 500 状态码问题。
4. 数据库连接异常
一. 数据库连接异常常见情况
1.1 配置错误
数据库 URL、用户名、密码、驱动等配置信息在 application.properties 或 application.yml 文件中设置错误。
配置文件中的数据库名称与实际的数据库名称不一致。
1.2 数据库服务未启动
数据库服务没有启动或无法访问。
1.3 网络问题
数据库服务器地址错误或无法访问。
防火墙或安全组设置阻止了数据库端口的访问。
1.4 数据库版本或驱动不兼容
使用的数据库驱动与数据库版本不兼容。
1.5 数据库用户权限不足
数据库用户没有足够的权限来连接或执行操作。
二. 解决措施
2.1 检查配置文件
确保 application.properties 或 application.yml 文件中的数据库连接信息（如 URL、用户名、密码、驱动等）配置正确。
核对数据库名称是否与配置文件中设置的一致。
2.2 检查数据库服务
确保数据库服务已经启动并且处于运行状态。
使用数据库管理工具（如 MySQL Workbench、Navicat 等）尝试连接数据库，确认服务是否可访问。
2.3 检查网络设置
确认数据库服务器地址是否正确，并且可以被应用服务器访问。
检查防火墙或安全组设置，确保没有阻止数据库端口的访问。
2.4 检查数据库版本和驱动
确认使用的数据库驱动与数据库版本兼容。
如果需要，更新数据库驱动到与数据库版本兼容的版本。
2.5 检查数据库用户权限
确保用于连接数据库的用户具有足够的权限，包括连接和执行操作的权限。
如果需要，修改数据库用户的权限设置。
2.6 使用全局异常处理
在 Spring Boot 应用中，可以使用 @ControllerAdvice 和 @ExceptionHandler 注解来全局处理异常，包括数据库连接异常。
在异常处理方法中，可以记录详细的错误信息并返回友好的提示给客户端。
2.7 查看日志
仔细查看 Spring Boot 应用的日志输出，通常可以在启动日志、控制台输出或专门的日志文件中找到具体的错误信息。
根据日志中的错误信息，进一步定位问题并采取相应的解决措施。
三. 注意事项
在处理数据库连接异常时，要注意保护敏感信息（如数据库 URL、用户名、密码等），避免泄露给未经授权的人员。
在修改配置文件或数据库设置时，要谨慎操作，避免误操作导致更多的问题。
如果不确定如何解决问题，可以参考 Spring Boot 的官方文档或社区资源寻求帮助。
5. NoSuchElementException
报错信息：
尝试从空的 Optional 中获取值时抛出。
解决方法：
在使用 Optional 之前，先通过调用 isPresent() 方法来检查其是否包含值。
如果需要获取值，可以使用 orElse() 或 orElseGet() 方法提供默认值，或使用 orElseThrow() 方法抛出异常。
6. 依赖问题
报错信息：
缺少依赖、依赖版本冲突等。
解决方法：
检查项目的依赖管理文件（如 pom.xml 或 build.gradle），确保所需的依赖都已正确声明。
使用 Maven 或 Gradle 的依赖管理工具来解决版本冲突问题。
如果可能，尝试升级或降级依赖版本以解决问题。
7. 其他常见异常
包括但不限于 NoSuchMethodError、IllegalStateException、HttpMessageNotReadableException 等，这些异常的解决方法通常需要根据具体的错误信息和上下文来确定。可以参考 Spring Boot 的官方文档或相关社区资料来获取更详细的解决方案。