无法通过ControllerAdvice捕获枚举验证触发的HttpMessageNotReadableException

核心原因 #

HttpMessageNotReadableException是在请求体Jackson反序列化阶段抛出的，这个阶段早于@Valid校验的执行时机。而继承ResponseEntityExceptionHandler后，该类本身已经内置了对这个异常的处理方法，你额外添加的@ExceptionHandler(HttpMessageNotReadableException.class)会和内置方法形成处理歧义，导致Spring无法确定用哪个，启动报错，同时也会导致自定义逻辑不生效。

具体解决方案 #

方案1：放弃继承ResponseEntityExceptionHandler，直接自定义全局异常处理器 #

@RestControllerAdvice
@Order(Ordered.HIGHEST_PRECEDENCE)
public class GlobalExceptionHandler {

    @ExceptionHandler(HttpMessageNotReadableException.class)
    public ResponseEntity<ErrorResponse> handleHttpMessageNotReadable(HttpMessageNotReadableException e) {
        String message = "请求参数非法：无效的枚举值";
        Throwable cause = e.getCause();
        if (cause instanceof InvalidFormatException) {
            InvalidFormatException formatException = (InvalidFormatException) cause;
            if (formatException.getTargetType().isEnum()) {
                message = String.format("无效的枚举值：%s，允许的值为：%s", 
                    formatException.getValue(), 
                    Arrays.toString(formatException.getTargetType().getEnumConstants()));
            }
        }
        return ResponseEntity.badRequest().body(new ErrorResponse(message));
    }

    // 其他异常处理方法...
}

这样可以避免和ResponseEntityExceptionHandler的内置方法冲突，确保自定义逻辑优先执行。

方案2：继承ResponseEntityExceptionHandler并重写对应方法 #

如果必须继承该类，不要单独加@ExceptionHandler，而是直接重写handleHttpMessageNotReadable方法：

@RestControllerAdvice
@Order(Ordered.HIGHEST_PRECEDENCE)
public class GlobalExceptionHandler extends ResponseEntityExceptionHandler {

    @Override
    protected ResponseEntity<Object> handleHttpMessageNotReadable(HttpMessageNotReadableException ex, HttpHeaders headers, HttpStatus status, WebRequest request) {
        String message = "请求参数非法：无效的枚举值";
        Throwable cause = ex.getCause();
        if (cause instanceof InvalidFormatException) {
            InvalidFormatException formatException = (InvalidFormatException) cause;
            if (formatException.getTargetType().isEnum()) {
                message = String.format("无效的枚举值：%s，允许的值为：%s", 
                    formatException.getValue(), 
                    Arrays.toString(formatException.getTargetType().getEnumConstants()));
            }
        }
        ErrorResponse errorResponse = new ErrorResponse(message);
        return handleExceptionInternal(ex, errorResponse, headers, HttpStatus.BAD_REQUEST, request);
    }

    // 重写其他需要自定义的异常处理方法...
}

这种方式不会产生歧义，因为是覆盖父类的默认实现。

方案3：调整枚举校验的时机（可选） #

如果希望把枚举校验放在@Valid阶段执行，而不是反序列化时，可以修改Jackson的枚举反序列化配置：

1. 在枚举类上添加@JsonValue注解，提供匹配方法：

public enum UserRole {
    ADMIN("admin"),
    USER("user");

    private final String value;

    UserRole(String value) {
        this.value = value;
    }

    @JsonValue
    public String getValue() {
        return value;
    }

    public static UserRole fromValue(String value) {
        for (UserRole role : values()) {
            if (role.value.equalsIgnoreCase(value)) {
                return role;
            }
        }
        return null;
    }
}

2. 保留DTO字段上的@EnumValidator注解，这样反序列化时不会抛出异常，而是在@Valid校验阶段触发自定义校验器逻辑，此时抛出的ConstraintViolationException可在全局异常处理器中统一处理。

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