You need to enable JavaScript to run this app. Flutter 基于数据库数据构建饼形图表运行时返回空值报错
优惠活动
大模型
产品
解决方案
定价
更多

Flutter 基于数据库数据构建饼形图表运行时返回空值报错

基于数据库业务数据构建饼图的空值错误排查

问题场景

  • 开发目标:基于数据库存储的交易业务数据,渲染饼形可视化图表
  • 实际运行表现:项目启动后直接抛出空值类运行异常,对应报错截图可查看:报错截图
  • 异常触发位置:构造饼图渲染依赖的Series数据序列环节,通过Provider获取交易数据、组装图表数据集时出现空值取值错误

触发异常的原始核心代码

List<charts.Series<Transactions, String>> _series(BuildContext context) {

    final myTransaction = Provider.of<Transaction>(context).myTransaction;

    List<Transactions> data = List<Transactions>();
    data.add(Transactions(category: myTransaction.category, amount: myTransaction.amount, color: myTransaction.color));

    return [
      charts.Series<Transactions, String>(
          id: 'Transactions',
          domainFn: (Transactions transactions, _) => transactions.category,
          measureFn: (Transactions transactions, _) => transactions.amount,
          labelAccessorFn: (Transactions transactions, _) => '\$${transactions.amount}',
          colorFn: (Transactions transactions, _) =>
              charts.ColorUtil.fromDartColor(
                  HexColor.fromHex(transactions.color)),
          data: data
      )
    ];
  }

空值异常根因定位

对照代码逻辑,空值抛出的触发点集中在3个环节:

  • Provider.of<Transaction>(context) 无法在当前组件树中匹配到对应Provider实例,返回null,后续直接访问实例下的myTransaction属性触发空指针
  • 从Provider链路取到的myTransaction对象本身为null,代码未做任何判空校验,直接读取对象下的category/amount/color字段
  • 数据库层未返回匹配的交易数据时,代码默认认为myTransaction一定有值,未对空数据场景做兜底

可落地的修复方案

  • 全链路增加空值兜底逻辑,禁止无防护的链式取值。对Provider返回的嵌套对象逐层校验,无有效交易数据时返回带占位内容的空饼图序列,避免空指针。修复后的参考代码:
    List<charts.Series<Transactions, String>> _series(BuildContext context) {
      // 分层获取Provider实例,避免无监听场景下的重复重建
      final transactionProvider = Provider.of<Transaction>(context, listen: false);
      final myTransaction = transactionProvider.myTransaction;
    
      // 无有效交易数据时,返回占位饼图
      if (myTransaction == null) {
        return [
          charts.Series<Transactions, String>(
            id: 'empty',
            domainFn: (_, __) => '暂无交易数据',
            measureFn: (_, __) => 1,
            data: [Transactions(category: '暂无交易数据', amount: 1, color: '#E0E0E0')]
          )
        ];
      }
    
      // 有有效数据时,逐字段做空值兜底
      final safeData = Transactions(
        category: myTransaction.category ?? '未分类交易',
        amount: myTransaction.amount ?? 0,
        color: myTransaction.color ?? '#9E9E9E'
      );
      final dataList = [safeData];
    
      return [
        charts.Series<Transactions, String>(
          id: 'Transactions',
          domainFn: (Transactions transactions, _) => transactions.category,
          measureFn: (Transactions transactions, _) => transactions.amount,
          labelAccessorFn: (Transactions transactions, _) => '\$${transactions.amount}',
          colorFn: (Transactions transactions, _) =>
              charts.ColorUtil.fromDartColor(
                  HexColor.fromHex(transactions.color)),
          data: dataList
        )
      ];
    }
    
  • 排查Provider的注入位置,确认Transaction类型的Provider挂载在当前图表组件的上层组件树中,避免跨层级取值无法匹配实例
  • 若需展示全量交易分类的金额占比,不要仅取单条交易数据,需要从Provider返回的全量交易列表中,按交易分类维度聚合累加同分类的总金额,再将聚合结果存入data列表
  • 给Hex颜色解析逻辑增加异常捕获,当存储的颜色值不符合Hex格式规则时,使用默认兜底颜色,避免解析环节抛出非预期异常

内容的提问来源于stack exchange,提问作者Ratthatpat Aiamsamang

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.10.29 20:06:04