Firestore如何实现写入时排除字段但读取时不排除？

首先得纠正一个小问题：你代码里的boolean是原始类型，默认值是false，不会出现null，所以要改成Boolean包装类型才能实现你示例里的空值场景。调整后的Animal类大概是这样：

public class Animal {
    private Boolean herbivore;
    private Boolean carnivore;
    private Boolean omnivore;

    // 你提到的两个构造方法
    public Animal(Boolean herbivore) {
        this.herbivore = herbivore;
    }

    public Animal(Boolean carnivore) {
        this.carnivore = carnivore;
    }

    // 无参构造方法（Firestore读取时需要）
    public Animal() {}

    // 所有字段的getter/setter，不要加@Exclude
    public Boolean getHerbivore() { return herbivore; }
    public void setHerbivore(Boolean herbivore) { this.herbivore = herbivore; }
    public Boolean getCarnivore() { return carnivore; }
    public void setCarnivore(Boolean carnivore) { this.carnivore = carnivore; }
    public Boolean getOmnivore() { return omnivore; }
    public void setOmnivore(Boolean omnivore) { this.omnivore = omnivore; }
}

接下来给你两种可行的实现方式：

方法一：手动过滤非空字段写入 #

直接构建一个只包含非null值的Map，再写入Firestore，这样就不会出现空字段：

Animal animal = new Animal(true);
Map<String, Object> writeData = new HashMap<>();

// 只加入非null的字段
if (animal.getHerbivore() != null) writeData.put("herbivore", animal.getHerbivore());
if (animal.getCarnivore() != null) writeData.put("carnivore", animal.getCarnivore());
if (animal.getOmnivore() != null) writeData.put("omnivore", animal.getOmnivore());

// 写入文档
db.collection("animals").document("your-doc-id").set(writeData);

读取的时候直接转成Animal对象即可，所有字段（包括未写入的null字段）都会被正确解析：

db.collection("animals").document("your-doc-id")
        .get()
        .addOnSuccessListener(snapshot -> {
            Animal animal = snapshot.toObject(Animal.class);
            // 此时animal的omnivore为null，herbivore为true，完全符合需求
        });

如果觉得手动判断麻烦，也可以用Guava的Maps.filterValues简化过滤逻辑：

Map<String, Object> rawMap = new HashMap<>();
rawMap.put("herbivore", animal.getHerbivore());
rawMap.put("carnivore", animal.getCarnivore());
rawMap.put("omnivore", animal.getOmnivore());
// 过滤掉所有null值
Map<String, Object> filteredMap = Maps.filterValues(rawMap, Objects::nonNull);

方法二：自定义Firestore数据转换器 #

如果需要在多个地方复用这个逻辑，可以写一个自定义的FirestoreDataConverter，把过滤和解析逻辑封装起来：

public class AnimalConverter implements FirestoreDataConverter<Animal> {
    @Override
    public DocumentData toFirestore(Animal animal) {
        DocumentData.Builder builder = DocumentData.builder();
        // 写入时只加非null字段
        if (animal.getHerbivore() != null) builder.set("herbivore", animal.getHerbivore());
        if (animal.getCarnivore() != null) builder.set("carnivore", animal.getCarnivore());
        if (animal.getOmnivore() != null) builder.set("omnivore", animal.getOmnivore());
        return builder.build();
    }

    @Override
    public Animal fromFirestore(DocumentSnapshot snapshot, SnapshotOptions options) {
        // 读取时完整解析所有字段
        Animal animal = new Animal();
        animal.setHerbivore(snapshot.getBoolean("herbivore"));
        animal.setCarnivore(snapshot.getBoolean("carnivore"));
        animal.setOmnivore(snapshot.getBoolean("omnivore"));
        return animal;
        // 或者直接用snapshot.toObject(Animal.class)，效果一样
        // return snapshot.toObject(Animal.class);
    }
}

使用转换器的方式也很简单：

// 写入
db.collection("animals").document("your-doc-id")
        .set(animal, new AnimalConverter());

// 读取
db.collection("animals").document("your-doc-id")
        .withConverter(new AnimalConverter())
        .get()
        .addOnSuccessListener(snapshot -> {
            Animal animal = snapshot.toObject();
            // 所有字段正常读取
        });

这两种方法都能实现你要的「写入时排除空字段，读取时保留所有字段」的需求，选哪种看你代码的复用需求。

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