invalid_return_type_for_catch_error

A value of type '{0}' can't be returned by the 'onError' handler because it must be assignable to '{1}'.

The return type '{0}' isn't assignable to '{1}', as required by 'Future.catchError'.

The analyzer produces this diagnostic when an invocation of Future.catchError has an argument whose return type isn't compatible with the type returned by the instance of Future. At runtime, the method catchError attempts to return the value from the callback as the result of the future, which results in another exception being thrown.

The following code produces this diagnostic because future is declared to return an int while callback is declared to return a String, and String isn't a subtype of int:

void f(Future<int> future, String Function(dynamic, StackTrace) callback) {
  future.catchError(callback);
}

The following code produces this diagnostic because the closure being passed to catchError returns an int while future is declared to return a String:

void f(Future<String> future) {
  future.catchError((error, stackTrace) => 3);
}

If the instance of Future is declared correctly, then change the callback to match:

void f(Future<int> future, int Function(dynamic, StackTrace) callback) {
  future.catchError(callback);
}

If the declaration of the instance of Future is wrong, then change it to match the callback:

void f(Future<String> future, String Function(dynamic, StackTrace) callback) {
  future.catchError(callback);
}

除非另有说明，文档之所提及适用于 Dart 3.7.3 版本，本页面最后更新时间: 2025-05-08。 查看文档源码 或者 报告页面问题。