Thymeleaf同一标签th:each与th:replace联用异常求助

问题根源 #

你遇到的空指针是因为th:replace会完全替换掉它所在的元素——包括承载th:each的那个<td>标签。这会导致Thymeleaf的迭代逻辑（th:each）还没完成变量传递，就把原元素连同上下文变量一起移除了，最终cellFragment拿到的是空值，触发空指针。

而用th:insert时，片段是插入到原<td>内部，所以原<td>会被保留，导致最终HTML里出现嵌套的<td>，不符合需求。

解决方案：用th:block承载迭代逻辑 #

Thymeleaf的<th:block>是虚拟容器，只用来承载属性（比如th:each），不会被渲染到最终HTML中。把th:each移到这个虚拟容器上，再在内部调用th:replace，就能同时满足迭代需求和避免多余标签：

<tr th:fragment="rowFragment(rowObject)">
    <!-- 用虚拟容器承载迭代，不会生成额外HTML标签 -->
    <th:block th:each="cellObject : ${rowObject.getCellObjects()}">
        <!-- 调用cellFragment，直接替换为目标<td> -->
        <th:block th:replace="~{::cellFragment(${cellObject})}"></th:block>
    </th:block>
</tr>

额外检查点 #

确保你的cellFragment片段定义的参数名和传递的一致，比如：

<td th:fragment="cellFragment(cellObject)">
    <!-- 单元格内容示例：[[${cellObject.content}]] -->
</td>

如果参数名不匹配（比如片段里写的是item而不是cellObject），也会导致传递空值触发异常。

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