Flutter Firestore取数报String非Map<String,dynamic>子类型错误
报错核心原因解析
- 类型不匹配的直接触发点在
MyProvider类的fetchData方法中:类内定义的_names属性类型是Map<String, dynamic>,但原代码中将data['Sunday']直接赋值给_names,而该字段存储的是通过setName写入的字符串类型日程文本,字符串类型无法直接赋值给Map类型变量,直接触发运行时类型异常。 - 文档ID逻辑不一致:写入数据时使用当前登录用户的
uid作为文档ID,但拉取数据时硬编码了固定文档ID4igqxvELvzSvbYSqDre6eHlq29Y2,拉取的数据源和写入的数据源完全不匹配,就算修正类型问题也会出现数据错位。 - 状态更新逻辑缺失:拉取到数据赋值给
_names后没有调用notifyListeners(),就算数据加载完成,绑定了Provider的UI也不会自动刷新展示新内容。 - 方法调用时机错误:在
PlannerScreen的build方法中直接调用fetchData,会导致每次页面重建时都重复发起Firestore网络请求,甚至引发异常的渲染循环,带来不必要的性能消耗。
可直接运行的修正方案
修正后的MyProvider核心代码
import 'package:flutter/material.dart'; import 'package:firebase_auth/firebase_auth.dart'; import 'package:cloud_firestore/cloud_firestore.dart'; class MyProvider extends ChangeNotifier { Map<String, dynamic> _names = {}; String name(String key) => _names[key]?.toString() ?? ''; void setName(String key, String newString) async { // 判空避免存入无意义的空值 if (newString == null || newString.trim().isEmpty) return; _names[key] = newString; var firebaseUser = FirebaseAuth.instance.currentUser; if (firebaseUser == null) return; // 同步更新本地状态 notifyListeners(); // 写入Firestore,开启合并模式避免全量覆盖清空其他字段 await FirebaseFirestore.instance .collection('Notes') .doc(firebaseUser.uid) .set(_names, SetOptions(merge: true)); } Future<void> fetchData() async { var firebaseUser = FirebaseAuth.instance.currentUser; if (firebaseUser == null) return; // 用当前用户的uid作为文档ID,和写入逻辑保持一致 var documentSnapshot = await FirebaseFirestore.instance .collection('Notes') .doc(firebaseUser.uid) .get(); if (documentSnapshot.exists) { // 强转文档数据为Map类型,避免动态类型带来的运行时问题 Map<String, dynamic> data = documentSnapshot.data() as Map<String, dynamic>; // 把整个文档的Map赋值给_names,而不是取单个字段的字符串值 _names = data; // 通知监听的UI刷新 notifyListeners(); } else { print('The document does not exist on the database'); } } }
修正后的Planner页面逻辑
将fetchData的调用从build方法移到initState中,避免重复请求:
class _PlannerScreenState extends State<PlannerScreen> { @override void initState() { super.initState(); // 页面初始化完成、第一帧渲染结束后只拉取一次数据 WidgetsBinding.instance.addPostFrameCallback((_) { Provider.of<MyProvider>(context, listen: false).fetchData(); }); } @override Widget build(BuildContext context) { // 移除原build方法中的fetchData调用 var size = MediaQuery.of(context).size; // 后续原有布局代码保持不变 ... } }
其他优化点
- 原来代码中调用Firestore的
set方法时没有加SetOptions(merge: true),每次写入会把整个文档的旧内容全部覆盖,开启合并模式后只会更新当前操作的字段,不会意外清空其他星期的日程内容。 name获取方法中增加了空值判断,避免字段不存在时抛出空指针异常。- 拉取数据的方法改为async/await的写法,减少回调嵌套,代码可读性更高。
内容的提问来源于stack exchange,提问作者Kristina
相关产品推荐
相关产品推荐

