MongoDB PojoCodec反序列化时id字段为null的问题排查

核心原因：MongoDB PojoCodec与Jackson的字段映射规则差异 #

你遇到的问题本质是PojoCodec的字段识别逻辑和Jackson完全不同，具体分为以下几种情况：

1. Header类未添加MongoDB专属的字段映射注解 #

Jackson依赖@JsonProperty或默认按字段名匹配，但PojoCodec默认只识别两种情况：

• 与MongoDB返回字段名完全一致的Java字段（大小写敏感）
• 带有@BsonProperty("字段名")注解的字段

如果你的Header类里仅用了Jackson的@JsonProperty("id")，没加MongoDB的@BsonProperty("id")，PojoCodec会找不到对应字段，导致id赋值失败。

示例修正：

public class Header {
    // 同时添加两个注解，兼容PojoCodec和Jackson
    @BsonProperty("id")
    @JsonProperty("id")
    private String id;
    
    private String alias;
    private String type;
    
    // 必须保留无参构造、标准getter/setter
}

2. PojoCodec的ClassModel未包含id字段 #

MongoDB的PojoCodec通过ClassModel解析Java类结构，若id字段满足以下任一条件，会被ClassModel忽略：

• 私有字段但未提供对应的getter/setter
• 被标记为static或final
• 所在类没有无参构造函数

注意：Jackson可以通过反射直接访问私有字段，但PojoCodec对JavaBean规范的要求更严格，必须满足标准的getter/setter和无参构造。

3. 聚合投影的字段类型不匹配（次要可能） #

如果原集合中contacts.header.id是MongoDB的ObjectId类型，而Header类里的id字段定义为String，PojoCodec默认不会自动转换类型，而Jackson会自动将ObjectId序列化为字符串。这种情况需要给id字段添加类型转换注解：

@BsonProperty("id")
@BsonRepresentation(BsonType.OBJECT_ID)
private String id;

验证方法 #

可以手动打印PojoCodec生成的ClassModel，确认是否包含id字段：

CodecRegistry codecRegistry = MongoClients.create().getDatabase("test").getCodecRegistry();
PojoCodecProvider pojoCodecProvider = PojoCodecProvider.builder().automatic(true).build();
ClassModel<Header> classModel = pojoCodecProvider.get(Header.class);
System.out.println(classModel.getProperties()); // 查看输出是否包含id属性

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