Spring Boot War包CMD启动遇Thymeleaf模板解析错误，IDE运行正常

以下是针对该问题的具体排查和解决步骤：

• 检查War包内的模板资源是否正确打包
  解压你的War包，查看WEB-INF/classes目录下是否存在你配置的模板文件夹。比如你设置spring.thymeleaf.prefix=classpath:/templates/custom/，就需要确认classes/templates/custom目录存在，且里面包含对应的.html模板文件。
  如果模板不在默认的src/main/resources目录下，需要修改构建脚本确保资源被打包：

  • Maven项目在pom.xml中添加资源配置：

    <build>
        <resources>
            <resource>
                <directory>src/main/resources</directory>
            </resource>
            <!-- 假设模板放在src/main/templates目录 -->
            <resource>
                <directory>src/main/templates</directory>
                <includes>
                    <include>**/*.html</include>
                </includes>
            </resource>
        </resources>
    </build>
    

  • Gradle项目在build.gradle中添加：

    sourceSets {
        main {
            resources {
                srcDirs = ["src/main/resources", "src/main/templates"]
            }
        }
    }
    

• 确认prefix配置格式正确
  确保spring.thymeleaf.prefix的路径结尾带有斜杠，比如正确写法是spring.thymeleaf.prefix=classpath:/templates/custom/。如果缺少末尾斜杠，Thymeleaf会错误拼接模板路径（比如把custom和模板名直接连在一起，变成customindex.html而非custom/index.html）。
  同时要确认生产环境加载的是正确的配置文件，避免打包时使用了未修改prefix的配置。启动War包时可以指定配置文件：

  java -jar your-app.war --spring.config.location=classpath:/application-prod.properties
  

• 检查模板文件的读取权限
  在Linux/Unix环境下，打包后的模板文件可能存在权限问题导致无法读取。可以解压War包后，执行以下命令设置权限：

  chmod -R 644 /path/to/war-unpacked/WEB-INF/classes/templates/
  

• 临时用绝对路径验证问题
  可以临时将prefix改为本地绝对路径进行测试，比如：

  spring.thymeleaf.prefix=file:/opt/your-app/templates/
  

  将模板文件放到该目录后启动War包，如果能正常解析，说明问题出在classpath资源的打包或读取上，再针对性调整。

• 排查版本兼容性问题
  确保Spring Boot和Thymeleaf版本兼容，比如Spring Boot 2.x需要搭配Thymeleaf 3.x版本，版本不匹配可能导致资源加载逻辑异常。

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