Thymeleaf隐藏表单提交数据为0及reservatie对象绑定错误求解

1. 隐藏域绑定错误排查 #

• 先检查确认页GET接口是否正确将reservatie对象存入Model：GET请求跳转确认页的方法必须调用model.addAttribute("reservatie", 实例化好的Reservatie对象)，且对象的clientId、productId已经在存入前赋值，否则隐藏域拿不到值，提交后就是基本类型默认值0
• 检查Thymeleaf隐藏域的写法是否正确，必须用th:field绑定对象属性，且必须放在th:object="${reservatie}"绑定的表单标签内，否则无法完成属性映射

2. 表单提交参数映射排查 #

• 检查POST提交接口的参数是否用@ModelAttribute("reservatie") Reservatie reservatie接收，若直接用实体类接收且没有指定ModelAttribute名，会出现参数无法映射到实体字段的问题
• 检查Reservatie实体类的clientId、productId字段是否有public的getter/setter方法，若字段是private且没有对应get/set，Spring MVC无法完成参数注入，默认会保留基本类型的初始值0

3. 模板解析错误排查 #

• 确认页的form标签如果配置了th:object="${reservatie}"属性，但GET接口没有给Model存入对应名称的属性，就会直接抛出找不到'reservatie'请求属性的错误
• 检查是否存在拼写错误：实体类名、Model存入的属性名、th:object里的属性名三者是否完全一致，大小写敏感，拼写错误会直接导致属性找不到

场景1：提交后ID为0的修复步骤 #

1. 补全GET跳转确认页接口的Model赋值逻辑，示例代码：

@GetMapping("/confirm")
public String toConfirmPage(@RequestParam Long productId, @RequestParam Long clientId, Model model) {
    Reservatie reservatie = new Reservatie();
    reservatie.setProductId(productId);
    reservatie.setClientId(clientId);
    // 其他默认值赋值
    model.addAttribute("reservatie", reservatie);
    return "confirm-page";
}

2. 修正Thymeleaf表单写法：

<form th:action="@{/submit-reservatie}" th:object="${reservatie}" method="post">
    <input type="hidden" th:field="*{productId}">
    <input type="hidden" th:field="*{clientId}">
    <!-- 其他表单项 -->
    <button type="submit">确认提交</button>
</form>

3. 补全POST接口的参数绑定：

@PostMapping("/submit-reservatie")
public String submitReservatie(@ModelAttribute("reservatie") Reservatie reservatie) {
    reservatieService.save(reservatie);
    return "success-page";
}

场景2：找不到'reservatie'请求属性的修复步骤 #

• 确认所有跳转确认页的入口都给Model存入了名为reservatie的属性，包括接口异常跳转、表单校验失败回跳确认页的场景，都要重新给Model赋值reservatie对象再返回页面
• 检查实体类Reservatie的字段命名是否符合驼峰规范，getter/setter方法是否和字段名匹配，比如clientId对应的get方法必须是getClientId()，方法名拼写错误会导致属性绑定失败

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