Spring MongoDB如何使Repository适配类继承结构正常工作

默认配置下Spring Data MongoDB仅会对@Document标注的集合根实体自动追加类型查询条件，继承根实体的子类Repository默认不触发该逻辑，就会出现全集合拉取文档后强转的问题。
按你使用的框架版本选对应方案即可，不需要手动给每个查询追加_class过滤条件：

• 方案1（推荐，适用于Spring Data MongoDB 3.3+版本）
  直接在抽象父类上加@Polymorphic注解，框架会自动扫描所有继承该父类的子类，所有子类Repository的查询会自动追加_class匹配逻辑，仅返回对应子类的文档。
  代码示例：

  @Document(collection = "car")
  @Polymorphic // 开启多态文档自动类型过滤
  public abstract class Car {
      // 父类公共字段、方法
  }
  
  // 子类无需额外注解，正常定义即可
  public class Volvo extends Car {
      // Volvo专属字段
  }
  

  注意：不要自定义MongoTypeMapper将类型键（默认字段名_class）设为null，否则类型字段不会写入文档，过滤逻辑完全失效。
• 方案2（兼容3.3以下版本，无自定义类）
  给每个子类添加和父类同集合名的@Document注解，框架会把子类识别为该集合的合法实体类型，查询时自动追加类型过滤：

  @Document(collection = "car")
  public abstract class Car { }
  
  @Document(collection = "car") // 和父类指定同一个集合
  public class Volvo extends Car { }
  

  缺点是子类较多时需要重复给每个类加注解，维护成本高。
• 方案3（全局配置，兼容所有版本）
  通过自定义Repository工厂Bean，全局开启子类查询自动追加类型过滤的逻辑，不需要修改实体类注解：
  1. 定义支持多态过滤的工厂Bean：

  public class PolymorphicMongoRepositoryFactoryBean<T extends Repository<S, ID>, S, ID> extends MongoRepositoryFactoryBean<T, S, ID> {
      @Override
      protected RepositoryFactorySupport createRepositoryFactory(MongoOperations mongoOperations) {
          return new MongoRepositoryFactory(mongoOperations) {
              @Override
              protected @NotNull EntityInformation<?, ?> getEntityInformation(RepositoryInformation information) {
                  MongoPersistentEntity<?> entity = mongoOperations.getConverter()
                          .getMappingContext()
                          .getRequiredPersistentEntity(information.getDomainType());
                  return new MappingMongoEntityInformation<>(entity);
              }
          };
      }
  }
  

  2. 在Mongo配置类中启用该工厂：

  @Configuration
  @EnableMongoRepositories(
      basePackages = "com.repo", // 替换成你的Repository所在包路径
      repositoryFactoryBeanClass = PolymorphicMongoRepositoryFactoryBean.class
  )
  public class MongoConfig extends AbstractMongoClientConfiguration {
      @Override
      protected String getDatabaseName() {
          return "你的业务库名";
      }
      // 其余Mongo连接、转换器等配置保持原有逻辑即可
  }
  

避坑提示 #

• 如果用@TypeAlias给子类自定义了类型别名，必须保证所有子类别名全局唯一，否则会出现类型转换错误
• 多模块项目要在MongoMappingContext中配置全所有实体类的扫描包，避免框架识别不到子类和_class值的映射关系
• 若自定义了MappingMongoConverter的TypeMapper，要确保配置的类型键和文档中存储的类型字段名（默认_class）一致

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