Dart编写返回Future<String?>的异步函数出现类型不匹配错误如何解决

错误原因 #

Dart的Future泛型会沿着调用链向下推导，你调用的Future.delayed没有显式声明泛型类型，后续then闭包返回了null，Dart就自动推导整个Future链的返回值类型为Null，因此onError闭包的返回值要求匹配FutureOr<Null>类型，你返回的"failed"是String类型，不符合类型约束，就触发了报错。

修正方案 #

有两种常见修正方式：

方式1：显式声明Future泛型 #

给Future.delayed指定泛型为String?，明确整个Future链的返回值类型为可空字符串，即可匹配类型要求：

Future<String?> fcn(String str) {
  return Future<String?>.delayed(const Duration(seconds: 1)).then((value) {
    return null;
  }).onError((error, stackTrace) {
    return "failed";
  });
}

方式2：改用async/await语法 #

使用async/await加try-catch的写法逻辑更清晰，也能避免Future链式调用的类型推导问题：

Future<String?> fcn(String str) async {
  try {
    await Future.delayed(const Duration(seconds: 1));
    return null;
  } catch (_) {
    return "failed";
  }
}

内容的提问来源于stack exchange，提问作者Steven Z.