如何在Android(Java)端向Firebase Firestore数组字段追加数据

1. Firestore 字符串数组运行逻辑 #

• Firestore的数组是有序字段类型，支持存储同类型的多个值
• 官方提供专属原子操作方法，不需要手动读取全量数组再写入，可避免多线程并发冲突
• FieldValue.arrayUnion() 是追加元素的专用方法：自动跳过已存在的元素，不会重复写入，全程为原子操作
• 如果业务需要允许重复元素追加，才需要先读取数组、本地添加元素后再全量写入

2. 向purchaseHistory数组追加元素的完整示例 #

前置条件：已完成Firebase项目与Android应用的绑定，且已导入Firestore相关依赖。

基础无重复追加（推荐入门使用） #

// 初始化Firestore实例
FirebaseFirestore db = FirebaseFirestore.getInstance();

// 要追加到purchaseHistory的新元素，可替换为实际业务值
String newPurchaseRecord = "ORDER_20240520_001";

// 构造更新操作：原子追加元素到数组
Map<String, Object> update = new HashMap<>();
update.put("purchaseHistory", FieldValue.arrayUnion(newPurchaseRecord));

// 操作users集合下的目标用户文档，示例默认使用登录用户uid作为文档id，可替换为实际文档id
String userId = FirebaseAuth.getInstance().getCurrentUser().getUid();
db.collection("users").document(userId)
        .update(update)
        .addOnSuccessListener(aVoid -> {
            // 追加成功的业务处理
            Log.d("Firestore操作", "购买记录追加成功");
        })
        .addOnFailureListener(e -> {
            // 追加失败的异常处理
            Log.w("Firestore操作", "购买记录追加失败", e);
        });

• 一次性追加多个元素时，直接将多个参数传入arrayUnion()即可，示例：FieldValue.arrayUnion(record1, record2, record3)
• 操作前需提前在Firestore控制台配置对应集合的读写权限，避免权限拒绝报错

3. 允许重复元素追加的实现方式 #

如果业务场景需要允许同一个记录多次存入数组，使用先读再写的方案：

FirebaseFirestore db = FirebaseFirestore.getInstance();
String userId = FirebaseAuth.getInstance().getCurrentUser().getUid();

db.collection("users").document(userId)
        .get()
        .addOnSuccessListener(documentSnapshot -> {
            if (documentSnapshot.exists()) {
                // 读取现有数组
                List<String> currentHistory = (List<String>) documentSnapshot.get("purchaseHistory");
                if (currentHistory == null) {
                    currentHistory = new ArrayList<>();
                }
                // 本地添加新元素（支持重复）
                currentHistory.add("ORDER_20240520_001");
                // 全量写回数据库
                documentSnapshot.getReference().update("purchaseHistory", currentHistory)
                        .addOnSuccessListener(aVoid -> Log.d("Firestore操作", "带重复的记录追加成功"));
            }
        })
        .addOnFailureListener(e -> Log.w("Firestore操作", "读取数组失败", e));

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