Thymeleaf表单绑定：用其他对象字段给目标对象赋值提交失败问题

绑定失效核心原因 #

• th:field属性会自动生成input标签的name、id、value三个核心属性，手动添加的th:value会被th:field读取到的绑定对象属性值覆盖。传入前端的medicineOrder是全新实例，medicineId为long类型默认值0，boxes是空ArrayList，因此渲染出的输入框value均为空/默认值，提交后自然无法传递正确数据。
• Spring MVC默认不会自动创建List类型绑定参数的索引位元素，如果传入的List初始为空，直接提交boxes[*].xxx格式的带索引参数，框架无法识别对应集合元素，会出现字段绑定丢失。

修复步骤 #

1. 后端GET接口提前初始化绑定对象默认值 #

不要传递空的MedicineOrder实例到前端，在加载页面时就提前给medicineId赋值，同时根据medicine.medicineBoxes的长度，提前往boxes集合中填充对应数量的OrderedBox实例，把需要默认展示的boxNumber、medicineCount值预填进去，前端th:field可以直接读取绑定对象的值渲染，无需额外写th:value注入。
修改后的GET接口代码：

@GetMapping("/{medicineId}")
public String loadMedicineDetailPage(@PathVariable("medicineId") long medicineId, Model model) {
    Medicine medicine = service.getMedicineById(medicineId);
    model.addAttribute("medicine", medicine);

    MedicineOrder medicineOrder = new MedicineOrder();
    // 预填药品ID
    medicineOrder.setMedicineId(medicineId);
    // 预初始化订单药盒集合
    List<OrderedBox> orderedBoxes = new ArrayList<>();
    for (MedicineBox medicineBox : medicine.getMedicineBoxes()) {
        OrderedBox orderedBox = new OrderedBox();
        // 预填默认药盒编号、默认药品数量
        orderedBox.setBoxNumber(medicineBox.getBox().getNumber());
        orderedBox.setMedicineCount(medicineBox.getMedicineCount());
        orderedBoxes.add(orderedBox);
    }
    medicineOrder.setBoxes(orderedBoxes);
    model.addAttribute("medicineOrder", medicineOrder);

    return WebPages.MEDICINE_DETAIL.toString();
}

2. 修正Thymeleaf模板代码 #

移除所有和th:field同时使用的手动th:value配置，th:field会自动读取后端预填的绑定对象值，渲染出正确的输入框value。如果boxNumber不需要用户修改，可以给输入框加readonly属性防止前端篡改。
修改后的表单核心代码：

<form th:action="@{/mvc/medicine/sell}" th:object="${medicineOrder}" method="post">
    <!-- 药品ID隐藏域，th:field自动读取预填的medicineId渲染value -->
    <input type="hidden" th:field="*{medicineId}" />

    <table class="table">
        <tr th:each="medicineBox, stat : ${medicine.medicineBoxes}">
            <td class="text-center">
                <!-- 移除手动th:value，th:field自动读取预填的boxNumber值 -->
                <input type="text" th:field="*{boxes[__${stat.index}__].boxNumber}" class="form-control" readonly />
            </td>
            <td class="text-center" th:text="${medicineBox.medicineCount}"></td>
            <td>
                <input type="number" th:field="*{boxes[__${stat.index}__].medicineCount}" class="form-control" min="1" />
            </td>
        </tr>
        <tr>
            <td colspan="3">
                <button type="submit" class="btn btn-primary">提交售药订单</button>
            </td>
        </tr>
    </table>
</form>

3. 确认POST接口绑定规则 #

现有POST接口写法基本可用，需额外确认两个配置：

• OrderedBox类必须提供公开的无参构造方法，Spring MVC通过反射创建集合元素实例时依赖无参构造
• 不要在POST方法内部重新newMedicineOrder对象，直接使用@ModelAttribute注解注入的参数实例即可

特殊场景说明：如果不想在后端预初始化集合，也可以放弃th:field，手动编写input的name属性为boxes[0].boxNumber这类符合Spring MVC绑定规则的格式，同时手动渲染value属性。但这种方式容易出现name拼写错误、索引不连续等问题，不推荐使用，优先选择后端预初始化绑定对象的方案，符合Thymeleaf的设计逻辑，绑定稳定性更高。

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