Spring Boot JPA多实体指向同表的冲突解决及SDK集成问题咨询

看起来你遇到了JPA实体重复映射同一张表的典型问题，我来帮你梳理几个可行的方案，不用急着重构整个SDK~

优先推荐：统一实体依赖，消除重复映射 #

这是最符合SDK设计初衷的解决方案，从根源上解决问题：

1. 对齐SDK与微服务的实体定义
   把SDK里的实体名改回PersonProspect，确保它的表映射配置（schema、uniqueConstraints、表名这些）和微服务里原来的实体完全一致，比如：

   @Entity 
   @Table( schema = SCHEMAS.admission, name = "person_prospect", uniqueConstraints = { 
       @UniqueConstraint(name = "UKSL014", columnNames = {"curp", "idc"}) 
   }) 
   public class PersonProspect extends AbstractGeduxCampusModelEntity {}
   

2. 清理微服务的重复实体
   删除微服务项目里的PersonProspect实体类，所有原来用到这个实体的业务代码、Repository接口，全部替换为依赖SDK里的PersonProspect。
3. 重新打包并更新依赖
   执行mvn install重新打包SDK，然后更新微服务的依赖后重启服务。

这个方案的优点非常明显：既消除了JPA的重复映射冲突，又完全发挥了SDK共享公共代码的作用，后续Criteria API和jpamodelgen生成的元模型也只会有一份，不会再出现混乱。

过渡方案：用父类共享映射逻辑（适合无法立即删除微服务实体的场景） #

如果因为业务迭代的限制，暂时没法删除微服务里的实体，可以用@MappedSuperclass来共享映射配置：

1. SDK中定义父类
   把SDK里的实体改成映射父类，去掉@Entity注解，改用@MappedSuperclass：

   @MappedSuperclass
   @Table( schema = SCHEMAS.admission, name = "person_prospect", uniqueConstraints = { 
       @UniqueConstraint(name = "UKSL014", columnNames = {"curp", "idc"}) 
   }) 
   public class PersonProspectBase extends AbstractGeduxCampusModelEntity {}
   

2. 微服务实体继承父类
   微服务里的实体保留@Entity注解，继承SDK的父类即可：

   @Entity 
   public class PersonProspect extends PersonProspectBase {}
   

这样JPA只会把微服务里的PersonProspect识别为实体类，SDK里的父类只是提供映射模板，不会产生重复映射的问题，同时也共享了基础的字段和配置。

不推荐的临时方案：调整实体扫描范围 #

如果以上两种方案都暂时没法落地，你可以尝试在微服务的JPA配置里，精确指定要扫描的实体包，排除掉SDK里的冲突实体。比如在启动类上用@EntityScan：

@SpringBootApplication
@EntityScan(basePackages = {"com.your.microservice.entity", "com.quiox.gedux.sdk.entity.except.conflict"})
public class YourMicroserviceApplication {
    // ...
}

但这个方案只是权宜之计，因为SDK里依赖该实体的功能可能会因为实体未被扫描而失效，而且长期来看还是会有代码维护的混乱，所以不建议作为长期解决方案。

关于Criteria API和元模型的问题 #

你怀疑的点是对的：如果有两个不同的实体类映射同一张表，jpamodelgen会生成两份元模型，使用Criteria API时就会出现元模型不统一的问题，导致代码里出现PersonProspect_和PersonProspectPSDK_两种元模型类，非常容易混乱。而统一用SDK的实体或者用父类共享的方案，都能让元模型只生成一份，从根源上解决这个问题。

总结一下：优先选择统一依赖SDK实体的方案，这是最符合SDK设计理念也最彻底的解决办法，不用重构整个SDK，只需要调整实体定义和微服务的依赖即可。

内容来源于stack exchange