Thymeleaf视图数据获取问题：Controller接收表单数据空指针异常

嘿，我来帮你排查这个头疼的问题！你遇到的「HTML里能正常显示用户名密码，但Controller里除手动ID外其他数据全为空」的情况，大概率是数据绑定环节出了问题，下面是几个常见的排查方向和解决办法：

• 检查表单字段的name属性与Kpi实体类的属性名是否完全匹配

  这是最容易踩的坑！Spring MVC是通过表单字段的name属性来匹配实体类属性的，和id没关系。比如你的Kpi类有username属性，那表单对应的输入框必须是<input type="text" name="username">——如果写成name="userName"（大小写不对）、漏写name只写了id，都会导致绑定失败。
  建议你把Kpi类的属性列表和HTML表单的name值逐一对照，确保拼写、大小写完全一致。

• 确认Kpi实体类有无参构造函数
  Spring MVC在实例化实体类进行数据绑定时，必须调用无参构造函数。如果你的Kpi类只定义了带参数的构造函数，没显式写无参构造，框架就没法创建对象，属性自然全为空。
  解决办法很简单，给Kpi类加个空的无参构造：

  public Kpi() {
      // 空实现就行
  }
  

• 检查Spring MVC的自动绑定配置是否启用
  如果是XML配置方式，要确保配置文件里加了<mvc:annotation-driven />；如果是Java配置，要在@Configuration类上标注@EnableWebMvc。这个配置会自动注册数据绑定所需的组件，没开的话参数绑定根本没法正常工作。

• 通过BindingResult排查校验或绑定错误
  你已经用了@Valid注解，不妨利用BindingResult打印一下错误信息，看看是不是校验规则导致绑定失败：

  @RequestMapping(value = "/kpi", method = RequestMethod.POST)
  public ModelAndView showKPI(@Valid Kpi kpi, BindingResult bindingResult, Model model) throws Exception {
      if (bindingResult.hasErrors()) {
          // 把所有错误打印到控制台，方便定位
          bindingResult.getAllErrors().forEach(error -> System.err.println("绑定/校验错误：" + error.getDefaultMessage()));
          // 这里可以返回原表单页面，让用户修正
          return new ModelAndView("your-form-page");
      }
      // 后续业务逻辑
      return new ModelAndView("kpi-page", "kpi", kpi);
  }
  

  控制台的错误信息可能会直接告诉你哪个字段绑定失败了。

• 排查自定义WebDataBinder的干扰
  如果你的Controller里写了@InitBinder方法，可能不小心修改了绑定规则——比如排除了某些字段，或者自定义转换器出了问题。检查一下有没有类似这样的代码：

  @InitBinder
  public void initBinder(WebDataBinder binder) {
      // 比如这行代码会禁止username和password字段被绑定
      // binder.setDisallowedFields("username", "password");
  }
  

  如果有，调整配置确保需要绑定的字段没有被排除。

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