如何让自定义Hibernate FunctionContributor在Spring Boot集成测试中生效

问题核心 #

@DataJpaTest作为切片测试，默认不会自动扫描并注册自定义的FunctionContributor；即使在测试上下文放置META-INF/service配置文件，也可能因classpath加载路径问题失效。以下是两种可靠的解决方式：

方式一：编程式注册（推荐） #

通过HibernatePropertiesCustomizer手动注册自定义FunctionContributor，确保测试上下文能识别到：

1. 创建测试专用的Hibernate配置类：

import org.hibernate.boot.model.FunctionContributor;
import org.springframework.boot.autoconfigure.orm.jpa.HibernatePropertiesCustomizer;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

@Configuration
public class TestHibernateFunctionConfig {

    @Bean
    public HibernatePropertiesCustomizer hibernateFunctionContributorCustomizer(YourAnyInArrayFunctionContributor functionContributor) {
        return hibernateProperties -> 
            hibernateProperties.put(
                "hibernate.boot.model.function_contributors",
                functionContributor
            );
    }
}

注：如果有多个自定义FunctionContributor，可传入List.of(functionContributor1, functionContributor2)

2. 在测试类中导入该配置：

import org.springframework.boot.test.autoconfigure.orm.jpa.DataJpaTest;
import org.springframework.context.annotation.Import;

@DataJpaTest
@Import(TestHibernateFunctionConfig.class)
public class YourRepositoryTest {
    // 测试代码
}

方式二：确保测试资源路径正确 #

如果坚持用SPI方式注册，需将META-INF/service/org.hibernate.boot.model.FunctionContributor文件放到**src/test/resources**目录下（而非主应用的src/main/resources），文件内容为自定义FunctionContributor的全类名：

com.yourpackage.AnyInArrayFunctionContributor

这样测试上下文的classpath才能正确加载到SPI配置。

补充：@SpringBootTest的注意事项 #

若使用@SpringBootTest，需确保测试类能扫描到主应用的启动类：

• 测试类与主启动类处于同一包或子包下
• 或显式指定启动类：@SpringBootTest(classes = YourApplication.class)

内容的提问来源于stack exchange，提问作者Márk Kalinovits