Spring Boot 如何处理错误？

Spring Boot 如何优雅地处理错误

在构建健壮且用户友好的应用程序时，错误处理至关重要。Spring Boot 提供了强大的特性和机制来实现优雅且一致的错误处理。

使用 @RestControllerAdvice 处理异常

@RestControllerAdvice 注解允许我们为特定异常创建集中式错误处理程序。它通过基于异常类型将异常映射到 HTTP 响应状态码和消息体来实现此目的。

@RestControllerAdvice
public class ErrorControllerAdvice {

    @ExceptionHandler(IllegalArgumentException.class)
    public ResponseEntity<Object> handleBadRequest(IllegalArgumentException e) {
        return ResponseEntity.badRequest().body(e.getMessage());
    }
}

使用 @ResponseStatus 定义 HTTP 状态码

@ResponseStatus 注解允许我们为异常定义特定的 HTTP 状态码。这使得我们可以根据异常严重性控制响应状态。

@ResponseStatus(HttpStatus.FORBIDDEN)
public class AccessDeniedException extends RuntimeException {
}

使用 ResponseEntity 返回自定制的 HTTP 响应

ResponseEntity 类允许我们完全控制响应状态码、标题和正文。我们可以使用它来返回包含附加错误详细信息的自定制 JSON 或 XML 响应。

Napkin AI

Napkin AI 可以将您的文本转换为图表、流程图、信息图、思维导图视觉效果，以便快速有效地分享您的想法。

下载

ResponseEntity.status(HttpStatus.NOT_FOUND)
                .body("The specified resource was not found.");

使用 global 属性定义全局错误处理

@RestControllerAdvice 可以使用 global 属性声明为全局错误处理程序。这意味着它将处理所有未明确处理的异常：

@RestControllerAdvice(global = true)

实战案例

考虑以下 REST 控制器：

@RestController
@RequestMapping("/api/users")
public class UserController {
    
    // ...

    @PostMapping
    public User createUser(@RequestBody User user) {
        if (user.getUsername() == null) {
            throw new IllegalArgumentException("Username cannot be null");
        }
        // ...
    }
}

与上述错误处理机制一起使用后，当客户端发送不含 username 的 POST 请求时，它将收到 HTTP 400 “错误的请求”响应以及错误消息。

通过遵循这些最佳实践，您可以确保 Spring Boot 应用程序以优雅且信息丰富的方式处理错误，从而增强用户体验并简化问题解决。