Quarkus MongoDB Panache中null字段无法写入MongoDB的解决方案咨询

一、单字段级别的处理（类似Spring的@Field） #

Quarkus中可以直接使用MongoDB官方的@BsonProperty注解，通过设置serializeNulls = true来指定单个字段即使为null也会被写入MongoDB。示例代码如下：

import io.quarkus.mongodb.panache.PanacheMongoEntity;
import org.bson.codecs.pojo.annotations.BsonProperty;

public class User extends PanacheMongoEntity {
    public String username;
    
    // 该字段为null时会被持久化到MongoDB
    @BsonProperty(serializeNulls = true)
    public String phone;
}

二、全局生效的配置 #

如果希望所有实体的null字段都默认被保留，无需逐个字段加注解，可以在application.properties中添加全局配置：

quarkus.mongodb.panache.serialize-nulls=true

配置后，所有通过Panache Repository执行persist操作的实体，null字段都会被写入MongoDB。

三、手动使用MongoDB Java同步驱动实现 #

如果需要绕过Panache的自动处理，直接用MongoDB Java同步驱动实现，可以通过两种方式：

方式1：手动构建Document插入 #

直接构建包含null字段的Document对象，显式指定null值后插入：

import com.mongodb.client.MongoClients;
import com.mongodb.client.MongoCollection;
import org.bson.Document;

// 获取目标集合
MongoCollection<Document> userCollection = MongoClients.create()
        .getDatabase("your-db-name")
        .getCollection("users");

// 构建包含null字段的文档
Document userDoc = new Document("username", "Tom")
        .append("phone", null); // 显式添加null字段

// 插入文档
userCollection.insertOne(userDoc);

方式2：配置POJO序列化策略 #

如果依然想用POJO对象插入，需要配置POJO的CodecRegistry，开启null序列化：

import com.mongodb.MongoClientSettings;
import com.mongodb.client.MongoClients;
import com.mongodb.client.MongoCollection;
import org.bson.codecs.configuration.CodecRegistries;
import org.bson.codecs.configuration.CodecRegistry;
import org.bson.codecs.pojo.PojoCodecProvider;

// 构建支持null序列化的POJO CodecProvider
CodecRegistry pojoCodecRegistry = CodecRegistries.fromProviders(
        PojoCodecProvider.builder()
                .register(User.class) // 注册你的实体类
                .enableNullSerialization() // 开启null字段序列化
                .build());

// 配置Mongo客户端设置
MongoClientSettings clientSettings = MongoClientSettings.builder()
        .codecRegistry(CodecRegistries.fromRegistries(
                MongoClientSettings.getDefaultCodecRegistry(),
                pojoCodecRegistry))
        .build();

// 获取泛型集合并插入POJO
MongoCollection<User> userCollection = MongoClients.create(clientSettings)
        .getDatabase("your-db-name")
        .getCollection("users", User.class);

User user = new User();
user.username = "Jerry";
user.phone = null; // 该null字段会被写入
userCollection.insertOne(user);

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