如何将Firestore特定JSON格式文档映射到Java POJO类

API 探路者

2026-6-25

Firestore专属JSON转Java POJO的可行方案

1. 用Firebase Admin SDK的转换器搞定

你不用直接连接Firestore，只需要引入Admin SDK，就能用它的转换工具处理这种特殊JSON：

先把PubSub拿到的JSON转成Map<String, Object>（用Jackson或Gson都能实现）
自定义FirestoreDataConverter，把Map里带stringValue、arrayValue这类嵌套结构的字段，解析成POJO里的普通字段
如果POJO字段名和Firestore字段名对应，甚至可以用SDK的自动转换逻辑，完全不用修改现有POJO

2. 自己写Jackson自定义反序列化器

不想加SDK依赖的话，给Jackson写个自定义模块就行：

针对String、List、Integer这些常用类型，写对应的JsonDeserializer，比如遇到stringValue节点就取它的文本值，遇到arrayValue就解析成List
把这些反序列化器注册到ObjectMapper，之后就能直接把Firestore JSON转成你的POJO，全程不用改现有POJO

示例代码（简化版）：

public class FirestoreStringDeserializer extends JsonDeserializer<String> {
    @Override
    public String deserialize(JsonParser p, DeserializationContext ctxt) throws IOException {
        JsonNode node = p.getCodec().readTree(p);
        return node.has("stringValue") ? node.get("stringValue").asText() : null;
    }
}

// 注册模块到ObjectMapper
ObjectMapper mapper = new ObjectMapper();
SimpleModule firestoreModule = new SimpleModule();
firestoreModule.addDeserializer(String.class, new FirestoreStringDeserializer());
// 按需添加其他类型的反序列化器，比如List、Integer
mapper.registerModule(firestoreModule);

// 直接反序列化成POJO
Worker worker = mapper.readValue(firestoreJsonStr, Worker.class);