Spring Boot 3原生镜像中AbstractPersistable的id属性未被识别

问题原因 #

原生镜像构建过程中，Hibernate的原生镜像支持默认不会完整扫描依赖库（如Spring Data JPA）中的父类注解信息。AbstractPersistable中的@Id注解在元数据裁剪时被遗漏，导致Hibernate无法识别继承来的标识符属性，从而抛出AnnotationException。你复制父类到本地后，本地类会被构建工具完整扫描，注解信息被正确识别，所以应用能正常启动。

解决方案（无需复制父类到本地） #

1. 配置Hibernate原生镜像元数据包含指定类 #

在application.properties中添加配置，让Hibernate原生镜像处理器保留AbstractPersistable的元数据：

spring.jpa.hibernate.native-image.include=org.springframework.data.jpa.domain.AbstractPersistable

如果需要扫描更多第三方库中的注解类，也可以关闭默认的扫描排除：

spring.jpa.hibernate.native-image.exclude-scanning=false

2. 显式声明标识符属性 #

放弃继承AbstractPersistable，直接在实体类中手动定义@Id属性，彻底避免依赖父类的注解继承问题：

package at.martinahrer.cd.model;
import lombok.Getter;
import lombok.Setter;
import jakarta.persistence.Entity;
import jakarta.persistence.Id;
import jakarta.persistence.GeneratedValue;
import jakarta.persistence.GenerationType;

@Entity
@Getter
@Setter
public class Address {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;
    
    private String line1;
    private String line2;
    private String zip;
    private String city;
    private String state;
    private String country;
}

3. 调整原生镜像构建配置 #

如果使用Maven的native-maven-plugin，可以在插件配置中显式包含AbstractPersistable类，确保其元数据被保留：

<plugin>
    <groupId>org.graalvm.buildtools</groupId>
    <artifactId>native-maven-plugin</artifactId>
    <configuration>
        <metadataCopy>
            <includes>
                <include>org.springframework.data.jpa.domain.AbstractPersistable</include>
            </includes>
        </metadataCopy>
    </configuration>
</plugin>

Gradle用户则在build.gradle中配置：

graalvmNative {
    metadataCopy {
        includes.add("org.springframework.data.jpa.domain.AbstractPersistable")
    }
}

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