带命名参数的Callback函数无法运行，类型不匹配问题求助

问题根源 #

你的错误本质是回调函数返回值类型不匹配+命名参数签名不一致，错误提示里的“可空”是Dart类型系统的表述偏差，核心问题不是可空性，而是以下两点：

1. 返回值类型冲突：
   • 你定义的回调参数是void Function({bool success})，要求回调是同步函数（返回void）
   • 但调用时传的是async修饰的函数，这类函数实际返回Future<void>，属于异步函数，和定义的void返回类型完全不兼容
2. 命名参数语法不统一：
   • 函数定义里的回调参数是{bool success}，属于可选命名参数（无required修饰）
   • 但调用时的回调函数声明了({required bool success})，把参数设为必填命名参数，两者签名不匹配

修复方案 #

根据你的需求（布尔值用命名参数），分两种场景修复：

场景1：回调需要执行异步操作（推荐） #

直接把函数定义里的回调类型改成异步函数，同时统一参数为必填命名：

static Future<void> showConfirmationModal({
  required BuildContext context,
  required Future<void> Function({required bool success}) callback,
}) async {
  // doing stuff
  await callback(success: true); // 加await确保异步操作完成
}

调用时保持原有写法即可：

OverlayModal.showConfirmationModal(
  context: context,
  callback: ({required bool success}) async {
    if (success) {
      // 执行异步操作，比如网络请求、状态更新
    }
  },
);

场景2：回调仅需同步操作 #

去掉调用时的async关键字，同时统一函数定义和调用的必填命名参数：

// 函数定义
static Future<void> showConfirmationModal({
  required BuildContext context,
  required void Function({required bool success}) callback,
}) async {
  // doing stuff
  callback(success: true);
}

// 调用代码
OverlayModal.showConfirmationModal(
  context: context,
  callback: ({required bool success}) {
    if (success) {
      // 执行同步操作
    }
  },
);

为什么不用命名参数时没问题？ #

当使用位置参数void Function(bool success)时，Dart会允许隐式兼容异步函数（忽略返回的Future），但命名参数的类型检查更严格，不会允许这种隐式转换，所以才会报错。

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