Flutter报错：MaterialApp Function()类型无法分配给指定参数类型

报错The argument type 'MaterialApp Function()' can't be assigned to the parameter type 'Widget Function(BuildContext, Widget)'是Flutter版本升级后，根节点嵌套组件的builder参数签名变更导致的类型不匹配。
常见触发场景是使用屏幕适配、全局状态管理、路由管理类第三方库（如flutter_screenutil、flutter_boost、MultiProvider）时，旧代码用了无参返回MaterialApp的写法，而新版本对应组件的builder参数要求传入接收两个位置参数（BuildContext上下文、Widget?子节点）的函数。

• 找到项目中根节点嵌套组件（通常是应用初始化最外层包裹MaterialApp的组件）的builder属性配置
• 把原来无参的builder函数，修改为匹配类型签名的写法即可，函数内部原有业务逻辑不需要改动

错误写法参考 #

// 旧版本兼容的无参写法，新版本会报类型错误
return ScreenUtilInit(
  builder: () {
    return MaterialApp(
      // 原有MaterialApp配置全部保留
      title: '应用名',
      theme: AppTheme.light,
      home: const SplashPage(),
    );
  },
);

正确写法参考 #

// 匹配新版本签名要求的写法
return ScreenUtilInit(
  builder: (BuildContext context, Widget? child) {
    return MaterialApp(
      // 原有MaterialApp配置和之前完全一致，不需要修改
      title: '应用名',
      theme: AppTheme.light,
      home: const SplashPage(),
    );
  },
);

如果修改完参数还存在其他兼容报错，可以检查pubspec.yaml中第三方依赖的版本，将依赖升级到和当前安装的Flutter版本匹配的稳定版本，能解决大部分版本迭代带来的API兼容问题。

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