Spring Boot Thymeleaf下拉传值Null 多对一保存报错排查

报错本质是表单参数到JPA实体的类型转换失败：下拉框提交的是State主键idState的基础类型值（数字/字符串），但Figure实体的state属性是State类型的持久化对象，Spring MVC默认没有配置对应转换规则时，无法直接把提交的主键值转成State实体实例，最终绑定后state字段为null，触发Hibernate非空约束校验。

按以下步骤逐一检查调整即可：

• 修正Thymeleaf表单下拉框的绑定规则
  下拉框必须直接绑定到Figure的state关联属性，选项值配置为State的主键，不要错误绑定到id类字段，正确写法示例：

  <select th:field="*{state}" class="form-control" required>
      <option value="">请选择关联的政权</option>
      <option 
          th:each="stateItem : ${stateList}" 
          th:value="${stateItem.idState}" 
          th:text="${stateItem.stateName}">
      </option>
  </select>
  

  注意：th:field="*{state}"路径必须直接指向关联属性，不要写成*{idState}、*{state.idState}这类错误路径；表单渲染时传入模型的State列表属性名要和th:each里引用的变量名一致。

• 配置Spring MVC自定义转换器，自动完成主键到实体的转换
  新增转换器组件，让Spring MVC在绑定参数时，自动根据提交的主键值从数据库查出对应的State实体，直接赋值给Figure的state属性：

  import org.springframework.core.convert.converter.Converter;
  import org.springframework.stereotype.Component;
  
  @Component
  public class StateConverter implements Converter<String, State> {
      private final StateRepository stateRepository;
  
      // 构造器注入StateRepository，用@Autowired注入也可，推荐构造器注入
      public StateConverter(StateRepository stateRepository) {
          this.stateRepository = stateRepository;
      }
  
      @Override
      public State convert(String idVal) {
          if (idVal == null || idVal.isBlank()) {
              return null;
          }
          // 主键类型如果是Long就改成Long.parseLong，按实际的主键类型调整
          Integer stateId = Integer.parseInt(idVal);
          return stateRepository.findById(stateId)
                  .orElseThrow(() -> new IllegalArgumentException("传入的State ID无效：" + stateId));
      }
  }
  

  项目里如果有其他多对一/一对一关联需要绑定，要么按相同逻辑写对应转换器，要么抽成通用的泛型JPA实体转换器即可。

• 检查Controller层的参数绑定配置
  确保保存接口的Figure参数正确标注@ModelAttribute，且模型中传入的表单绑定对象名称和注解指定的名称一致，参考写法：

  // 表单渲染接口示例
  @GetMapping("/figure/add")
  public String showAddForm(Model model) {
      model.addAttribute("figure", new Figure()); // 绑定对象名是figure
      model.addAttribute("stateList", stateRepository.findAll()); // 传入全量State列表
      return "figure_form";
  }
  
  // 保存接口示例
  @PostMapping("/figure/save")
  public String saveFigure(@ModelAttribute("figure") Figure figure, BindingResult bindingResult, Model model) {
      // 提前校验绑定错误，避免直接抛500
      if (bindingResult.hasErrors()) {
          model.addAttribute("stateList", stateRepository.findAll());
          return "figure_form";
      }
      figureRepository.save(figure);
      return "redirect:/figure/list";
  }
  

  常见低级错误：表单渲染时给模型放的Figure对象叫newFigure，保存接口@ModelAttribute写的是figure，会导致属性完全绑定不上。

改完后重启服务提交表单，在Controller保存方法打断点可以看到Figure实例的state属性已经是带id值的持久化实体，不会再报not-null关联异常，数据可以正常入库。

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