Flutter Firestore更新布尔字段报错：String不是DocumentReference的子类型

错误根源 #

你遇到的type 'String' is not a subtype of type 'DocumentReference'错误原因非常明确：
Firestore的transaction.get()、transaction.update()方法要求传入的是DocumentReference类型的文档引用对象，而你代码中传入的todoid是纯字符串类型的文档ID，类型不匹配直接触发异常，导致事务内部代码不会执行。

修复方案 #

1. 直接优化invertDone函数（兼容现有逻辑） #

你不需要额外提取文档ID存储，直接用查询到的文档引用操作即可，同时把全局变量改为函数内局部变量，避免全局状态污染，优化后的代码如下：

Future<void> invertDone(String task) async {
  try {
    // 查询匹配的任务文档
    final snapshot = await todo.where('task', isEqualTo: task).get();
    for (var doc in snapshot.docs) {
      final docRef = doc.reference; // 直接拿到DocumentReference类型对象
      print('匹配到的文档ID: ${docRef.id}');
      // 执行事务
      await FirebaseFirestore.instance.runTransaction((transaction) async {
        final docSnapshot = await transaction.get(docRef);
        if (!docSnapshot.exists) {
          throw Exception("任务文档不存在");
        }
        bool currentDone = docSnapshot.get('done');
        print('原状态: $currentDone');
        currentDone = !currentDone;
        print('更新后状态: $currentDone');
        transaction.update(docRef, {'done': currentDone});
      });
      print('任务状态更新成功');
    }
  } catch (e) {
    print('更新失败: $e');
  }
}

2. 更高效率的优化方案（推荐） #

你在列表渲染时已经拿到了任务的DocumentSnapshot对象，完全不需要在invertDone里再按task字段二次查询，直接把文档引用传进去即可，修改步骤如下：

第一步 修改invertDone入参

Future<void> invertDone(DocumentReference docRef) async {
  try {
    print('待更新的文档ID: ${docRef.id}');
    await FirebaseFirestore.instance.runTransaction((transaction) async {
      final docSnapshot = await transaction.get(docRef);
      if (!docSnapshot.exists) {
        throw Exception("任务文档不存在");
      }
      bool currentDone = docSnapshot.get('done');
      print('原状态: $currentDone');
      currentDone = !currentDone;
      print('更新后状态: $currentDone');
      transaction.update(docRef, {'done': currentDone});
    });
    print('任务状态更新成功');
  } catch (e) {
    print('更新失败: $e');
  }
}

第二步 修改调用处代码

在CheckboxListTile的onChanged回调里，直接传入当前任务的reference：

onChanged: isCaretaker
    ? (bool value) {
        print('do u want to delete ');
      }
    : (bool value) {
        print('initially checked is $_checked');
        setState(() {
          _checked = value;
          print(_checked.toString());
        });
        invertDone(task.reference); // 直接传当前文档的引用，不需要二次查询
      },

额外注意事项 #

• 原来的全局变量temp、todoid完全不需要，改为函数内局部变量即可，避免多任务操作时全局变量被覆盖导致逻辑错误
• 优先用async/await写法替代嵌套then，代码可读性更高，异常捕获也更方便
• 如果不需要强一致的原子操作，你甚至可以不用事务，直接调用docRef.update({'done': !currentDone})即可完成状态翻转，代码更简洁

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