Spring Boot 3.x升级后Spring Data MongoDB DBObject转换器警告问题

警告原因 #

Spring Boot 3.x对应的Spring Data MongoDB版本升级后，com.mongodb.DBObject不再被视为MongoDB存储层支持的类型。这是因为MongoDB驱动已将DBObject标记为过时，转而推荐使用org.bson.Document作为通用BSON文档操作类型。

最佳解决方案 #

直接将转换器的源类型从DBObject替换为Document，适配当前Spring Data MongoDB的要求：

修改后的转换器类签名：

@ReadingConverter
public static class MongoRead implements Converter<Document, xxx> {
    // 调整原有转换逻辑，用Document的API替代DBObject的方法，比如document.get("字段名")
}

特殊场景临时处理（不推荐） #

如果因历史代码依赖无法立即迁移到Document，可以额外添加一个从Document到DBObject的转换器，但这只是过渡方案，长期来看仍需逐步替换掉DBObject的使用：

@ReadingConverter
public static class DocumentToDBObjectConverter implements Converter<Document, DBObject> {
    @Override
    public DBObject convert(Document source) {
        return new BasicDBObject(source);
    }
}

最佳实践说明 #

遵循MongoDB官方API演进方向，使用当前受支持的Document类型，避免依赖过时API带来的后续兼容性风险，同时彻底消除警告。

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