Spring Data MongoDB是否支持模式版本控制？如何适配多版本文档？

Spring Data MongoDB 完全支持基于字段识别的文档版本控制模式，针对你计划的「接口+多版本实现类」方案，可以通过以下步骤落地：

1. 定义基础接口与版本化实体类 #

• 先定义顶层接口 MyDocument，声明通用字段（如id、schemaVersion）及通用方法
• 实现MyDocumentV1和MyDocumentV2实体类，对应不同版本的文档结构，通过@Document注解指定同一集合名，各自维护对应版本的专属字段
• 示例代码：

public interface MyDocument {
    String getId();
    Integer getSchemaVersion();
}

@Document(collection = "my_documents")
public class MyDocumentV1 implements MyDocument {
    @Id
    private String id;
    private Integer schemaVersion = 1;
    // V1 专属字段
    private String v1Field;

    // getter、setter 方法
}

@Document(collection = "my_documents")
public class MyDocumentV2 implements MyDocument {
    @Id
    private String id;
    private Integer schemaVersion = 2;
    // V2 专属字段
    private String v2Field;
    private Integer v2NumberField;

    // getter、setter 方法
}

2. 自定义转换器实现版本路由 #

利用 Spring Data MongoDB 的MongoConverter扩展能力，通过自定义ReadingConverter，在读取文档时根据schemaVersion字段自动实例化对应版本类：

• 实现Converter<Document, MyDocument>接口，重写convert方法，根据版本值返回对应实体
• 示例代码：

@Component
public class MyDocumentReadingConverter implements Converter<Document, MyDocument> {

    @Override
    public MyDocument convert(Document source) {
        Integer schemaVersion = source.getInteger("schemaVersion");
        if (schemaVersion == 1) {
            return source.to(MyDocumentV1.class);
        } else if (schemaVersion == 2) {
            return source.to(MyDocumentV2.class);
        }
        // 处理未知版本，可抛出异常或返回默认实现
        throw new IllegalArgumentException("不支持的 Schema 版本: " + schemaVersion);
    }
}

3. 通用 Repository 操作多版本文档 #

定义继承自MongoRepository的通用 Repository 接口，泛型指定为MyDocument和主键类型：

public interface MyDocumentRepository extends MongoRepository<MyDocument, String> {
    // 可添加自定义查询方法，比如按版本筛选
    List<MyDocument> findBySchemaVersion(Integer schemaVersion);
}

调用findById、findAll等方法时，Spring Data MongoDB 会自动通过自定义转换器将文档映射为对应版本的实体类；保存时不同版本实体的字段会写入同一集合，并带上对应的schemaVersion标识。

补充说明 #

• 若需迁移旧版本文档，可在读取时进行版本升级，或编写批量脚本处理
• 为避免字段冲突，新版本字段尽量不与旧版本重名，或通过@Field注解指定不同存储键名

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