Spring Boot整合Thymeleaf下拉框报错：无法为基本类型赋值null

错误原因分析 #

java.lang.IllegalArgumentException: A null value cannot be assigned to a primitive type 本质是基本类型（如int、long）无法接收null值。结合你的多对一场景，大概率是Repair实体中关联Terminal的字段用了基本类型（比如int terminalId），当表单提交时若未选择Terminal（或绑定逻辑出错），会传递null值给该字段，触发这个异常。

具体解决方案 #

1. 修改实体类的基本类型字段为包装类 #

找到Repair实体中对应Terminal关联的字段：

• 如果是直接存储Terminal的id：

  // 错误写法：基本类型无法接收null
  private int terminalId;
  // 正确写法：包装类可以处理null
  private Integer terminalId;
  

• 如果是关联Terminal对象，检查Terminal实体的id字段：

  // Terminal实体中同样要把基本类型id改成包装类
  private Integer id;
  

同时确保对应的getter/setter方法参数也同步改为包装类。

2. 修正控制器的表单绑定逻辑 #

• 在返回新增表单的GET方法中，确保将Terminal列表传入视图，供下拉框渲染：

  @GetMapping("/repairs/new")
  public String showNewRepairForm(Model model) {
      model.addAttribute("repair", new Repair());
      // 传入所有终端数据到视图
      model.addAttribute("terminals", terminalService.listAll());
      return "repair-form";
  }
  

• 处理表单提交的POST方法中，避免使用基本类型接收参数：

  @PostMapping("/repairs")
  public String saveRepair(@ModelAttribute("repair") Repair repair) {
      repairService.save(repair);
      return "redirect:/repairs";
  }
  

如果是单独接收terminalId参数，要使用Integer类型：

@PostMapping("/repairs")
public String saveRepair(@RequestParam("terminalId") Integer terminalId, @ModelAttribute("repair") Repair repair) {
    Terminal terminal = terminalService.getById(terminalId);
    repair.setTerminal(terminal);
    repairService.save(repair);
    return "redirect:/repairs";
}

3. 调整Thymeleaf下拉框代码 #

确保下拉框的th:field与实体类字段匹配，同时保留空选项时要对应包装类字段：

<div class="form-group">
    <label>选择终端</label>
    <select th:field="*{terminal.id}" class="form-control">
        <!-- 空选项：提交时会传递null，需要包装类支持 -->
        <option value="">请选择终端</option>
        <option th:each="terminal : ${terminals}" th:value="${terminal.id}" th:text="${terminal.name}"></option>
    </select>
</div>

如果不想允许空选项，去掉<option value="">即可，但要确保前端校验用户必须选择一个终端。

4. 结合异常堆栈定位具体字段 #

查看异常堆栈的具体行，比如：

at com.yourpackage.entity.Repair.setTerminalId(Repair.java:45)

直接定位到Repair类的45行，确认该字段是基本类型，改为包装类即可。

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