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
相关产品推荐
相关产品推荐

