Spring Boot-MongoDB继承问题：MongoRepository操作异常求助

这个问题我之前帮人排查过好几次，核心是Spring Data MongoDB处理继承关系时的集合映射策略搞混了，咱们一步步拆解：

首先看你日志里的矛盾点：插入时数据进了base集合，但查询Derived类型的时候却去derived集合找——这说明你的实体类注解和Repository的配置不匹配，导致读写操作指向了不同的集合。

为什么会出现这种情况？ #

Spring Data MongoDB默认对继承关系采用单表（单集合）继承策略：所有继承自父类的子类实例都会存在父类指定的集合里，靠_class字段区分具体类型。但你的查询日志显示去derived集合找，大概率是下面两种情况之一：

1. 你的Derived子类上单独标注了@Document(collection = "derived")，导致对应的DerivedRepository默认操作这个集合，但插入时你用了父类的BaseRepository，把数据写到了父类的base集合里；
2. 你误将父类和子类的Repository混用，或者实体类的@Document注解配置冲突。

两种解决方案，按需选择： #

方案一：保留单表继承（所有子类数据存在base集合）

如果你本来就想让所有继承关系的实体存在同一个集合，只需要调整注解和Repository的使用：

1. 统一集合配置：只在父类Base上标注@Document(collection = "base")，子类Derived不要加@Document注解；
2. 正确使用Repository：
   • 如果要插入Derived实例，直接用DerivedRepository（而不是BaseRepository），此时数据依然会写入base集合，但会带上_class: Derived的标识；
   • 查询时findByFieldA会自动在base集合里查询，并且加上_class = Derived的过滤条件，日志会变成：

     find using query: { "fieldA" : "some value", "_class" : "com.yourpackage.Derived" } fields: null for class: class Derived in collection: base
     

代码示例：

// 父类：指定集合为base
@Document(collection = "base")
public class Base {
    @Id
    private String id;
    private String fieldA;
    // getter/setter
}

// 子类：无需加@Document，继承父类的集合配置
public class Derived extends Base {
    private String fieldB;
    // getter/setter
}

// Derived的Repository
public interface DerivedRepository extends MongoRepository<Derived, String> {
    List<Derived> findByFieldA(String fieldA);
}

方案二：使用多集合继承（子类数据存到自己的derived集合）

如果你希望每个子类单独存到自己的集合，需要调整实体类的注解：

1. 父类不指定集合：父类Base可以不加@Document注解（或者加但不指定集合名，让子类覆盖）；
2. 子类指定自己的集合：在Derived上标注@Document(collection = "derived")；
3. 用子类Repository操作数据：插入和查询都用DerivedRepository，此时数据会写入derived集合，查询也会指向这个集合，日志就和预期一致了。

代码示例：

// 父类：不标注@Document，或只作为抽象基类
public abstract class Base {
    @Id
    private String id;
    private String fieldA;
    // getter/setter
}

// 子类：指定自己的集合
@Document(collection = "derived")
public class Derived extends Base {
    private String fieldB;
    // getter/setter
}

// Derived的Repository
public interface DerivedRepository extends MongoRepository<Derived, String> {
    List<Derived> findByFieldA(String fieldA);
}

额外提醒 #

• 如果父类必须加@Document，子类的@Document注解会覆盖父类的集合配置，同样能实现多集合存储；
• 单表继承的优势是方便跨子类查询，多集合继承则更符合分表（分集合）的隔离需求，根据你的业务场景选就行。

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