Spring Boot表单校验触发IllegalStateException异常，寻求技术帮助

这个异常我之前也碰到过，本质就是你的表单页面找不到名为employee的表单对象（或者对应的BindingResult），导致Spring MVC渲染视图时直接崩了。咱们一步步来排查和解决：

核心原因 #

当你用Spring的表单标签（比如<form:form modelAttribute="employee">）时，Spring会在请求属性里找名为employee的对象来绑定表单数据和错误信息。但校验失败返回视图时，你没把提交的dtoEmployee对象（或者BindingResult）传到请求属性里，所以就抛出了这个异常。

具体解决方案 #

1. 检查控制器的返回逻辑（最常见的问题） #

你现在的代码里if (result.hasErrors()) { re...应该是要返回表单页面，但必须把dtoEmployee以employee的名字存入模型，这样视图才能找到它。比如修正后的代码：

@RequestMapping(value = "/employee/add", method = RequestMethod.POST)
public String addEmployee(@Valid DTOEmployee dtoEmployee, BindingResult result, Model model) {
    if (result.hasErrors()) {
        // 关键：把表单对象以视图中modelAttribute指定的名称放到模型里
        model.addAttribute("employee", dtoEmployee);
        // 返回添加员工的表单页面
        return "employee/add";
    }
    // 校验通过，执行添加逻辑
    employeeService.save(dtoEmployee);
    return "redirect:/employee/list";
}

2. 用@ModelAttribute简化代码（推荐） #

如果你不想手动写model.addAttribute，可以给参数加上@ModelAttribute("employee")注解，Spring会自动把这个对象以employee的名字存入模型，代码更简洁：

@RequestMapping(value = "/employee/add", method = RequestMethod.POST)
public String addEmployee(@Valid @ModelAttribute("employee") DTOEmployee dtoEmployee, BindingResult result) {
    if (result.hasErrors()) {
        // 直接返回即可，@ModelAttribute已经帮你把对象放到模型里了
        return "employee/add";
    }
    employeeService.save(dtoEmployee);
    return "redirect:/employee/list";
}

3. 确认两个关键细节 #

• BindingResult的位置不能错：必须紧跟在加了@Valid的参数后面，中间不能插其他参数（比如Model、HttpServletRequest之类的），否则Spring无法正确绑定校验结果。
• 表单页面的modelAttribute要匹配：确保你页面里的<form:form>标签的modelAttribute属性值是employee，和控制器里传入模型的名称一致。比如：

  <form:form modelAttribute="employee" method="post" action="/employee/add">
      <!-- 表单字段 -->
  </form:form>
  

总结一下 #

这个问题本质就是视图和控制器之间的表单对象名称不匹配，或者校验失败时没把对象传到视图，按照上面的步骤调整，应该就能解决啦。

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