本文详解如何正确配置 spring boot test，使 thymeleaf 模板在单元测试中能被正常解析，关键在于显式启用 thymeleaf 自动配置类，而非仅加载业务 bean。
本文详解如何正确配置 spring boot test，使 thymeleaf 模板在单元测试中能被正常解析，关键在于显式启用 thymeleaf 自动配置类，而非仅加载业务 bean。
在 Spring Boot 应用中，ThymeleafProcessor 这类服务依赖 TemplateEngine 完成模板渲染，而 TemplateEngine 的完整功能（尤其是模板解析器、资源定位、缓存策略等）由 ThymeleafAutoConfiguration 自动装配。该配置类默认通过 @EnableAutoConfiguration（由 @SpringBootApplication 隐含）触发——但在单元测试中，若仅手动指定 @SpringBootTest(classes = {ThymeleafProcessor.class, TemplateEngine.class})，Spring 将跳过所有自动配置，导致 TemplateEngine 缺失必要的 SpringResourceTemplateResolver，最终 templateEngine.process("test.html", context) 仅返回原始模板路径字符串（如 "test.html"），而非渲染后的内容。
✅ 正确做法是：保留 @SpringBootTest 的上下文启动能力，并通过 @ImportAutoConfiguration 显式引入 ThymeleafAutoConfiguration，从而复现生产环境的完整 Thymeleaf 基础设施。同时，应避免冗余声明（如手动注册 TemplateEngine 或添加无必要的 @EnableConfigurationProperties）。
以下是推荐的测试配置：
import org.junit.jupiter.api.Test;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.autoconfigure.thymeleaf.ThymeleafAutoConfiguration;
import org.springframework.boot.test.context.SpringBootTest;
import org.thymeleaf.context.Context;
import static org.junit.jupiter.api.Assertions.assertEquals;
@SpringBootTest(classes = {ThymeleafProcessor.class})
@ImportAutoConfiguration(ThymeleafAutoConfiguration.class)
class ThymeleafProcessorTest {
@Autowired
private ThymeleafProcessor processor;
@Test
void testProcessReturnsRenderedTemplate() {
// 验证模板解析器已正确注入
assertEquals(1, processor.getTemplateEngine().getTemplateResolvers().size());
// 执行渲染
String result = processor.process();
// 断言渲染结果（假设 test.html 内容为 "Hello World"）
assertEquals("Hello World", result);
}
}? 注意事项：
- 模板文件
src/main/resources/templates/test.html必须存在于测试类路径下（通常src/test/resources会自动包含src/main/resources，但建议确认构建工具配置）； - 若使用自定义
TemplateResolver或SpringTemplateEngine配置（如前缀、后缀、缓存开关），需确保application-test.yml或@TestConfiguration中同步配置，否则测试行为可能与运行时不一致； -
@SpringBootTest启动的是完整上下文，适合集成验证；如需更轻量级测试，可考虑使用@ContextConfiguration+@TestConfiguration手动注册最小依赖集，但需自行模拟TemplateResolver，复杂度显著上升，一般不推荐。
综上，核心原则是：让测试上下文尽可能贴近真实运行环境——不是“只加需要的 Bean”，而是“启用需要的自动配置”。@ImportAutoConfiguration 是实现这一目标的简洁、可靠且符合 Spring Boot 设计哲学的方式。
