Thymeleaf 中 th:each 无法渲染 List 或 String[]，表面是语法问题，实则是模型（Model）数据未正确传递至目标视图——根本原因在于 Spring MVC 的 Model 仅在单次请求响应周期内有效，重定向或前端跳转（如 ）不会携带原 Model 数据。
thymeleaf 中 `th:each` 无法渲染 `list
在您的代码中，文件上传成功后返回的是 result.html 视图：
@PostMapping("/upload")
public String handleFileUpload(@RequestParam("fileUpload") MultipartFile file, Model model) throws IOException {
fileService.addFile(SecurityContextHolder.getContext().getAuthentication(), file, model);
return "result"; // ✅ 此时 model 中的 "files" 仅对 result.html 生效
}
而 result.html 中的返回链接为纯前端跳转：
<a href="https://www.php.cn/link/8dc3c265ec144154a766774669fa35b8" id="aResultSuccess">here</a>
该链接触发的是浏览器发起的新 GET 请求（GET https://www.php.cn/link/8dc3c265ec144154a766774669fa35b8），而非服务端重定向。此时 Spring MVC 会调用 @GetMapping("https://www.php.cn/link/8dc3c265ec144154a766774669fa35b8") 对应的控制器方法（您未贴出，但可推断存在），而该方法必须显式向 Model 添加 files 数据，否则 Thymeleaf 模板中 ${files} 为 null 或空集合，导致
✅ 正确做法：使用服务端重定向 + 重查询，或直接返回目标视图
方案一：上传后重定向到 https://www.php.cn/link/8dc3c265ec144154a766774669fa35b8，并在其控制器中重新加载数据（推荐 ✅）
@PostMapping("/upload")
public String handleFileUpload(@RequestParam("fileUpload") MultipartFile file,
RedirectAttributes redirectAttrs) throws IOException {
Authentication auth = SecurityContextHolder.getContext().getAuthentication();
int result = fileService.addFile(auth, file, null); // 不传 Model，改用 RedirectAttributes 传提示信息
if (result > 0) {
redirectAttrs.addFlashAttribute("success", "File uploaded successfully");
}
return "redirect:https://www.php.cn/link/8dc3c265ec144154a766774669fa35b8"; // ? 302 重定向，触发新请求
}
然后确保 https://www.php.cn/link/8dc3c265ec144154a766774669fa35b8 的 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);
List<string> files = fileMapper.getFilesByUserId(user.getUserId());
model.addAttribute("files", files); // ✅ 关键：此处必须重新设置
return "home";
}</string>
? RedirectAttributes.addFlashAttribute() 可跨重定向传递一次性的提示消息（如 success/error），但业务数据（如 files）必须在目标控制器中重新查询并添加——这是 Spring MVC 的设计原则：Model 不跨请求持久化。
方案二：避免跳转，直接返回 home.html（适用于简单场景）
@PostMapping("/upload")
public String handleFileUpload(@RequestParam("fileUpload") MultipartFile file, Model model) throws IOException {
Authentication auth = SecurityContextHolder.getContext().getAuthentication();
fileService.addFile(auth, file, model); // 此处 model 已含 files
return "home"; // ⚠️ 注意：需确保 service 方法不破坏 model 结构
}
此时需调整 addFile 方法，移除对 Model 的依赖（更符合分层职责），改为返回数据供 Controller 统一处理：
// Service 层应专注业务逻辑，不操作 Model
public List<string> addFile(Authentication authentication, MultipartFile multipartFile) throws IOException {
// ... 保存文件逻辑
Integer userId = user.getUserId();
return fileMapper.getFilesByUserId(userId); // ✅ 返回 List，由 Controller 决定如何放入 Model
}</string>
Controller 改写为：
@PostMapping("/upload")
public String handleFileUpload(@RequestParam("fileUpload") MultipartFile file, Model model) throws IOException {
try {
List<string> files = fileService.addFile(
SecurityContextHolder.getContext().getAuthentication(), file);
model.addAttribute("files", files);
model.addAttribute("result", "success");
} catch (Exception e) {
model.addAttribute("result", "error");
model.addAttribute("message", "Upload failed");
}
return "home"; // 直接渲染 home，数据已就绪
}</string>
⚠️ 其他关键注意事项
-
Thymeleaf 迭代语法本身无误：
完全支持 List 和 String[]，无需额外转换。 - 检查模板命名与路径：确认 return "home" 对应的模板文件名为 home.html 且位于 src/main/resources/templates/（或 src/main/webapp/WEB-INF/templates/）。
- 避免重复 tbody：您的 home.html 中存在两个 ，且第二个（th:each="file : ${filess}"）使用了不存在的变量 filess，会导致 Thymeleaf 解析警告或静默失败，请删除冗余代码。
- 启用 Thymeleaf 调试模式：在 application.properties 中添加 spring.thymeleaf.cache=false 和 logging.level.org.thymeleaf=DEBUG，便于排查模板解析问题。
总结
Thymeleaf 的 th:each 不工作，90% 的情况并非语法错误，而是模型数据未在目标视图的请求周期内被正确注入。牢记：
? Model 是 request-scoped 的临时容器，不跨 HTTP 请求存活；
? 前端 跳转 = 新请求 = 新 Model；
? 重定向（redirect:）或转发（forward:）均需目标处理器主动准备数据；
? 最佳实践：Controller 负责组装 Model，Service 专注业务逻辑与数据返回。修复后，您的文件列表将稳定渲染，迭代逻辑可无缝支持任意 Iterable 或数组类型。
