Thymeleaf 中 th:each 无法渲染 List 或 String[]，表面是语法问题，实则是 Spring MVC 模型生命周期理解偏差——Model 仅在单次请求内有效，重定向（如从 result.html 返回 home.html）会丢失原始模型数据，导致 ${files} 为 null 或空。
thymeleaf 中 `th:each` 无法渲染 `list
在您提供的代码中，Thymeleaf 模板语法本身完全正确：
<tr th:each="file : ${files}">
<td>
<a th:href="@{/file/{file}(file = ${file})}" class="btn btn-success">View</a>
<a th:href="@{/file/delete/{file}(file = ${file})}" class="btn btn-danger">Delete</a>
</td>
<td th:text="${file}">ExampleFile.txt</td>
</tr>该写法对 List
? 根本原因分析
您的控制器流程如下：
@PostMapping("/upload")
public String handleFileUpload(...) {
fileService.addFile(..., model); // ✅ 此时 model.addAttribute("files", ...) 成功执行
return "result"; // ➜ 渲染 result.html（单次请求，model 有效）
}关键在于：result.html 中的返回链接（如 here）是一个纯前端跳转（GET 请求），它不会携带上一次请求的 Model 数据。当浏览器访问 /home 时，若对应控制器方法未显式重新查询并填充 model.addAttribute("files", ...)，则 ${files} 在 Thymeleaf 中即为 null —— 导致 th:each 迭代器无数据可遍历，整个
⚠️ 注意：Model 不是会话级或客户端存储的对象。它仅绑定到当前 HTTP 请求响应周期，无法跨重定向存活。这是初学者最常见的认知盲区。
✅ 正确解决方案：确保 /home 端点主动加载数据
您必须为 home.html 对应的控制器方法（例如 @GetMapping("/home")）独立填充 files 数据：
@GetMapping("/home")
public String showHome(Model model) {
Authentication auth = SecurityContextHolder.getContext().getAuthentication();
String userName = auth.getName();
User user = userMapper.getUser(userName);
Integer userId = user.getUserId();
// ✅ 关键：在此处重新查询并添加 files
List<String> fileList = fileMapper.getFilesByUserId(userId);
model.addAttribute("files", fileList); // 可直接传 List，无需 toArray()
return "home";
}同时，将 result.html 中的返回链接改为服务端重定向（推荐），以强制触发 /home 控制器逻辑：
<!-- ❌ 错误：前端跳转，无模型 -->
<a href="/home">here</a>
<!-- ✅ 正确：服务端重定向，触发 /home 控制器 -->
<a th:href="@{/home}">here</a>
<!-- 或使用 POST-redirect-GET 模式（更健壮） -->? 提示：若您使用 return "redirect:/home"，则需确保 /home 的 @GetMapping 方法已如上实现数据加载。
? 其他优化建议
-
避免 toArray(new String[0])：Thymeleaf 完全支持 List
，直接传递 List 更安全、语义更清晰； -
增加空值防护：在模板中加入判空逻辑，提升健壮性：
<tbody th:if="${not #lists.isEmpty(files)}"> <tr th:each="file : ${files}"> <!-- ... --> </tr> </tbody> <tbody th:unless="${not #lists.isEmpty(files)}"> <tr><td colspan="2" class="text-center text-muted">No files uploaded yet.</td></tr> </tbody> - 启用 Thymeleaf 调试模式：在 application.properties 中添加 spring.thymeleaf.cache=false 和 logging.level.org.thymeleaf=DEBUG，便于排查表达式求值过程。
✅ 总结
| 问题现象 | th:each 不渲染任何 |
|---|---|
| 真实原因 | Model 未在 /home 请求中重新填充，而非 Thymeleaf 语法或集合类型错误 |
| 核心原则 | Spring MVC 的 Model 是 request-scoped，重定向 = 新请求 = 新 Model |
| 修复动作 | 为 @GetMapping("/home") 显式查询数据并 addAttribute("files", ...) |
只要确保目标视图对应的控制器方法负责准备其所需全部模型数据，Thymeleaf 的迭代语法将稳定工作于任意 Iterable 或数组类型。
