You need to enable JavaScript to run this app. Flutter Firestore取数报String非Map<String,dynamic>子类型错误
优惠活动
大模型
产品
解决方案
定价
更多

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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.27 17:06:08