Dart空安全问题：更新Map元素值时触发接收器为null报错

问题根源 #

你遇到的错误是因为cartItems.value[product]返回的是int?类型——当product不在购物车Map中时，这个表达式会返回null，而Dart的空安全不允许对可能为null的对象直接调用++或--运算符。

你之前添加的cartItems.value![product]只是断言了cartItems.value这个Map本身不为null，但并没有处理Map中对应product的值可能为null的情况，所以问题依然存在。

解决方案 #

这里提供几种可行的修改方式，根据你的业务需求选择：

1. 显式判断值是否存在并处理 #

void updateCart(Product product, String type) {
  if (type == "plus") {
    final currentCount = cartItems.value[product];
    if (currentCount != null) {
      cartItems.value[product] = currentCount + 1;
    } else {
      // 商品首次加入购物车，初始数量设为1
      cartItems.value[product] = 1;
    }
  } else {
    final currentCount = cartItems.value[product];
    if (currentCount != null && currentCount > 0) {
      cartItems.value[product] = currentCount - 1;
      // 可选：如果数量减到0，从购物车移除该商品
      if (cartItems.value[product] == 0) {
        cartItems.value.remove(product);
      }
    }
    // 若商品不存在或数量已为0，可忽略或添加提示逻辑
  }
}

2. 使用空合并运算符简化代码 #

利用??给null值设置默认值0，再进行运算：

void updateCart(Product product, String type) {
  if (type == "plus") {
    cartItems.value[product] = (cartItems.value[product] ?? 0) + 1;
  } else {
    final currentCount = cartItems.value[product] ?? 0;
    if (currentCount > 0) {
      cartItems.value[product] = currentCount - 1;
      // 可选：移除数量为0的商品
      if (cartItems.value[product] == 0) {
        cartItems.value.remove(product);
      }
    }
  }
}

3. 使用Map的update方法（最优雅） #

Dart的Map提供了update方法，可以直接处理存在/不存在的情况，代码更简洁：

void updateCart(Product product, String type) {
  if (type == "plus") {
    cartItems.value.update(
      product,
      // 商品已存在时，数量+1
      (count) => count + 1,
      // 商品不存在时，初始化为1
      ifAbsent: () => 1,
    );
  } else {
    cartItems.value.update(
      product,
      // 商品已存在且数量>0时，数量-1；否则保持0
      (count) => count > 0 ? count - 1 : 0,
      // 商品不存在时，设为0（后续可移除）
      ifAbsent: () => 0,
    );
    // 移除数量为0的商品
    if (cartItems.value[product] == 0) {
      cartItems.value.remove(product);
    }
  }
}

补充说明 #

需要注意Product类要正确重写==运算符和hashCode方法，否则Map无法正确识别相同的Product对象，会导致同一个商品被当成不同的键处理。如果还没重写，示例如下：

class Product {
  final String id;
  final String name;
  // 其他属性...

  Product({required this.id, required this.name});

  @override
  bool operator ==(Object other) =>
      identical(this, other) ||
      other is Product &&
          runtimeType == other.runtimeType &&
          id == other.id;

  @override
  int get hashCode => id.hashCode;
}

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