在 Spring Boot 中使用“内部服务器错误”代替验证消息

在 Spring Boot 中处理内部服务器错误而不是验证消息

该解决方案演示了如何使用正确的错误处理技术和 Java 最佳实践来处理 Spring Boot 后端中的验证错误。

package com.registration.RegistrationManagementAPI.controllers;
import com.registration.RegistrationManagementAPI.models.User;
import com.registration.RegistrationManagementAPI.services.UserService;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.http.HttpStatus;
import org.springframework.http.ResponseEntity;
import org.springframework.validation.BindingResult;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestBody;
import org.springframework.web.bind.annotation.RestController;
import jakarta.validation.Valid;
import java.util.HashMap;
import java.util.Map;
@RestController
public class UserController {
    @Autowired
    private UserService userService;
    @PostMapping("/users")
    public ResponseEntity<?> createUser(@RequestBody @Valid User user, BindingResult bindingResult) {
        if (bindingResult.hasErrors()) {
            Map<String, String> errors = new HashMap<>();
            bindingResult.getFieldErrors().forEach(error ->
                errors.put(error.getField(), error.getDefaultMessage())
            );
            return new ResponseEntity<>(errors, HttpStatus.BAD_REQUEST);
        }
        userService.addUser(user);
        return new ResponseEntity<>("User Created Successfully", HttpStatus.OK);
    }
}

在 Spring Boot 中使用全局异常处理程序

该解决方案使用全局异常处理程序来全局捕获和自定义验证错误，这提供了一种更简洁的方法。

package com.registration.RegistrationManagementAPI.exceptions;
import org.springframework.http.HttpStatus;
import org.springframework.http.ResponseEntity;
import org.springframework.validation.FieldError;
import org.springframework.web.bind.MethodArgumentNotValidException;
import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.bind.annotation.RestControllerAdvice;
import java.util.HashMap;
import java.util.Map;
@RestControllerAdvice
public class GlobalExceptionHandler {
    @ExceptionHandler(MethodArgumentNotValidException.class)
    public ResponseEntity<Map<String, String>> handleValidationErrors(MethodArgumentNotValidException ex) {
        Map<String, String> errors = new HashMap<>();
        ex.getBindingResult().getAllErrors().forEach((error) -> {
            String fieldName = ((FieldError) error).getField();
            String errorMessage = error.getDefaultMessage();
            errors.put(fieldName, errorMessage);
        });
        return new ResponseEntity<>(errors, HttpStatus.BAD_REQUEST);
    }
}

有关 Spring Boot 中验证和错误处理的常见问题

1. 如何处理 Spring Boot 中的多个验证错误？
2. 通过使用 BindingResult 要捕获所有错误并将其作为地图或列表返回，您可以一次向用户显示多个验证消息。
3. 目的是什么 @RestControllerAdvice？
4. @RestControllerAdvice 允许您为整个应用程序定义全局异常处理，确保错误响应的一致性。
5. 为什么我收到“内部服务器错误”而不是验证错误？
6. 当控制器中未正确处理验证错误时，就会发生这种情况。使用 BindingResult 或者全局异常处理程序可以解决这个问题。
7. 什么是 @Valid 在 Spring Boot 中做什么？
8. 这 @Valid 在控制器处理数据之前，注释会触发对请求正文的验证。它检查约束，例如 @NotNull 或者 @NotBlank。
9. 如何返回自定义的错误消息？
10. 您可以通过在验证注释中定义自定义错误消息来返回它们，例如 @NotNull(message="Field cannot be null")。

验证和错误处理的要点

当验证失败时，Spring Boot 应用程序经常会遇到通用错误消息，但可以通过实施适当的错误处理技术来解决这些问题。使用像这样的注释 @有效的 并利用 绑定结果 允许系统捕获并显示指导用户的特定错误消息。

此外，通过使用全局异常处理程序 @RestControllerAdvice，开发人员可以在整个应用程序中一致地管理错误，从而带来更可预测和更流畅的用户体验。解决这些问题不仅有助于调试，还可以增强整体应用程序的稳定性。