Spring Boot中如何为RequestBody无效枚举值返回自定义错误信息

一、实现无效Role枚举值返回400错误 #

完全可以通过校验或异常处理实现需求，两种常用方案：

方案1：自定义枚举校验注解 #

1. 定义自定义校验注解@ValidRole：

@Target({FIELD, PARAMETER})
@Retention(RUNTIME)
@Constraint(validatedBy = RoleValidator.class)
public @interface ValidRole {
    String message() default "role is invalid";
    Class<?>[] groups() default {};
    Class<? extends Payload>[] payload() default {};
}

2. 实现校验逻辑类RoleValidator：

public class RoleValidator implements ConstraintValidator<ValidRole, String> {
    private Set<String> validRoles;

    @Override
    public void initialize(ValidRole constraintAnnotation) {
        validRoles = Arrays.stream(RoleEnum.values())
                           .map(Enum::name)
                           .collect(Collectors.toSet());
    }

    @Override
    public boolean isValid(String value, ConstraintValidatorContext context) {
        return value == null || validRoles.contains(value);
    }
}

3. 在UpdateUserByAdminDTO的role字段上绑定注解（建议用String类型接收，先校验再转枚举，避免提前触发反序列化异常）：

public class UpdateUserByAdminDTO {
    @ValidRole(message = "role is invalid")
    private String role;
    // 其他字段...
}

4. 接口上添加@Validated开启校验：

@PutMapping("/users/{id}")
public ResponseEntity<?> updateUser(@PathVariable Long id, @Validated @RequestBody UpdateUserByAdminDTO dto) {
    // 业务逻辑
}

传入无效role值时会触发ConstraintViolationException，配合全局异常处理器即可返回400状态码和指定提示。

方案2：全局捕获Jackson反序列化异常 #

如果坚持用RoleEnum类型接收字段，可通过全局异常处理器捕获枚举反序列化失败的异常：

@RestControllerAdvice
public class GlobalExceptionHandler {
    @ExceptionHandler(HttpMessageNotReadableException.class)
    public ResponseEntity<String> handleJsonParseException(HttpMessageNotReadableException e) {
        if (e.getCause() instanceof InvalidFormatException) {
            InvalidFormatException cause = (InvalidFormatException) e.getCause();
            if (cause.getTargetType().isEnum() && cause.getTargetType().equals(RoleEnum.class)) {
                return ResponseEntity.badRequest().body("role is invalid");
            }
        }
        return ResponseEntity.badRequest().body("request body format error");
    }
}

二、已登录权限正确却收到403的问题排查 #

日志显示HttpMessageNotReadableException却返回403，核心是异常被错误拦截映射，排查方向：

• 检查Spring Security配置：确认自定义的AuthenticationEntryPoint或AccessDeniedHandler是否误将HttpMessageNotReadableException判定为权限问题返回403。
• 提升全局异常处理器优先级：给全局异常处理器添加@Order(Ordered.HIGHEST_PRECEDENCE)，确保它先于Spring Security处理异常。
• 核对接口权限注解：检查@PreAuthorize等权限注解的表达式是否正确，避免权限逻辑误判。

内容的提问来源于stack exchange，提问作者Ryley38