Thymeleaf 中 th:each 无法渲染 List 或 String[]，根本原因并非语法错误，而是模型数据未正确传递至目标模板——用户从 result.html 跳转回 home.html 时未触发后端控制器，导致 model.addAttribute("files", ...) 的数据丢失。
thymeleaf 中 `th:each` 无法渲染 `list
在 Spring Boot + Thymeleaf 应用中，一个常见却极易被忽视的误区是：混淆前端跳转与服务端模型渲染的边界。你提供的代码中，handleFileUpload 控制器方法确实向 Model 添加了 files 属性（model.addAttribute("files", fileMapper.getFilesByUserId(userId).toArray(new String[0]));），且调试器确认该值存在——但这仅保证 result.html 视图能访问该数据。而关键问题出在后续流程：
当用户上传成功后，return "result"; 渲染的是 result.html；页面中类似 here 的纯前端跳转（GET 请求）并不会重新执行任何控制器逻辑，也不会自动重建或携带之前的 Model。此时浏览器直接请求 /home，若该路径未配置对应控制器方法（或控制器未重新查询并填充 files），则 home.html 中的 ${files} 表达式求值为 null，th:each 自然不执行，表格为空。
✅ 正确做法：确保每次渲染 home.html 前，都通过控制器加载所需数据。
例如，为 /home 添加明确的 GET 处理方法：
@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();
// 重新查询文件列表并注入 Model
List<string> fileList = fileMapper.getFilesByUserId(userId);
model.addAttribute("files", fileList); // ✅ 推荐传 List，无需 toArray()
return "home"; // 渲染 home.html
}</string>
同时，修正 result.html 中的返回链接，使其指向该受控端点（而非静态路径）：
<!-- result.html 中 -->
<a href="@%7B/home%7D" id="aResultSuccess">here</a>
<!-- 或更稳妥地使用 th:href（确保 URL 构建正确） -->
<a th:href="@{/home}" id="aResultSuccess">here</a>
⚠️ 注意事项：
-
th:each 语法本身完全正确：
对 List 和 String[] 均兼容，无需额外转换。 - 避免“假性复用”模型：HTTP 是无状态协议，Model 仅在单次请求响应周期内有效，不会跨请求持久化（除非显式使用 @SessionAttributes 或 RedirectAttributes，但此处不适用）。
- 命名一致性：检查模板中引用的变量名是否与 addAttribute() 一致（如 files vs filess —— 你模板中存在
，这显然是拼写错误，应统一为 files）。 - 空值防护（推荐）：在模板中添加判空逻辑，提升健壮性：
<tbody th:if="${not #lists.isEmpty(files)}"><tr th:each="file : ${files}"> <td> <a target="_blank" class="btn btn-success" th:href="@{/file/{file}(file=${file})}">View</a> <a class="btn btn-danger" th:href="@{/file/delete/{file}(file=${file})}">Delete</a> </td> <td th:text="${file}">ExampleFile.txt</td> </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 渲染失败的根因几乎总是服务端数据供给缺失，而非模板语法问题。牢记 “每个视图渲染必须由对应的控制器方法驱动，并主动填充其所需模型属性”。将 /home 端点交由控制器统一管理，即可彻底解决列表不显示的问题。
