如何在Firestore中以事务方式批量更新多文档的position值？

我正在开发Android端的Firestore数据库，用于跟踪队列中所有条目的position（位置）和等待时间。每个队列对应一个Collection，每个用户的队列条目对应Collection中的一个Document。我的目标是同时递减该Collection下所有Document的position值。由于没有资源使用Firestore Cloud Functions，我希望通过事务完成该更新操作，但不确定当前的实现方式是否最优：

CollectionReference entryRef = ref.collection("entries");
List<String> entryIDs = new ArrayList<String>();
List<Long> positions = new ArrayList<Long>();

entryRef.get()
    .addOnCompleteListener(new OnCompleteListener<QuerySnapshot>() {
        @Override
        public void onComplete(@NonNull Task<QuerySnapshot> task) {
            if (task.isSuccessful()) {
                for (QueryDocumentSnapshot document : task.getResult()) {
                    entryIDs.add(document.getId());
                    positions.add(document.getLong("position"));
                }
            }
        }
});

for (int i = 0; i < entryIDs.size(); i++) {
    transaction.update(entryRef.document(entryIDs.get(i)), "position", positions.get(i));
}

请问有没有更优的方式来同时递减多文档中的值？

优化方案 #

你的现有实现存在几个核心问题：

• 异步时序错误：entryRef.get()是异步操作，后续的for循环会在数据还未加载完成时执行，导致entryIDs和positions为空，无法触发更新。
• 更新逻辑无效：代码只是将原position值写回，没有实现递减的需求。
• 事务未正确使用：整个流程没有包裹在事务逻辑中，无法保证多文档更新的原子性。

正确的事务实现方式 #

直接在事务内完成查询与批量更新，利用Firestore的FieldValue.increment()实现原子递减：

CollectionReference entryRef = ref.collection("entries");

FirebaseFirestore.getInstance().runTransaction(new Transaction.Function<Void>() {
    @Nullable
    @Override
    public Void apply(@NonNull Transaction transaction) throws FirebaseFirestoreException {
        // 在事务内查询所有队列条目
        QuerySnapshot snapshot = transaction.get(entryRef).get();
        
        // 遍历每个文档，执行position递减操作
        for (DocumentSnapshot doc : snapshot.getDocuments()) {
            transaction.update(doc.getReference(), "position", FieldValue.increment(-1));
        }
        
        return null;
    }
}).addOnSuccessListener(new OnSuccessListener<Void>() {
    @Override
    public void onSuccess(Void unused) {
        // 批量更新成功
    }
}).addOnFailureListener(new OnFailureListener() {
    @Override
    public void onFailure(@NonNull Exception e) {
        // 更新失败，处理异常
    }
});

方案优势 #

1. 原子性保障：所有文档的更新操作都在事务内完成，要么全部成功，要么全部回滚，避免队列位置出现不一致。
2. 并发安全：使用FieldValue.increment(-1)无需手动读取原数值，Firestore会自动处理并发场景下的数值计算，不会出现覆盖问题。
3. 异步逻辑规范：查询与更新都在事务的同步回调中执行，避免了异步时序错误。

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