Thymeleaf 的 th:each 不能直接作用于 标签进行迭代渲染，否则会导致模板解析异常或数据不显示；正确做法是使用 作为逻辑容器包裹 ，确保循环逻辑与 HTML 结构语义分离。

thymeleaf 的 `th:each` 不能直接作用于 `

` 标签进行迭代渲染，否则会导致模板解析异常或数据不显示；正确做法是使用 `` 作为逻辑容器包裹 ``，确保循环逻辑与 HTML 结构语义分离。

在 Thymeleaf 模板中，th:each 是一个强大的迭代指令，常用于遍历集合（如 List）并动态生成 HTML 行元素（如表格行 ）。但一个常见误区是：将 th:each 直接写在 标签上，例如：

<tr th:each="data : ${stats}">
<td th:text="${data.country}"></td>
    <td th:text="${data.state}"></td>
    <td th:text="${data.latestTotalCases}">0</td>
</tr>

这种写法看似直观，却可能造成以下问题：

• 数据完全不渲染（空白表格体）；
• 控制台无报错，但服务端日志提示 Could not parse as expression 或 EL evaluation failed；
• 实际原因是 Thymeleaf 对某些 HTML 元素（尤其是表格结构中的 、 等）有严格的嵌套约束，th:each 若直接修饰 ，可能导致解析器误判 DOM 层级或跳过渲染逻辑。

  ✅ 正确解法：使用 作为“无标签占位符”承载迭代逻辑，再在其内部生成语义正确的 ：

  <!-- 表头 -->
  <tr style="background-color: black; color: white">
  <th>Country</th>
      <th>State</th>
      <th>Total Cases</th>
  </tr><!-- 迭代主体：用 th:block 包裹 tr --><block th:each="data : ${stats}"><tr>
  <td th:text="${data.country}">--</td>
          <td th:text="${data.state}">--</td>
          <td th:text="${data.latestTotalCases}">0</td>
      </tr></block>

  ? 关键原理说明：

  • 是 Thymeleaf 提供的逻辑分组标签，它不会输出任何 HTML 元素，仅用于包裹和控制模板逻辑（如 th:each、th:if），完美解决“需要循环但又不能破坏 HTML 结构”的需求；
  • 所有 th:* 属性必须作用于真实或虚拟的 HTML 元素节点，而 正是为此类场景设计的“语法糖”。

  ⚠️ 注意事项：

  • 确保后端 Controller 已正确将数据放入 Model：

    model.addAttribute("stats", statService.getAllStats()); // 返回非 null、非空 List

  • 若仍无数据显示，请检查：
    • stats 是否为 null（Thymeleaf 默认静默忽略 null 集合，建议用 th:if="${not #lists.isEmpty(stats)}" 做空判断）；
    • 实体类 Stat 的 getter 方法是否符合 JavaBean 规范（如 getCountry() 而非 getcountry()）；
    • 模板是否启用 Thymeleaf 标准方言（确认 spring-boot-starter-thymeleaf 已引入且配置未禁用）。

  总结：Thymeleaf 强调“HTML 即模板”，因此必须兼顾语义结构与逻辑表达。放弃对

  的直觉依赖，转而采用 模式，既是最佳实践，也是规避渲染失效的根本方案。