MongoDB Java POJO编码器仅生成含_id的空文档问题求助

问题根源 #

给getter添加@BsonIgnore后，原有的getter序列化逻辑被禁用，而你启用的私有字段反射约定可能因配置优先级或缺少字段注解，导致编码器无法识别并读取私有字段，最终仅保留默认的_id字段。

具体解决方案 #

• 给私有字段添加@BsonProperty注解：明确字段与MongoDB文档字段的映射关系，让编码器直接识别字段，无需依赖getter。示例：

public class PermissionPlayer {
    @BsonId
    private String id;
    @BsonProperty("permissions")
    private Set<String> permissions;
    // 其他私有字段都添加@BsonProperty指定对应文档字段名
}

• 调整POJO约定的优先级：在配置PojoCodecProvider时，将PrivateFieldReflectionConvention放在AnnotationConvention之前，确保编码器优先尝试直接读取私有字段，而非被注解影响的getter逻辑。配置示例：

CodecRegistry pojoCodecRegistry = CodecRegistries.fromRegistries(
    MongoClientSettings.getDefaultCodecRegistry(),
    CodecRegistries.fromProviders(PojoCodecProvider.builder()
        .automatic(true)
        .conventions(Arrays.asList(
            Convention.DEFAULT,
            PrivateFieldReflectionConvention.INSTANCE,
            AnnotationConvention.INSTANCE
        ))
        .build())
);

MongoClientSettings settings = MongoClientSettings.builder()
    .codecRegistry(pojoCodecRegistry)
    .build();

MongoClient mongoClient = MongoClients.create(settings);

• 精准使用@BsonIgnore：仅给存在数据修改逻辑的那个getter添加注解，不要批量给所有getter加。这样编码器仍可通过其他正常的getter序列化剩余字段，避免全部字段无法被识别。

• 检查字段属性：确保私有字段未被final修饰（常量除外），编码器需要通过反射访问字段完成序列化。

补充说明 #

之前依赖getter序列化时，编码器通过调用getter获取字段值；当你给getter加@BsonIgnore后，编码器失去了获取字段值的途径。即使启用了私有字段反射，若约定顺序不对或缺少字段映射注解，编码器仍无法识别私有字段，最终仅序列化默认生成的_id。

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