MongoDB Java驱动DBRef解析问题：查询返回DBRef而非Map对象

我完全懂你碰到的这个问题——插入带DBRef的文档后，查询返回的是DBRef实例而非你预期的Map结构。这其实是MongoDB Java驱动的默认解码行为，不过我们可以通过几种方式轻松处理，把DBRef转换成Map格式。

方法一：手动转换DBRef为Map（快速解决） #

在遍历查询结果时，你可以手动判断字段类型，把DBRef对象转换成Document（它本身就是Map的实现类）。DBRef提供了获取集合名和ID的方法，我们可以用这些信息构建对应的Map结构：

MongoCollection<Document> coll = client.getDatabase("db").getCollection("projects");
FindIterable<Document> result = coll.find(query);

for (Document doc : result) {
    Object ownerField = doc.get("owner");
    // 判断是否为DBRef类型
    if (ownerField instanceof DBRef) {
        DBRef ownerRef = (DBRef) ownerField;
        // 构建符合DBRef格式的Map/Document
        Document ownerMap = new Document()
                .append("$ref", ownerRef.getCollectionName())
                .append("$id", ownerRef.getId());
        // 替换原字段为Map结构
        doc.put("owner", ownerMap);
    }
    // 此时doc中的owner就是你想要的Map格式了
    System.out.println(doc.toJson());
}

方法二：自定义编解码器（全局统一处理） #

如果你的项目中有大量DBRef需要转换，不想每次查询都手动处理，可以自定义编解码器覆盖驱动的默认DBRef解码逻辑，实现自动转换：

1. 先创建自定义的DBRef编解码器：

public class DBRefToMapCodec implements Codec<DBRef> {
    private final Codec<Document> documentCodec;

    public DBRefToMapCodec(CodecRegistry registry) {
        this.documentCodec = registry.get(Document.class);
    }

    @Override
    public void encode(BsonWriter writer, DBRef value, EncoderContext encoderContext) {
        // 编码时保持标准DBRef格式，不影响插入操作
        Document refDoc = new Document("$ref", value.getCollectionName())
                .append("$id", value.getId());
        documentCodec.encode(writer, refDoc, encoderContext);
    }

    @Override
    public DBRef decode(BsonReader reader, DecoderContext decoderContext) {
        // 解码时先读取为Document，再转换为DBRef（如果需要保留DBRef能力）
        // 如果你希望直接返回Map，可调整为返回Document类型，不过需要修改泛型适配
        Document refDoc = documentCodec.decode(reader, decoderContext);
        return new DBRef(refDoc.getString("$ref"), refDoc.get("$id"));
    }

    @Override
    public Class<DBRef> getEncoderClass() {
        return DBRef.class;
    }
}

2. 注册自定义编解码器到Mongo客户端：

CodecRegistry codecRegistry = CodecRegistries.fromRegistries(
        MongoClientSettings.getDefaultCodecRegistry(),
        CodecRegistries.fromCodecs(new DBRefToMapCodec(MongoClientSettings.getDefaultCodecRegistry()))
);

MongoClient client = MongoClients.create(MongoClientSettings.builder()
        .codecRegistry(codecRegistry)
        .build());

不过要注意，全局编解码器适合大型项目的统一处理场景，小项目或者零散场景用手动转换会更轻便。

为什么会出现这个问题？ #

MongoDB Java驱动在解码时，会自动识别包含$ref和$id字段的文档，并将其转换为DBRef对象，这是驱动为了方便关联查询提供的默认行为。如果你希望保留原始的Map结构，就需要手动干预或者修改解码逻辑。

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