GraalVM Native Image如何注册package-info.java以支持反射？

API 探路者

2026-6-22

解决方案：Hibernate 6 + Spring Boot 3 原生镜像下@FilterDef未识别问题

方案1：修复package-info.java的原生镜像扫描问题

GraalVM原生镜像默认可能不会处理package-info.java中的Hibernate注解，仅添加反射配置不足以让Hibernate加载其中的@FilterDef：

确保package-info.java所在包被Spring Boot的实体扫描覆盖，在@SpringBootApplication或@EntityScan注解中明确指定包路径，比如@EntityScan(basePackages = "com.yourpackage")
补充GraalVM的资源配置文件resource-config.json，让原生镜像包含package-info文件：

{
  "resources": [
    {"pattern": "\\Qcom/yourpackage/package-info.java\\E"}
  ]
}

临时替代方案：将@FilterDef迁移到某个实体类（比如通用基础实体）上，绕过package-info的扫描限制

方案2：编程式注册FilterDefinition的正确姿势

在Spring Boot 3 + Hibernate 6中，通过SessionFactoryBuilderCustomizer在SessionFactory构建前注册FilterDefinition，赶在实体验证之前完成配置：

@Component
public class FilterConfigurer implements SessionFactoryBuilderCustomizer {
    @Override
    public void customize(SessionFactoryBuilder sessionFactoryBuilder) {
        // 构建与package-info中一致的FilterDefinition
        FilterDefinition deletedFilter = new FilterDefinition(
            "filterDeleted",
            "deleted = :isDeleted",
            Map.of("isDeleted", StandardBasicTypes.BOOLEAN)
        );
        sessionFactoryBuilder.addFilterDefinition(deletedFilter);
    }
}

这个组件会被Spring Boot自动发现，并在Hibernate元数据验证前注入Filter配置，解决实体@Filter找不到对应FilterDef的问题。