SpringBoot传递值为List的HashMap到视图触发无法渲染错误页如何解决

数据老陈

2026-10-3

错误触发原因

模板变量引用错误：Controller层往Model中存入的HashMap键名为userWithPost，但Thymeleaf模板里直接引用了不存在的变量getUserWithPost，且没有遍历Map结构就直接调用.value属性，直接触发模板解析失败。
视图解析器配置冲突：堆栈信息显示程序尝试解析post.jsp文件，但你使用Thymeleaf作为视图层技术，说明项目依赖或配置同时存在JSP和Thymeleaf的视图解析规则，优先级配置错误导致程序找错了模板文件。
提示中的response has already been committed属于次生错误：模板解析抛出异常时，HTTP响应头已经部分写入返回给客户端，服务器无法重置响应输出错误页，不需要单独处理，解决前两个问题后会自动消失。

修复方案

1. 修正Thymeleaf模板遍历逻辑

先遍历HashMap的键值对，再遍历每个value对应的List数据，修改后的模板代码如下：

<!-- 先遍历userWithPost这个HashMap的所有键值对 -->
<div th:each="postEntry: ${userWithPost}">
  <!-- 再遍历每个value对应的List<ProfileJoin>集合 -->
  <div th:each="getData: ${postEntry.value}">
    <span th:text="${getData.username}"></span>
    <span th:text="${getData.post}"></span>
  </div>
</div>

2. 修正视图解析配置

如果你用的是Spring Boot项目，按如下检查配置：

检查项目依赖，移除不需要的JSP支持包，比如Maven的tomcat-embed-jasper依赖，避免和Thymeleaf的解析逻辑冲突。
在application.properties中确认Thymeleaf的基础配置正确：

spring.thymeleaf.mode=HTML
spring.thymeleaf.prefix=classpath:/templates/
spring.thymeleaf.suffix=.html
spring.thymeleaf.cache=false
# 配置Thymeleaf解析器优先级最高
spring.thymeleaf.order=0