集成Hibernate的Spring Boot应用构建Native镜像启动失败如何解决

你遇到的是Hibernate SPI服务在GraalVM原生镜像环境下加载失败的问题，是原生镜像构建时遗漏了Spring Native相关的基础配置导致的，需要补充以下配置：

1. 补充Spring Native基础依赖与插件 #

在pom.xml中新增Spring Native依赖，以及AOT处理、原生构建相关插件：

• 先在properties节点添加对应Spring Boot 2.5.x适配的Spring Native版本：

<properties>
    <spring-native.version>0.10.5</spring-native.version>
</properties>

• 新增Spring Native核心依赖：

<dependencies>
    <dependency>
        <groupId>org.springframework.experimental</groupId>
        <artifactId>spring-native</artifactId>
        <version>${spring-native.version}</version>
    </dependency>
</dependencies>

• 新增Spring AOT Maven插件，用于提前处理Hibernate、JPA相关元数据：

<plugin>
    <groupId>org.springframework.experimental</groupId>
    <artifactId>spring-aot-maven-plugin</artifactId>
    <version>${spring-native.version}</version>
    <executions>
        <execution>
            <id>test-generate</id>
            <goals>
                <goal>test-generate</goal>
            </goals>
        </execution>
        <execution>
            <id>generate</id>
            <goals>
                <goal>generate</goal>
            </goals>
        </execution>
    </executions>
</plugin>

• 给spring-boot-maven-plugin添加原生镜像构建配置：

<plugin>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-maven-plugin</artifactId>
    <configuration>
        <image>
            <builder>paketobuildpacks/builder:tiny</builder>
            <env>
                <BP_NATIVE_IMAGE>true</BP_NATIVE_IMAGE>
            </env>
        </image>
    </configuration>
</plugin>

2. 开启Hibernate原生支持 #

在application配置文件中添加以下配置，让Spring Native自动注册Hibernate相关的SPI服务、元数据到原生镜像：

spring.jpa.hibernate.native-hibernate-enabled=true

3. 校验版本兼容性 #

确保hibernate-enhance-maven-plugin的版本和项目中依赖的hibernate-core版本完全一致，避免字节码增强和运行环境版本不匹配的问题。

完成以上配置后，重新执行原生镜像构建即可正常启动。

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