Flutter使用firstWhere的orElse返回Null报错，对象类型如何处理？

架构老林

2026-8-10

解决Flutter中firstWhere返回null的类型错误问题

核心原因

你遇到的错误是因为firstWhere的orElse回调要求返回与列表元素同类型的非空值，如果你的People类是声明为非可空类型（即不是People?），返回null必然会触发类型不匹配错误。

具体解决方案

1. 改用`firstWhereOrNull`并声明方法返回可空类型

firstWhereOrNull本身就设计用来返回可空结果，只要你把searchPeople方法的返回类型改为People?即可，不需要修改People模型类：

People? searchPeople(List<People> peopleList, String targetId) {
  return peopleList.firstWhereOrNull((p) => p.id == targetId);
}

如果之前用firstWhereOrNull还是报错，大概率是你的方法返回类型仍然是People（非可空），导致返回的People?无法适配，调整返回类型即可。

2. 必须返回非空值时，提供默认`People`实例

如果业务逻辑要求searchPeople必须返回非空的People对象，那不能在orElse里返回null，而是要返回一个预设的默认实例：

People searchPeople(List<People> peopleList, String targetId) {
  return peopleList.firstWhere(
    (p) => p.id == targetId,
    orElse: () => People(id: 'default', name: '默认用户'), // 根据你的People类构造参数调整
  );
}

3. 可选：用空断言或空合并运算符处理可空结果

如果不想改方法返回类型，也可以在调用firstWhereOrNull时用!断言（需确保不会出现null，否则会崩溃），或者用??指定默认值：

People searchPeople(List<People> peopleList, String targetId) {
  return peopleList.firstWhereOrNull((p) => p.id == targetId)!;
  // 或者用默认值替代null
  // return peopleList.firstWhereOrNull((p) => p.id == targetId) ?? People(id: 'default', name: '默认用户');
}