Spring Boot自定义转换器异常被包装为MethodArgumentNotValidException问题

方案1：优化全局异常处理器，精准提取自定义异常 #

不用硬遍历FieldError的嵌套结构，写个通用工具方法递归查找异常链里的CustomException，然后在全局异常处理器里处理MethodArgumentNotValidException时调用这个方法：

// 通用工具：递归获取异常链中的CustomException
private CustomException findRootCustomException(Throwable ex) {
    while (ex != null) {
        if (ex instanceof CustomException) {
            return (CustomException) ex;
        }
        ex = ex.getCause();
    }
    return null;
}

// 全局异常处理器
@ControllerAdvice
public class GlobalExceptionHandler {

    @ExceptionHandler(MethodArgumentNotValidException.class)
    public ResponseEntity<ErrorResponse> handleValidationExceptions(MethodArgumentNotValidException ex) {
        // 遍历所有字段错误，查找根源的自定义异常
        for (FieldError error : ex.getBindingResult().getFieldErrors()) {
            CustomException customEx = findRootCustomException(error.unwrap(Throwable.class));
            if (customEx != null) {
                return ResponseEntity.badRequest()
                        .body(new ErrorResponse(customEx.getMessage()));
            }
        }
        // 未找到自定义异常时返回默认验证错误
        return ResponseEntity.badRequest()
                .body(new ErrorResponse("请求参数格式错误"));
    }

    // 兼容直接抛出CustomException的场景（比如Mac环境）
    @ExceptionHandler(CustomException.class)
    public ResponseEntity<ErrorResponse> handleCustomException(CustomException ex) {
        return ResponseEntity.badRequest()
                .body(new ErrorResponse(ex.getMessage()));
    }
}

这个方法不依赖固定的异常嵌套层级，不管异常被包装多少层，都能精准定位到CustomException。

方案2：自定义ErrorAttributes，统一处理错误响应 #

扩展Spring的DefaultErrorAttributes，在构建错误响应时自动扫描异常链，找到CustomException就替换默认错误信息：

@Component
public class CustomErrorAttributes extends DefaultErrorAttributes {

    @Override
    public Map<String, Object> getErrorAttributes(WebRequest webRequest, ErrorAttributeOptions options) {
        Map<String, Object> errorAttributes = super.getErrorAttributes(webRequest, options);
        Throwable error = getError(webRequest);
        CustomException customEx = findRootCustomException(error);
        
        if (customEx != null) {
            errorAttributes.put("message", customEx.getMessage());
            errorAttributes.put("status", HttpStatus.BAD_REQUEST.value());
        }
        return errorAttributes;
    }

    private CustomException findRootCustomException(Throwable ex) {
        while (ex != null) {
            if (ex instanceof CustomException) {
                return (CustomException) ex;
            }
            // 处理MethodArgumentNotValidException的情况，遍历字段错误查找根源
            if (ex instanceof MethodArgumentNotValidException) {
                MethodArgumentNotValidException validEx = (MethodArgumentNotValidException) ex;
                for (FieldError fieldError : validEx.getBindingResult().getFieldErrors()) {
                    CustomException nestedEx = findRootCustomException(fieldError.unwrap(Throwable.class));
                    if (nestedEx != null) {
                        return nestedEx;
                    }
                }
            }
            ex = ex.getCause();
        }
        return null;
    }
}

这种方式能统一处理所有异常场景，不管异常被包装成什么结构，都自动提取自定义异常信息，不用单独处理每种异常类型。

方案3：调整转换器的异常抛出逻辑 #

在自定义Converter里，不直接抛CustomException，而是构造ConversionFailedException时把CustomException作为cause传入，同时带上自定义错误信息：

@Override
public CustomObject convert(String source) {
    try {
        // 你的Base64转CustomObject逻辑
    } catch (Exception e) {
        CustomException customEx = new CustomException("Unable to handle string", e);
        throw new ConversionFailedException(
                TypeDescriptor.valueOf(String.class),
                TypeDescriptor.valueOf(CustomObject.class),
                source,
                customEx
        );
    }
}

这样既符合Spring转换体系的异常规范，也能让后续的异常处理更清晰地追踪到根源的自定义异常。

环境差异说明 #

Mac和Windows环境的异常处理差异，大概率是团队成员的Spring Boot/Spring Framework版本不一致导致的，建议统一项目依赖版本，避免版本差异引发的逻辑不一致。

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