本文详解如何正确使用 Thymeleaf 的 th:block 元素结合 th:each 与状态变量，优雅渲染多层嵌套 Map（如 Map）为结构化 HTML 表格，避免标签闭合错误与语义混乱。
本文详解如何正确使用 thymeleaf 的 `th:block` 元素结合 `th:each` 与状态变量，优雅渲染多层嵌套 map（如 `map
在 Thymeleaf 模板中，th:block 是一个逻辑容器标签——它本身不生成任何 HTML 输出，仅用于包裹、分组或条件控制内容，是处理复杂迭代与条件逻辑的理想工具。但其使用需严格遵循 XML/HTML 规范：每个 <block></block> 必须有明确的闭合标签 ，且内部不能出现非法嵌套（如在 <tr> 中直接插入未闭合的 <code><block></block> 并试图用它“拆分” <tr> 开闭标签）。<p>你遇到的两个错误均源于对 <code>th:block 作用域和 HTML 结构约束的理解偏差：
- ❌ 错误一：
<block></block>内部尝试手动拼接<tr> 开闭标签（如 <code><tr>...<block>...</block>...</tr>），导致解析器无法识别合法的标签层级； - ❌ 错误二：在闭合标签上附加
th:if（如
th:if="...">），Thymeleaf 不支持修饰结束标签，语法非法。
✅ 正确解法是：让每一行 以下是推荐的、可直接运行的模板写法（适配你的三层嵌套结构）： ? 关键要点说明：<tr> 完整独立生成，通过 <code>th:if 控制单元格内容是否显示（而非控制标签存在），利用 *Stat 状态对象（如 subMapItemStat.count == 1）判断是否为子 Map 的首项，从而决定是否填充“主键列”。<table border="1" class="table">
<thead>
<tr>
<th>Map Name</th>
<th>Sub Name</th>
<th>Now</th>
<th>Past</th>
<th>Future</th>
</tr>
</thead>
<tbody>
<!-- 外层遍历：First, Second -->
<th:block th:each="mapEntry : ${result}">
<!-- 中层遍历：time, sleifj -->
<tr th:each="subMapEntry : ${mapEntry.value}">
<!-- 主键列：仅第一行显示 mapEntry.key（如 "First"），后续空置 -->
<td th:if="${subMapEntryStat.count == 1}" th:text="${mapEntry.key}">First</td>
<td th:unless="${subMapEntryStat.count == 1}"> </td>
<!-- 子键列：始终显示 subMapEntry.key（如 "time"） -->
<td th:text="${subMapEntry.key}">time</td>
<!-- 内层值列：从 subMapEntry.value（即第三层 Map）中提取 -->
<td th:text="${subMapEntry.value.get('now') ?: ''}">now_value</td>
<td th:text="${subMapEntry.value.get('past') ?: ''}">past_value</td>
<td th:text="${subMapEntry.value.get('future') ?: ''}">future_value</td>
</tr>
</th:block>
</tbody>
</table>
th:each="mapEntry : ${result}" 遍历外层 Map<string map></string>，mapEntry.key 即 "First"/"Second"；th:each="subMapEntry : ${mapEntry.value}" 遍历中层 Map<string map></string>，subMapEntry.key 即 "time"/"sleifj"；subMapEntryStat.count == 1 表示当前是该 mapEntry 下的第一个子项（Thymeleaf 索引从 1 开始），此时才渲染主键列；其余行留空（用 或空字符串保持对齐）；?: '' 提供默认值，防止 get() 返回 null 导致渲染异常；<block></block> 仅作为逻辑分组容器，不干扰 <tr> 的完整性，完全符合 HTML 标准。<p>? <strong>进阶建议：</strong><br>
若需合并单元格（如让 <code>"First" 跨越其下所有子项行），可改用 rowspan 属性 + 动态计算子 Map 大小（#maps.size(mapEntry.value)），但这需额外逻辑判断，基础场景推荐上述简洁方案。
总结：th:block 是 Thymeleaf 的“隐形胶水”，善用它可解耦结构与逻辑，但绝不可替代语义化标签。牢记——HTML 结构必须合法，Thymeleaf 指令只是内容的智能注入器。
