Flutter Firestore按uid更新noofdays字段无响应排查

问题背景 #

现有Firebase数据库结构如下：

字段更新逻辑写在Flutter的ElevatedButton组件中，目标是更新tripdetails集合下、对应用户uid文档里的noofdays字段。实际点击按钮后，Firebase控制台对应字段无变化，调试控制台也没有输出任何提示或错误信息。
其中noofdays是和控制器绑定的变量，原有问题代码如下：

ElevatedButton(
  onPressed: () async {
    var collection =
        FirebaseFirestore.instance.collection('tripdetails');

    collection.doc(user!.uid).update({'noofdays': _nodays});
  },
  child: const Text("Update"),
),

核心问题点 #

原有代码存在两个直接导致异常无感知、操作不生效的问题：

• 异步操作未加await：虽然给onPressed加了async关键字，但调用Firestore的update方法时没有等待异步任务完成，操作可能被中断，抛出的异常也无法被外层捕获
• 无异常捕获逻辑：没有做try-catch包装，哪怕更新操作被Firebase拒绝、执行报错，控制台也不会打印相关错误信息
• 额外注意：Firestore的update方法仅在目标文档已经存在时才能正常执行，如果对应uid的文档还没创建，调用update会直接抛出不存在的错误。

修复后代码 #

ElevatedButton(
  onPressed: () async {
    try {
      // 拿到目标文档引用
      final targetDoc = FirebaseFirestore.instance
          .collection('tripdetails')
          .doc(user!.uid);

      // 等待更新操作执行完成
      await targetDoc.update({'noofdays': _nodays});

      // 如果需要兼容文档不存在、自动创建的场景，把上面的update替换为下面的set逻辑
      // await targetDoc.set(
      //   {'noofdays': _nodays},
      //   SetOptions(merge: true), // merge:true表示仅更新传入的字段，不覆盖文档其他已有内容
      // );

      debugPrint('noofdays字段更新成功');
    } catch (e) {
      // 打印错误日志方便排查
      debugPrint('字段更新失败，错误信息：$e');
    }
  },
  child: const Text("Update"),
),

仍不生效的排查项 #

替换代码后如果还是无法更新，逐一核对以下配置：

• 核对user!.uid的实际值，和Firebase控制台tripdetails集合下的文档ID完全匹配，无大小写错误、多余空格
• 核对_nodays的变量类型，和Firebase中noofdays的存储类型一致（比如字段存的是数字类型，就不要传字符串格式的数值）
• 检查Firebase安全规则配置，确认已登录的认证用户拥有tripdetails集合的写入权限，规则拦截会直接导致写入失败
• 确认App端Firebase初始化正常，用户处于登录状态，user对象非空

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