Firestore中FieldValue.increment(value)间歇性失效问题排查

核心错误：set方法参数传递错误 #

你代码中处理payeeRef的部分存在语法错误，这是导致功能间歇性失效的直接原因：

await payeeRef
    .set({payeeData, SetOptions(merge: true)} as Map<String, dynamic>);

这里错误地将payeeData（一个Map）和SetOptions实例放在集合中强制转成Map，完全不符合Firestore set方法的调用规范。set方法的正确用法是第一个参数传入数据Map，第二个参数传入SetOptions（可选）。

修复后的代码 #

将上述错误代码替换为：

final payeeData = {'name': payee, 'amount': FieldValue.increment(amount)};
await payeeRef.set(payeeData, SetOptions(merge: true));

额外优化建议 #

• 补全异步等待：transactionsRef.add(transactionData)未添加await，会导致交易记录写入与统计更新的执行顺序不可控，可能引发数据不一致，建议修改为：

  await transactionsRef.add(transactionData);
  

• 保证数值类型一致：Firestore的FieldValue.increment对数值类型敏感，确保Firestore中amount字段始终为统一数值类型（不要混用int和double），避免类型不匹配导致的更新失败。
• 添加错误捕获：当前代码无异常处理逻辑，一旦Firestore操作失败无法感知，建议添加try-catch块：

  try {
    // 所有Firestore操作逻辑放在此处
  } catch (e) {
    print('账本写入失败: $e');
    // 可补充错误提示或日志上报逻辑
  }
  

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