Spring Boot自定义异常处理：异常消息莫名添加前缀问题排查

1. 处理方法是否存在问题？如何解决消息前缀问题？ #

你的handleConstraintViolationException实现本身没有问题，消息出现uploadFile.file:前缀是因为ConstraintViolationException的默认错误消息会包含约束对应的字段路径（这里指上传接口中uploadFile方法的file参数）。

解决方法是从异常中提取纯业务错误消息，而非直接使用异常的getMessage()：

• 遍历ex.getConstraintViolations()集合，通过ConstraintViolation::getMessage获取你在校验注解中定义的纯提示文本
• 将提取后的消息传入buildErrorResponse，替换原本带前缀的消息

修改后的示例代码：

@ExceptionHandler(ConstraintViolationException.class)
@ResponseStatus(HttpStatus.UNPROCESSABLE_ENTITY)
public ResponseEntity<Object> handleConstraintViolationException(
                              ConstraintViolationException ex, 
                              WebRequest request) {
    log.error("Invalid file type.", ex);
    // 提取纯错误消息列表
    List<String> errorMessages = ex.getConstraintViolations()
            .stream()
            .map(ConstraintViolation::getMessage)
            .collect(Collectors.toList());
    // 根据buildErrorResponse方法定义，调整参数传入处理后的消息
    return buildErrorResponse(String.join("; ", errorMessages), HttpStatus.UNPROCESSABLE_ENTITY, request);
}

如果buildErrorResponse必须接收Exception对象，也可以在该方法内部针对ConstraintViolationException做特殊处理，跳过字段前缀解析。

2. 是否需要自定义异常类处理ConstraintViolationException？ #

不需要自定义异常类。javax.validation提供的ConstraintViolationException已经封装了约束违反场景下的所有必要信息（如违规字段、约束规则、错误提示等），完全满足文件上传类型校验这类场景的异常处理需求。只有当你需要扩展额外业务属性或特殊逻辑时，才需要考虑自定义异常类。

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