Thymeleaf页面无法访问Controller传递的listStudent属性

控制器层排查点 #

• 核对传值键名拼写：无论是用Model、ModelMap还是request.setAttribute()传值，存入的键名必须严格为listStudent，大小写完全匹配，避免出现liststudent、studentList这类拼写偏差。
• 核对方法注解与返回逻辑：如果控制器类加的是@RestController注解，所有方法默认返回JSON文本，不会走视图解析流程，自然无法传递模型属性到页面，返回视图的控制器必须使用@Controller注解；同时确认方法没有返回redirect:前缀的重定向路径，普通重定向会清空request域中的属性，确需重定向传值要使用RedirectAttributes的addFlashAttribute方法存值。
• 核对视图映射关系：确认方法配置的访问路径、返回的视图名正确，没有被拦截器拦截跳转、没有命中其他同名视图，确保最终渲染的就是你编写的目标index页面。
• 断点确认值本身有效：在控制器方法返回视图前打debug断点，确认listStudent集合本身不是null，集合内确实有查询到的数据，避免因为业务逻辑查询无结果导致前端拿不到有效值。

Thymeleaf配置与页面写法排查点 #

• 核对Thymeleaf基础配置：确认项目已正确引入Thymeleaf依赖，配置文件中Thymeleaf的视图前缀（默认classpath:/templates/）、后缀（默认.html）配置正确，开发阶段可以把spring.thymeleaf.cache设为false，避免缓存导致修改不生效。
• 核对页面命名空间：index.html的根html标签必须添加Thymeleaf命名空间声明：<html xmlns:th="http://www.thymeleaf.org">，缺少命名空间时所有Thymeleaf语法不会被引擎解析。
• 核对取值语法：遍历列表的标准写法为th:each="student : ${listStudent}"，直接输出属性的写法为th:text="${listStudent}"或者内联写法[[${listStudent}]]，注意不要漏写${}包裹，不要把属性名写在表达式外面。
• 核对作用域匹配：如果你是把listStudent存在session域中，取值时必须写${session.listStudent}，直接写${listStudent}默认仅会从request域查找，找不到对应属性就会返回空值。
• 核对版本兼容性：如果使用SpringBoot3及以上版本，确保引入的Thymeleaf starter版本和SpringBoot主版本匹配，版本不兼容也会出现属性解析异常。

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