集成测试中如何自动配置注入含SpringResourceTemplateResolver的SpringTemplateEngine

1. 引入Thymeleaf自动配置类 #

Spring Boot的Thymeleaf自动配置类ThymeleafAutoConfiguration会自动初始化SpringResourceTemplateResolver以及配置正确的SpringTemplateEngine，完全匹配生产环境的配置逻辑。只需在测试中引入该类，替代直接注入SpringTemplateEngine：

@SpringJUnitConfig(classes = [ThymeleafAutoConfiguration::class])
class TemplateServiceIT @Autowired constructor(
    springTemplateEngine: SpringTemplateEngine,
) {
    private val templateService = TemplateService(springTemplateEngine)

    // 示例测试方法
    @Test
    fun `verify template renders correctly`() {
        // 假设src/test/resources/templates下存在sample-template.html
        val renderedContent = templateService.renderTemplate("sample-template", emptyMap())
        // 根据模板预期内容添加断言
        assertTrue(renderedContent.contains("模板中的预期文本"))
    }
}

2. 对齐测试资源路径 #

在src/test/resources下创建templates目录，将测试用的Thymeleaf模板放入其中，保持和生产环境src/main/resources/templates一致的目录结构，确保SpringResourceTemplateResolver能正确定位模板文件。

3. 可选：自定义测试专用配置 #

如果需要针对测试场景调整模板解析规则（比如指定单独的测试模板目录），可以创建测试配置类补充或覆盖自动配置：

@TestConfiguration
class TestThymeleafCustomConfig {
    @Bean
    fun testTemplateResolver(): SpringResourceTemplateResolver {
        val resolver = SpringResourceTemplateResolver()
        resolver.prefix = "classpath:/templates/test/" // 测试模板专属目录
        resolver.suffix = ".html"
        resolver.templateMode = TemplateMode.HTML
        return resolver
    }
}

然后在测试类中同时引入自动配置和自定义测试配置：

@SpringJUnitConfig(classes = [ThymeleafAutoConfiguration::class, TestThymeleafCustomConfig::class])
class TemplateServiceIT {
    // ... 测试逻辑
}

这种配置方式既保证了测试环境与生产环境的模板解析逻辑一致，又无需启动完整的Spring Boot应用，测试更轻量高效。

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