Spring Boot+Thymeleaf（Tomcat9）应用HTML页面渲染截断问题求助

嘿，我之前在部署Spring Boot+Thymeleaf到Tomcat9的时候也碰到过类似的页面截断问题，咱们一步步来排查解决：

1. 先排除静态页面的基础问题 #

首先把你的HTML页面移到Spring Boot的src/main/resources/static目录下（而不是templates目录），直接通过URL访问这个静态文件。如果访问后内容完整，那问题肯定出在Thymeleaf的模板解析环节；如果还是截断，那就要看Tomcat的配置或者服务器环境的问题了。

2. 排查Thymeleaf相关配置 #

如果静态页面正常，那重点检查Thymeleaf的设置：

• 确认依赖版本匹配：确保Spring Boot Starter Thymeleaf的版本和你的Spring Boot版本兼容（比如Spring Boot 2.x对应Thymeleaf 3.x），Tomcat9对Thymeleaf 3.x是完全支持的。
• 调整Thymeleaf核心配置：在application.properties里添加/修改这些配置：

  # 用标准HTML5模式解析，避免兼容性问题
  spring.thymeleaf.mode=HTML5
  # 确保编码统一，避免乱码或解析截断
  spring.thymeleaf.encoding=UTF-8
  spring.thymeleaf.servlet.content-type=text/html;charset=UTF-8
  # 先关闭缓存，排除缓存导致的旧模板残留问题
  spring.thymeleaf.cache=false
  

• 如果用了LEGACYHTML5模式：如果你需要兼容非严格HTML，配置了spring.thymeleaf.mode=LEGACYHTML5，必须引入对应的依赖，否则会导致解析异常截断：

  <dependency>
      <groupId>org.unbescape</groupId>
      <artifactId>unbescape</artifactId>
  </dependency>
  <dependency>
      <groupId>net.sourceforge.nekohtml</groupId>
      <artifactId>nekohtml</artifactId>
  </dependency>
  

3. 检查Tomcat的输出配置 #

如果静态页面也截断，那就要调整Tomcat的缓冲区设置：

• 打开Tomcat的conf/server.xml，找到HTTP Connector节点，修改缓冲区大小并临时关闭压缩测试：

  <Connector port="8080" protocol="HTTP/1.1"
             connectionTimeout="20000"
             redirectPort="8443"
             bufferSize="32768" <!-- 增大缓冲区，默认是8192 -->
             compression="off"/> <!-- 先关闭压缩，排除压缩逻辑导致的截断 -->
  

• 查看Tomcat的logs/catalina.out日志，看看有没有输出流异常（比如Broken pipe、IOException），这些日志能帮你定位具体的IO问题。

4. 排查控制器代码问题 #

检查你的Spring Boot控制器，确保没有手动操作响应流导致提前截断：

• 不要在控制器方法里写类似这样的代码：

  response.getWriter().write("Coff");
  response.getWriter().flush();
  response.getWriter().close();
  

  正确的做法是返回模板名称（比如return "index";），让Thymeleaf自动完成渲染和输出。

最后补充一个细节 #

别忘了在HTML页面的<head>里加上编码声明，避免编码不匹配导致的解析异常：

<meta charset="UTF-8">

按照这个步骤排查，应该能解决页面截断的问题。

内容的提问来源于stack exchange，提问作者6nagi9