非空类型函数返回Null报错，firstWhere查询无匹配Product时如何处理

你遇到的报错有两个核心诱因：

1. 函数声明返回非空Product类型，但代码中没有显式return firstWhere的执行结果，编译器判定函数执行完毕会隐式返回null，违反空安全规则
2. 原生firstWhere方法默认在匹配不到元素时会抛出StateError，如果没有显式定义匹配失败的处理逻辑，编译器也会提示返回风险

根据你的业务场景可以选择以下任意一种处理方式：

方案1：匹配失败直接抛出异常 #

适合业务逻辑中prodId必然存在的场景（比如从已渲染的商品列表跳转查询），直接把异常抛给上层业务处理：

Product findProductById(String prodId) {
  return _productsList.firstWhere(
    (element) => prodId == element.id,
    orElse: () => throw StateError('未找到ID为$prodId的对应商品'),
  );
}

方案2：匹配失败返回null #

如果允许商品ID不存在的情况，把返回值改为可空类型Product?，匹配不到时返回null供上层做缺省处理：

Product? findProductById(String prodId) {
  return _productsList.firstWhere(
    (element) => prodId == element.id,
    orElse: () => null,
  );
}

调用时自行判断返回值是否为null，比如无匹配时跳转404页面、显示商品不存在提示等。

方案3：匹配失败返回默认商品 #

适合需要统一兜底展示的场景，提前定义好默认商品实例，匹配不到时返回该实例：

// 提前定义全局默认商品
const Product defaultProduct = Product(id: '0', name: '未知商品', price: 0);

Product findProductById(String prodId) {
  return _productsList.firstWhere(
    (element) => prodId == element.id,
    orElse: () => defaultProduct,
  );
}

如果项目引入了官方collection依赖包，可以直接使用扩展方法firstWhereOrNull简化代码，无需显式定义orElse逻辑：

Product? findProductById(String prodId) {
  return _productsList.firstWhereOrNull((element) => prodId == element.id);
}

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