Spring Boot打包WAR部署外部Tomcat后Thymeleaf模板无法解析求助

针对你遇到的TemplateInputException，以下是几个可行的排查和解决步骤：

1. 显式配置Thymeleaf模板路径 #

在application.properties或application.yml中明确指定模板前缀和后缀，避免外部Tomcat环境下资源路径的自动识别偏差：

# application.properties
spring.thymeleaf.prefix=classpath:/templates/
spring.thymeleaf.suffix=.html
spring.thymeleaf.mode=HTML
spring.thymeleaf.cache=false # 开发环境关闭缓存，方便调试

2. 验证主应用类的configure方法实现 #

确保继承SpringBootServletInitializer的主类正确配置Spring应用上下文，避免因上下文加载不全导致模板解析器初始化异常：

@SpringBootApplication
public class YourApplication extends SpringBootServletInitializer {

    @Override
    protected SpringApplicationBuilder configure(SpringApplicationBuilder application) {
        // 传入当前主类作为配置源
        return application.sources(YourApplication.class);
    }

    public static void main(String[] args) {
        SpringApplication.run(YourApplication.class, args);
    }
}

3. 确认Maven打包的资源配置 #

检查pom.xml的资源过滤配置，确保templates目录下的所有文件被正确打包到WEB-INF/classes中：

<build>
    <resources>
        <resource>
            <directory>src/main/resources</directory>
            <includes>
                <include>**/*</include>
            </includes>
            <filtering>false</filtering> <!-- 禁止过滤模板文件，避免内容被篡改 -->
        </resource>
    </resources>
    <!-- 保持原有的WAR打包配置 -->
    <plugins>
        <plugin>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-maven-plugin</artifactId>
        </plugin>
    </plugins>
</build>

4. 排查类加载冲突 #

确保spring-boot-starter-tomcat的scope为provided，避免与外部Tomcat的内置Tomcat库冲突，影响Thymeleaf的类加载：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-tomcat</artifactId>
    <scope>provided</scope>
</dependency>

5. 启用调试日志定位问题 #

添加日志配置，查看Thymeleaf实际的模板查找路径，确认是否与实际文件路径匹配：

logging.level.org.thymeleaf=DEBUG
logging.level.org.springframework.web.servlet.view=DEBUG

启动Tomcat后，日志中会输出类似Looking for template with name 'xxx' in locations [classpath:/templates/]的信息，可据此判断路径是否正确。

6. 检查模板文件的命名与路径 #

确保控制器返回的模板名称与实际文件完全一致（注意大小写，Linux环境下Tomcat区分文件名大小写），例如控制器返回"home"，则模板文件必须是src/main/resources/templates/home.html。

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