跨JAR包继承@MappedSuperclass的@Id失败问题求助

问题场景 #

将包含@MappedSuperclass注解的BaseEntity封装为独立JAR库，通过Maven引入到其他项目后，继承该类的Test实体出现以下问题：

• IntelliJ提示错误：Persistent entity 'Test' should have a primary key.
• 应用启动报错：Entity 'Test' has no identifier (every '@Entity' class must declare or inherit at least one '@Id' or '@EmbeddedId' property)
• 手动给Test加@Id后，应用可启动，但数据库表仅生成id和a字段，modified、created字段缺失，说明子类未继承父类的任何字段映射。

代码示例 #

JAR库中的BaseEntity #

@MappedSuperclass
public class BaseEntity {
    @Id
    @GeneratedValue
    protected UUID id;
    @LastModifiedDate
    protected LocalDateTime modified;
    @CreatedDate
    protected LocalDateTime created;
    // getters, setters
}

引用项目中的Test实体 #

@Entity
public class Test extends BaseEntity {
    private String a;
    // getters, setters
}

解决方案 #

1. 检查Maven依赖范围 #

确保引入JAR库的依赖范围为compile（默认值），不要使用provided或test，否则运行时JPA无法加载父类的注解和字段：

<dependency>
    <groupId>你的JAR库groupId</groupId>
    <artifactId>你的JAR库artifactId</artifactId>
    <version>对应版本号</version>
    <!-- 无需指定scope，默认compile即可 -->
</dependency>

2. 配置JPA实体扫描范围 #

Spring Boot项目需在主启动类上通过@EntityScan指定包含JAR库中BaseEntity的包路径，确保JPA能扫描到映射超类：

@SpringBootApplication
@EntityScan(basePackages = {
    "com.your.project.entity", // 本地实体包
    "com.your.jar.library.entity" // JAR库中BaseEntity所在包
})
public class YourApplication {
    public static void main(String[] args) {
        SpringApplication.run(YourApplication.class, args);
    }
}

纯JPA项目则在persistence.xml中添加BaseEntity的全类名或扫描包：

<persistence-unit name="yourPersistenceUnit">
    <class>com.your.jar.library.entity.BaseEntity</class>
    <class>com.your.project.entity.Test</class>
    <!-- 或指定扫描包 -->
    <exclude-unlisted-classes>false</exclude-unlisted-classes>
</persistence-unit>

3. 确认父类字段访问权限与注解 #

• 确保BaseEntity的字段为protected或public（已满足），且正确生成getter/setter方法，JPA需要通过反射访问这些成员。
• 确认@MappedSuperclass注解未遗漏，该注解是JPA识别映射超类的核心标记。

4. 清理缓存并重新构建 #

• IntelliJ中执行File -> Invalidate Caches... -> Invalidate and Restart，清除IDE缓存解决识别问题。
• 执行Maven命令重新构建JAR库和引用项目：

mvn clean install

验证 #

完成上述操作后，重新启动应用：

• IDE不再提示主键缺失错误
• 数据库生成的test表将包含id、modified、created、a四个字段
• JPA可正常识别Test实体的继承映射

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