更新pubspec.yaml后遇Flutter错误：无法无条件调用方法'[]'（接收者可为null）

错误翻译 #

错误：无法无条件调用方法'[]'，因为接收者可能为null

问题原因 #

这个错误是Dart空安全机制的提示——你代码里用[]访问的对象（比如Map、List）被编译器判定为可空类型（可能是null），而空安全不允许直接对可空对象调用方法/运算符。更新pubspec.yaml后触发，通常是因为依赖升级导致Dart版本切换到了空安全版本（SDK >=2.12.0），之前的非空安全代码现在会被严格检查。

具体解决办法 #

1. 非空断言（确定对象不为null时用） #

如果你能100%确认访问的对象不会是null，用!运算符告诉编译器跳过空检查：

// 原代码
var value = myMap['name'];
// 修改后
var value = myMap!['name'];

⚠️ 注意：如果运行时对象实际是null，会直接抛出空指针异常，谨慎使用。

2. 前置空判断 #

先检查对象是否为null，再执行访问操作：

if (myList != null) {
  var item = myList[0];
  // 处理item逻辑
}

3. 空值合并+可选链 #

用?.可选链访问，配合??空值合并运算符，在对象为null时返回默认值：

// 如果myMap是null，或者key不存在，都返回'unknown'
var value = myMap?['name'] ?? 'unknown';

4. 确保对象初始化非空 #

检查变量声明，确保Map/List在使用前已经被初始化，避免留为可空状态：

// 错误写法：可空且未初始化
Map? myMap;
// 正确写法1：直接初始化非空对象
Map myMap = {};
// 正确写法2：延迟初始化（确保使用前赋值）
late Map myMap;

5. 检查Dart SDK版本 #

打开pubspec.yaml，确认environment中的sdk版本是否开启了空安全：

environment:
  sdk: '>=2.12.0 <3.0.0'

如果是升级后开启的空安全，需要逐步把代码中的可空对象访问都按空安全规范修正。

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