You need to enable JavaScript to run this app. Spring MVC不使用@Valid注解如何实现自定义输入校验
优惠活动
大模型
产品
解决方案
定价
更多

Spring MVC不使用@Valid注解如何实现自定义输入校验

你当前实现方案的问题

你的方案功能层面是可以实现需求的,但存在三个比较明显的设计缺陷:

  • 领域模型污染:@Entity类是用来映射数据库表结构的,为了表单校验新增的@Transient临时字符串字段,本质是把视图层的适配逻辑硬塞进了领域实体,长期维护会让实体类职责混乱,后续复用实体类的时候这些临时字段会造成无意义的冗余
  • 重复代码量极高:每新增一个数值类型的校验字段,就要在实体类加一对临时字段、对应的getter/setter,字段多了之后代码冗余度会非常高
  • 现有代码存在语法错误:控制器里写的Person.getStrYear()、Person.setYear(...)是类静态调用的写法,根本拿不到前端传参后注入的person实例值,实际运行会直接报错
更优的无@Valid注解实现方案

完全不需要改动实体类结构,利用SpringMVC原生的自定义类型绑定扩展点,就能实现自定义校验、绕开默认的类型转换异常,核心改造逻辑如下:

1. 用@InitBinder接管字段绑定逻辑

在对应控制器(或全局的控制器增强类)中,注册针对year字段的自定义绑定规则,替代SpringMVC默认碰到非数字就直接抛异常的转换逻辑:

@InitBinder
public void initYearBinder(WebDataBinder binder) {
    // 针对Person类的year字段,注册自定义字符串转int的规则
    binder.registerCustomEditor(int.class, "year", new StringTrimmerEditor(true) {
        @Override
        public void setAsText(String text) {
            // 完全自定义校验逻辑,不会提前抛出类型转换异常
            if (text == null || text.isBlank()) {
                // 空值场景处理:按业务需求设置默认值或标记错误
                setValue(0);
                return;
            }
            // 自定义数字格式校验规则
            if (!text.matches("^\\d{4}$")) {
                // 校验不通过时,直接向绑定结果写入错误信息
                binder.getBindingResult().rejectValue("year", "year.format.error", "请输入4位有效数字的年份");
                return;
            }
            // 校验通过时正常转换为int类型
            setValue(Integer.parseInt(text.trim()));
        }
    });
}

校验不通过时,Spring会自动把用户输入的原始字符串存在绑定结果的错误对象中,Thymeleaf渲染表单时会自动把这个值填回输入框,不需要手动在实体类存储临时字符串字段做适配。

2. 控制器层简化校验逻辑

不需要在实体类加任何临时字段,直接通过BindingResult读取校验结果即可:

@RequestMapping(value = "/person", method = RequestMethod.POST)
public ModelAndView editPerson(@ModelAttribute Person person, BindingResult bindingResult) {
    ModelAndView modelAndView = new ModelAndView("Person.html");
    modelAndView.addObject("personBind", person);
    
    // 直接判断是否有校验错误,不需要手动写字符串转数字的逻辑
    if (bindingResult.hasErrors()) {
        // 校验不通过:跳转回表单页,Thymeleaf会自动回显错误信息和用户输入的原始值
        return modelAndView;
    }
    
    // 校验通过:执行业务保存逻辑
    // savePerson(person);
    
    return modelAndView;
}

方案优势

  • 实体类完全保持原有结构,不需要新增任何临时适配字段,领域模型职责清晰
  • 校验逻辑可以抽成公共工具类,所有需要数值校验的字段可以复用同一套绑定规则,没有冗余代码
  • 全程不使用@Valid注解,所有校验规则完全由自己掌控,不存在框架内置校验逻辑的黑盒
  • 原生支持表单回显,校验不通过时用户输入的原始内容会保留在输入框中,不会出现空值
补充说明

如果后续校验字段越来越多,更规范的做法是单独定义一个和前端表单结构对应的请求DTO,专门用来承接前端参数、做参数校验,完全不和数据库映射的@Entity类混用。但针对你当前不想大改现有代码的场景,用@InitBinder自定义绑定的方案是改动最小、冗余最少的实现方式。

内容的提问来源于stack exchange,提问作者jkfe

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.14 14:06:04