Spring Validation：自定义无效数据类型输入校验消息的问题

问题原因 #

当输入无法转换为指定类型（如字符串转float）时，Spring会在数据绑定阶段自动生成类型不匹配的错误消息，之后你在Controller中手动调用rejectValue添加的自定义消息会叠加到原有错误列表中，导致两个消息同时显示。

解决方案 #

方法1：通过messages.properties覆盖默认消息（推荐） #

Spring提供了默认的错误代码，我们可以通过配置文件直接替换类型转换失败的默认消息，无需修改Controller代码。

1. 在src/main/resources下创建messages.properties文件，添加对应字段的自定义消息：

   # 针对特定实体类的特定字段（假设你的实体类名为AppInfo，字段为version）
   typeMismatch.appInfo.version=Version must be a number
   
   # 或者针对所有float类型字段的通用配置
   typeMismatch.float=Version must be a number
   
   # 更通用的类型不匹配配置（适用于所有类型转换失败场景）
   typeMismatch=请输入正确格式的值
   

2. 确保Spring Boot能加载到该配置文件，在application.properties中添加：

   spring.messages.basename=messages
   

这样，默认的类型转换错误消息会被自定义消息直接替换，不会出现叠加的情况。

方法2：全局异常处理器处理BindException #

如果需要更灵活的逻辑（比如根据不同场景返回不同消息），可以通过@ControllerAdvice全局处理绑定异常，替换或清除默认错误消息。

@ControllerAdvice
public class GlobalBindingErrorHandler {

    @ExceptionHandler(BindException.class)
    public String handleBindException(BindException ex, Model model) {
        // 遍历所有错误，替换指定字段的类型不匹配消息
        List<ObjectError> errors = ex.getAllErrors();
        for (int i = 0; i < errors.size(); i++) {
            ObjectError error = errors.get(i);
            if (error instanceof FieldError) {
                FieldError fieldError = (FieldError) error;
                // 匹配version字段的类型不匹配错误
                if ("version".equals(fieldError.getField()) && "typeMismatch".equals(fieldError.getCode())) {
                    // 替换为自定义消息
                    errors.set(i, new FieldError(fieldError.getObjectName(), "version", "Version must be a number"));
                }
            }
        }
        // 将处理后的错误绑定到模型，返回表单页面（替换为你的实际页面名称）
        model.addAttribute("org.springframework.validation.BindingResult." + ex.getObjectName(), ex);
        return "your-form-page";
    }
}

方法3：移除Controller中的rejectValue调用（不推荐） #

如果坚持在Controller中处理，需要先清除原有错误消息再添加自定义消息，但这种方式代码冗余，不如前两种方法优雅：

@PostMapping("/submit")
public String submitForm(@Valid YourEntity entity, BindingResult result, Model model) {
    // 先清除所有类型不匹配的错误
    result.getAllErrors().removeIf(error -> 
        error instanceof FieldError && "version".equals(((FieldError) error).getField()) 
        && "typeMismatch".equals(error.getCode())
    );
    // 再添加自定义消息
    if (result.hasErrors()) {
        result.rejectValue("version", "error.version", "Version must be a number");
        return "form";
    }
    // 后续逻辑
    return "success";
}

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