如何用Flutter表单读取Firestore文档数据及排查类型错误

错误根源 #

你触发的Expected a value of type DocumentSnapshot<Object?>, but got one of type String错误，核心是页面跳转时传递的数据类型与目标页面接收类型不匹配：

• 在ReadAdd页面跳转时，你传入的docid是字符串格式的账号编号
• 但editnote页面的参数定义要求接收DocumentSnapshot类型，直接导致类型冲突

修复步骤 #

1. 修改editnote组件的参数定义 #

将原本接收DocumentSnapshot的参数改为接收字符串类型的文档ID、年份、月份：

class editnote extends StatefulWidget {
  final String docId; // 改为字符串类型
  final String year;
  final String month;

  editnote({required this.docId, required this.year, required this.month});

  @override
  _editnoteState createState() => _editnoteState(docId: docId, year: year, month: month);
}

class _editnoteState extends State<editnote> {
  final String docId;
  final String year;
  final String month;
  DocumentSnapshot? docSnapshot; // 新增变量存储文档快照

  _editnoteState({required this.docId, required this.year, required this.month});
  
  // 保留原有控制器和其他变量...

2. 在editnote内部获取Firestore文档快照 #

在initState中根据传入的ID、年份、月份，主动去Firestore查询对应的文档：

@override
void initState() {
  super.initState();
  _activateListeners();
  _fetchDocument(); // 新增获取文档的异步方法
}

// 新增获取文档的方法
Future<void> _fetchDocument() async {
  try {
    final doc = await FirebaseFirestore.instance
        .collection('customer')
        .doc(docId)
        .collection(year)
        .doc(month)
        .get();
    
    if (doc.exists) {
      setState(() {
        docSnapshot = doc;
        // 获取到文档后再初始化控制器
        AccountNumber = TextEditingController(text: docSnapshot!.get('AccountNumber'));
        // 其他控制器可按需初始化：
        // CustomerName = TextEditingController(text: docSnapshot!.get('CustomerName'));
        // LastRead = TextEditingController(text: docSnapshot!.get('LastRead'));
      });
    } else {
      ScaffoldMessenger.of(context).showSnackBar(
        const SnackBar(content: Text('未找到对应文档')),
      );
    }
  } catch (e) {
    print('加载文档失败: $e');
    ScaffoldMessenger.of(context).showSnackBar(
      const SnackBar(content: Text('数据加载失败')),
    );
  }
}

3. 修正ReadAdd页面的跳转参数 #

之前的AccountNumber变量仅在initState时赋值，输入框内容更新后不会同步，跳转时直接使用控制器的实时文本：

Navigator.push(
  context,
  MaterialPageRoute(
    builder: (_) => editnote(
      docId: _controllerAccountnumber.text, // 直接用控制器的实时文本
      year: _controlleryear.text,
      month: _controllermonth.text
    )
  ),
);

4. 修正editnote的文档更新逻辑 #

现在通过ID定位文档，更新时需要重新获取文档引用：

// 替换原有的widget.docid.reference.update逻辑
await FirebaseFirestore.instance
    .collection('customer')
    .doc(docId)
    .collection(year)
    .doc(month)
    .update({
  'CustomerName': CustomerName.text,
  'LastRead': LastRead.text,
  'NewRead': displayUnit,
  'Total': displayUnit,
});

额外提示 #

• 务必处理文档不存在、查询失败等异常场景，避免崩溃并提升用户体验
• 控制器初始化必须在获取到文档快照后执行，防止空指针错误

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