本文详解如何正确使用 Thymeleaf 的 th:block 元素结合 th:each 与状态变量，优雅渲染多层嵌套 Map（如 Map>>）为结构化 HTML 表格，避免标签闭合错误与语义混乱。

本文详解如何正确使用 thymeleaf 的 `th:block` 元素结合 `th:each` 与状态变量，优雅渲染多层嵌套 map（如 `map>>`）为结构化 html 表格，避免标签闭合错误与语义混乱。

在 Thymeleaf 模板中，th:block 是一个逻辑容器标签——它本身不生成任何 HTML 输出，仅用于包裹、分组或条件控制内容，是处理复杂迭代与条件逻辑的理想工具。但其使用需严格遵循 XML/HTML 规范：每个 必须有明确的闭合标签 ，且内部不能出现非法嵌套（如在 中直接插入未闭合的 并试图用它“拆分” 开闭标签）。

你遇到的两个错误均源于对 th:block 作用域和 HTML 结构约束的理解偏差：

• ❌ 错误一： 内部尝试手动拼接 开闭标签（如 .........），导致解析器无法识别合法的标签层级；
• ❌ 错误二：在闭合标签上附加 th:if（如
th:if="...">），Thymeleaf 不支持修饰结束标签，语法非法。

✅ 正确解法是：让每一行 完整独立生成，通过 th:if 控制单元格内容是否显示（而非控制标签存在），利用 *Stat 状态对象（如 subMapItemStat.count == 1）判断是否为子 Map 的首项，从而决定是否填充“主键列”。

以下是推荐的、可直接运行的模板写法（适配你的三层嵌套结构）：

Map Name	Sub Name	Now	Past	Future
First		time	now_value	past_value	future_value

? 关键要点说明：

• th:each="mapEntry : ${result}" 遍历外层 Map，mapEntry.key 即 "First"/"Second"；
• th:each="subMapEntry : ${mapEntry.value}" 遍历中层 Map，subMapEntry.key 即 "time"/"sleifj"；
• subMapEntryStat.count == 1 表示当前是该 mapEntry 下的第一个子项（Thymeleaf 索引从 1 开始），此时才渲染主键列；其余行留空（用   或空字符串保持对齐）；
• 使用 ?: '' 提供默认值，防止 get() 返回 null 导致渲染异常；
• 仅作为逻辑分组容器，不干扰 的完整性，完全符合 HTML 标准。

  ? 进阶建议：
  若需合并单元格（如让 "First" 跨越其下所有子项行），可改用 rowspan 属性 + 动态计算子 Map 大小（#maps.size(mapEntry.value)），但这需额外逻辑判断，基础场景推荐上述简洁方案。

  总结：th:block 是 Thymeleaf 的“隐形胶水”，善用它可解耦结构与逻辑，但绝不可替代语义化标签。牢记——HTML 结构必须合法，Thymeleaf 指令只是内容的智能注入器。