Thymeleaf th:each结合href不生效，无法渲染数据求助

刚上手Thymeleaf遇到这种渲染问题太正常了，我帮你梳理几个必查的关键点，按顺序排查应该能快速定位问题：

1. 先检查HTML页面的Thymeleaf命名空间（最容易忽略的基础） #

所有Thymeleaf专属标签（比如th:each）要生效，必须在页面的<html>标签里声明命名空间，否则Thymeleaf会直接忽略这些标签，自然不会出现在最终的页面源码里。请确认你的HTML开头是这样的：

<html xmlns:th="http://www.thymeleaf.org">

2. 确认控制器返回的是Thymeleaf解析的视图 #

如果是Spring Boot项目，默认会从src/main/resources/templates/目录加载Thymeleaf页面。检查你的showHome方法返回值是不是"home"（不带.html后缀），同时确保home.html确实在templates目录下——要是放到static目录里，Spring会直接返回静态文件，Thymeleaf根本不会处理里面的标签。

3. 核对Model属性名与Thymeleaf变量名的一致性 #

比如你在控制器里是这么把数据放到Model里的：

model.addAttribute("categories", categoryList);

那HTML里的循环必须严格对应这个属性名，不能写错大小写或拼写，而且Thymeleaf的循环语法是用冒号:，不是in：

<!-- 正确写法 -->
<a th:each="category : ${categories}" 
   th:text="${category.name}" 
   th:href="@{/category/{id}(id=${category.id})}">
</a>

要是变量名拼错（比如写成categorys）或者用了in代替:，Thymeleaf会判定循环无效，直接跳过整个块。

4. 验证DAO初始化的数据是否真的存在 #

很多时候问题出在数据本身是空的！在控制器的showHome方法里加个调试输出，看看你拿到的categories是不是空列表：

List<Category> categories = categoryDaoImpl.getCategories();
System.out.println("当前分类数量：" + categories.size()); // 控制台看看输出是不是0
model.addAttribute("categories", categories);

如果输出是0，那循环自然不会生成任何元素，源码里也就看不到对应的<a>标签。这时候要回头检查categoryDaoImpl里的初始化逻辑，比如是不是没把数据正确添加到列表中。

5. 检查Thymeleaf依赖/配置（针对非Spring Boot项目） #

如果你是普通Spring项目，要确保已经正确配置了Thymeleaf的视图解析器，并且引入了正确的依赖。比如Spring XML配置里要包含这些：

<bean id="templateResolver" class="org.thymeleaf.templateresolver.ServletContextTemplateResolver">
    <property name="prefix" value="/WEB-INF/templates/"/>
    <property name="suffix" value=".html"/>
    <property name="templateMode" value="HTML"/>
</bean>
<bean id="templateEngine" class="org.thymeleaf.spring5.SpringTemplateEngine">
    <property name="templateResolver" ref="templateResolver"/>
</bean>
<bean class="org.thymeleaf.spring5.view.ThymeleafViewResolver">
    <property name="templateEngine" ref="templateEngine"/>
</bean>

同时Maven/Gradle里要引入thymeleaf-spring5等相关依赖包。

6. 排除Bootstrap的干扰（可能性较低） #

虽然你用了Bootstrap4，但你说连源码都看不到，样式隐藏的概率很低。不过要是前面的检查都没问题，可以暂时注释掉Bootstrap的CSS/JS，验证是不是框架样式导致元素被隐藏（但这种情况元素还是会出现在源码里，只是看不到而已）。

按这个顺序排查，大概率能找到问题所在——新手遇到的这类问题90%以上都是基础配置或拼写错误~

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