Flutter可空列表使用Null check operator报空值错误解决方法

你遇到的Null Check Operator used on null value是Dart空安全机制的常见报错，本质是代码中使用空断言操作符!强制标记一个可空变量为非空，但运行时该变量实际为null，触发运行时异常。
你代码中报错行Address address = systemData.addresses![index];的问题在于：systemData.addresses是List<Address>?可空类型，当接口数据未加载完成、返回数据中缺失addresses字段时，addresses本身就是null，此时直接加!强行取值就会报错。
除此之外你的代码中还有大量同类风险点：比如address.line1Address!、systemData.facebook!、biography!等位置都用了硬空断言，只要对应字段为null就会触发同类报错。

• 列表取值前做空校验，不要直接对可空的addresses列表做!断言，取值前先判断列表是否为空、索引是否合法，不满足条件时返回空占位组件即可
• 替换所有硬空断言，加空值兜底：文本类字段用??操作符设置null时的兜底值，交互类字段（点击跳转链接、拨打电话）为null时将按钮置为不可点击状态
• 修复Model层的空安全隐患，避免状态比对时触发空报错

具体代码修改 #

1. AddressTile的build方法入口修改 #

@override
Widget build(BuildContext context) {
  final addressList = systemData.addresses;
  // 地址列表不存在、或者索引超出列表长度时，返回空组件避免报错
  if (addressList == null || index < 0 || index >= addressList.length) {
    return const SizedBox.shrink();
  }
  final Address address = addressList[index];

  // 后续原有布局逻辑保留
  return Container(
    // ... 原有Container代码不变

2. 文本字段空安全修改 #

• 地址第一行文本，把address.line1Address!替换为address.line1Address ?? ''
• 详细地址拼接部分，原硬断言拼接代码替换为过滤null后拼接的逻辑，避免出现多余空格：

AutoSizeText(
  [
    address.line2Address,
    address.township,
    address.state,
    address.country,
    address.postalCode
  ].whereType<String>().join(' '),
  style: const TextStyle(fontSize: 16),
),

3. 交互按钮空安全修改 #

以第一个电话按钮为例，原硬断言代码替换为：

final phone1 = address.phone1;
TextButton(
  style: TextButton.styleFrom(
    textStyle: const TextStyle(fontSize: 16),
  ),
  // 手机号为null时按钮自动置为不可点击状态
  onPressed: phone1 == null ? null : () {
    launchURL("tel:$phone1");
  },
  child: Text(phone1 ?? ''),
),

第二个电话按钮、底部Facebook/Messenger/Youtube跳转按钮都按相同逻辑修改，先把可空字段存为局部变量，判断为null时禁用按钮点击，文本部分用空字符串兜底即可。

4. Model层空安全修复 #

system_data.dart中SystemData类的props方法原硬断言代码：

@override
List<Object> get props => [biography!];

替换为全字段非断言写法，避免状态比对时触发空报错：

@override
List<Object?> get props => [
  biography,
  headMonkImageUrl,
  headMonkThumbnail,
  aboutThitsarparami,
  addresses,
  facebook,
  messenger,
  youtube,
  apk,
  fbShareMonk,
  fbShareAlbum,
  fbShareDhammaTalk,
  youtubeLive
];

内容的提问来源于stack exchange，提问作者Alex Aung