Dart使用泛型类型定义时出现函数类型不匹配运行时异常的原因
异常根本原因拆解
核心问题是Dart 的函数类型参数逆变规则 + 泛型类型推断偏差共同触发的运行时类型不匹配,和你声明的ListItemBuilder typedef 本身的语法设计没有关系。
核心规则对应
- Dart 判定函数类型是否兼容时,对参数采用逆变逻辑:如果要让函数X能被当作类型为Y的函数变量使用,函数X的参数类型范围必须大于等于Y的参数类型范围。
举个直观的例子:
(PageResult) => void的函数,是可以直接赋值给(QueryPageResult) => void类型的变量的——因为这个函数能处理所有QueryPageResult实例(毕竟QueryPageResult是PageResult子类);但反过来,只接收QueryPageResult的函数,绝对不能赋值给要求接收PageResult的变量——因为调用方可能传入根本不是QueryPageResult的其他PageResult子类实例,这个窄范围的函数根本处理不了。 - 你的报错信息里,实际传入的
itemBuilder是参数范围很窄的(QueryPageResult<ResolutionCase>, int) => XCardView,但当前调用环境要求它匹配的类型是(PageResult, int) => Widget,前者的参数范围远小于后者的要求,自然触发类型不匹配。
最容易触发这个问题的代码场景
对照你写的Paginator组件,绝大多数情况是两个写法偏差导致的:
- 组件内部取分页数据时,没有按照组件定义的泛型
P的类型持有数据,反而硬转成了基类PageResult再传给itemBuilder调用。典型错误写法:
这种写法下,哪怕你初始化Paginator时传对了itemBuilder,内部调用时传的参数类型是宽范围的基类,和itemBuilder声明要求的窄范围泛型参数不匹配,就会抛错。// 错误:内部把泛型P的数据硬转成PageResult基类 final pageData = await dataSource.loadPage() as PageResult; widget.itemBuilder(pageData, itemIndex); - 初始化Paginator的时候没有显式指定泛型参数,让Dart自动推断成了最宽泛的
Paginator<PageResult>,这时候组件要求传入的itemBuilder必须是能接收所有PageResult子类的宽参数函数,和你实际传的窄参数函数天然不兼容。
正确的写法对齐方式
- 组件内部分页数据源的返回类型要和组件泛型对齐,即获取分页数据的方法返回值必须是
Future<P>,不要返回Future<PageResult>再做内部强转。 - 实例化Paginator时显式标注泛型类型,比如直接写
Paginator<QueryPageResult<ResolutionCase>>(itemBuilder: yourBuilder),避免自动推断成基类泛型。
内容的提问来源于stack exchange,提问作者UdaraWanasinghe
相关产品推荐
相关产品推荐

