全栈工程师-后端开发-Spring Boot_SpringBoot错误处理与异常管理.docx

PAGE1

PAGE1

SpringBoot错误处理与异常管理基础

1SpringBoot中的默认错误处理机制

SpringBoot提供了一套默认的错误处理机制，它能够自动处理应用中发生的异常，并返回一个标准的错误响应。默认情况下，当应用遇到一个未处理的异常时，SpringBoot会生成一个JSON格式的错误响应，或者在浏览器请求时返回一个默认的错误页面。

1.1JSON错误响应示例

假设你的应用抛出了一个NullPointerException，SpringBoot会返回一个类似如下的JSON响应：

{

timestamp:2023-01-01T12:00:00Z,

status:500,

error:InternalServerError,

exception:java.lang.NullPointerException,

message:Cannotinvoke\com.example.service.UserService.getUserById(long)\because\userService\isnull,

path:/api/users/1

}

在这个JSON响应中，包含了错误发生的时间戳、HTTP状态码、错误类型、异常类名、错误消息以及请求的路径。

1.2默认错误页面

对于浏览器请求，SpringBoot会返回一个默认的错误页面，页面上会显示错误的HTTP状态码和一个简短的错误描述。

2自定义错误页面和错误消息

SpringBoot允许你自定义错误页面和错误消息，这可以通过使用ErrorController或者在resources/templates目录下放置Thymeleaf模板文件来实现。

2.1使用Thymeleaf自定义错误页面

在resources/templates目录下创建一个名为error.html的文件，SpringBoot会自动使用这个模板文件作为错误页面。

!--resources/templates/error.html--

!DOCTYPEhtml

htmlxmlns:th=

head

titleError/title

/head

body

h1Error/h1

pth:text=${#httpServletRequest.getAttribute(javax.servlet.error.status_code)}StatusCode:500/p

pth:text=${#httpServletRequest.getAttribute(javax.servlet.error.message)}ErrorMessage:InternalServerError/p

/body

/html

在这个模板中，我们使用了Thymeleaf的表达式来获取错误的状态码和消息，并显示在页面上。

2.2自定义错误消息

你还可以通过在perties文件中添加error.*配置来自定义错误消息。

#perties

error.404=Resourcenotfound

error.500=Internalservererror

这样，当应用返回404或500错误时，错误消息将被替换为你自定义的消息。

3使用@ControllerAdvice进行全局异常处理

@ControllerAdvice是一个用于全局异常处理的注解，它可以让你在不修改每个控制器的情况下，统一处理应用中的异常。

3.1创建一个全局异常处理器

创建一个类，并使用@ControllerAdvice注解，然后在这个类中添加@ExceptionHandler方法来处理特定的异常。

//GlobalExceptionHandler.java

importorg.springframework.http.HttpStatus;

importorg.springframework.http.ResponseEntity;

importorg.springframework.web.bind.annotation.ControllerAdvice;

importorg.springframework.web.bind.annotation.ExceptionHandler;

@ControllerAdvice

publicclassGlobalExceptionHandler{

@ExceptionHandler(value={NullPointerE