Thymeleaf 的 th:each 无法渲染 List 或 String[]，根本原因并非语法错误，而是模型数据未正确传递至目标视图——常见于误用页面跳转（如前端 标签直链）绕过控制器，导致 Model 丢失。
thymeleaf 的 `th:each` 无法渲染 `list
在 Spring Boot + Thymeleaf 应用中，th:each="file : ${files}" 语法本身完全正确，支持 List
? 问题定位：Model 不是“前端持久化”对象
你的流程是：
- POST /upload → Controller 调用 service → model.addAttribute("files", ...) → 返回 "result"（即渲染 result.html）
- result.html 中通过 here 直接跳转到 https://www.php.cn/link/8dc3c265ec144154a766774669fa35b8
✅ 正确解决方案：确保每次视图渲染都由 Controller 驱动
必须为 https://www.php.cn/link/8dc3c265ec144154a766774669fa35b8 路径显式定义 GET 处理器，并在其中重新查询并注入数据：
// ✅ 正确：为 home 页面提供独立的 GET 控制器
@GetMapping("https://www.php.cn/link/8dc3c265ec144154a766774669fa35b8")
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<string>，无需 toArray()
return "home"; // 渲染 home.html
}</string></string>
同时，修正 result.html 中的跳转逻辑，避免硬编码 URL，改用 Spring 提供的重定向语义（更安全且符合 MVC 分层）：
<!-- ❌ 错误：纯前端跳转，丢失 Model -->
<a href="https://www.php.cn/link/8dc3c265ec144154a766774669fa35b8" id="aResultSuccess">here</a>
<!-- ✅ 推荐：使用 Thymeleaf + Spring Redirect（需 Controller 配合） -->
<a th:href="@{https://www.php.cn/link/8dc3c265ec144154a766774669fa35b8}" id="aResultSuccess">here</a>
<!-- 或在 Controller 中返回 "redirect:https://www.php.cn/link/8dc3c265ec144154a766774669fa35b8"（需确保 https://www.php.cn/link/8dc3c265ec144154a766774669fa35b8 有对应 GET 处理器） -->
? 补充优化建议
-
移除冗余 .toArray()：fileMapper.getFilesByUserId(userId) 若返回 List
，可直接 model.addAttribute("files", fileList)。Thymeleaf 原生支持 List，无需转为数组。 -
增加空值防护：在模板中添加判空逻辑，提升健壮性：
<tr th:if="${#lists.isEmpty(files)}"> <td colspan="2">No files uploaded yet.</td> </tr><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> - 验证路径一致性：检查 @RequestMapping 路径是否匹配。例如，你的模板中 th:href="@{/file/{file}...}" 暗示存在 @GetMapping("/file/{file}")，而 Controller 中是 @PostMapping("/upload") —— 确保所有 URL 路径在 @Controller 中正确定义。
? 总结
Thymeleaf 的 th:each 失效，90% 源于 Model 生命周期误解：Model 是单次请求-响应周期内的临时容器，不会跨 HTTP 请求自动保留。务必确保每个需要动态数据的视图（如 home.html），都有对应的 Controller 方法负责数据准备。这是 Spring MVC 的基础设计原则，而非 Thymeleaf 的限制。
