SpringCloud项目Thymeleaf模板解析异常问题求助

• 校验模板文件有效性
  确认src/main/resources/templates/ticketPage/ticketList.html文件存在，路径大小写与代码引用一致（Linux环境严格区分大小写），文件名后缀无误（避免写成.htm或拼写错误）。

• 排查模板语法问题
  打开ticketList.html逐行检查：

  • 标签是否完整闭合，比如<th:block>、<div>等标签无遗漏闭合标签
  • Thymeleaf表达式格式是否正确，${}、*{}、#{}的变量名、方法名无拼写错误
  • 指令属性是否合法，th:if、th:each、th:href等指令无拼写错误，属性值符合语法规范

• 确认依赖版本兼容性
  检查Spring Boot与Thymeleaf版本是否匹配：Spring Boot 2.x对应Thymeleaf 3.x，Spring Boot 3.x对应Thymeleaf 3.1+。查看pom.xml或build.gradle中的依赖配置，避免版本冲突。

• 查看完整异常栈信息
  当前仅显示顶层异常，需查看控制台中TemplateInputException下方的具体异常信息（如NullPointerException、ExpressionEvaluationException），这些细节能直接定位问题根源。

• 检查模板加载配置
  确认项目Thymeleaf配置正确，默认情况下Spring Boot自动加载src/main/resources/templates下的模板，若自定义配置需核对application.yml或application.properties：

  spring:
    thymeleaf:
      prefix: classpath:/templates/
      suffix: .html
  

  确保prefix和suffix未错误覆盖默认路径。

• 清理缓存并重构项目
  执行mvn clean install（Maven）或gradle clean build（Gradle），清理旧编译文件与缓存后重新构建，缓存损坏也可能引发模板加载异常。

内容的提问来源于stack exchange，提问作者wanshun zhong