Android中Firestore事务执行多函数时部分写入问题排查

一、自定义execute函数偶发部分写入的问题 #

1. 是否需要移除viewModelScope.launch？ #

必须移除。Firestore的runTransaction是同步阻塞操作，若在事务块内用viewModelScope.launch启动异步协程，事务不会等待异步操作完成就会提交，直接导致部分操作（比如保存交易记录）未执行完事务就结束，进而出现偶发的部分写入情况。事务内所有操作必须同步执行，不能嵌套异步逻辑。

2. 是否要在runTransaction块中添加返回值？ #

建议添加。Firestore的runTransaction块要求返回非null值，若无需返回业务数据，返回Unit或true这类默认值即可。如果不返回值，部分版本的Firebase SDK可能抛出异常导致事务直接失败，统一添加返回值能规避这类潜在问题。
另外要确保你的execute(List<(Transaction)->Unit>)函数是同步遍历执行所有传入的操作，而非并行执行，这是保证事务原子性的基础。

二、incrementStock函数与事务的相关问题 #

1. 循环中部分写入失败但至少有一次更新成功，事务是否会成功？ #

不会。Firestore事务是原子性的，只要事务块内任意一个操作失败（比如触发写入限制、权限不足、数据冲突），整个事务会立即回滚，所有已执行的操作都会被撤销，最终事务整体失败，不存在“部分成功”的情况。
另外，Firestore单文档每秒1次的写入限制，事务会自动处理重试逻辑，若执行中遇到频率超限，事务会自动重试直到成功或达到重试上限（默认5次），只有重试全部失败时，事务才会最终失败。

2. products的键含+-等特殊字符，是否导致map字段写入失败？ #

Firestore允许Map字段的键包含+-这类特殊字符，不会直接导致写入失败。但要注意：

• 查询这类特殊字符的键时需正确转义，但写入本身不受影响；
• 若特殊字符引发代码语法错误（比如.或$可能有问题，但+-无影响），属于代码逻辑问题，并非Firestore的限制。

如果确实因特殊字符导致某个map字段写入失败，整个事务会整体失败——事务的原子性要求所有操作必须全部成功，只要有一个操作失败，所有操作都会回滚。

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