Flutter中'key为必填参数但无对应实参'错误的解决方法

问题根源 #

你遇到的报错是因为VideoCall构造函数中key参数的声明不符合Null Safety规范：要么被错误标记为required，要么非空参数没有默认值/可空声明，导致调用时必须传参，而移除required后又触发非空校验错误。

两种有效解决方法 #

方法一：使用Flutter推荐的super.key语法（优先选择）

在Flutter 2.12及以上版本，StatefulWidget的构造函数可以直接通过super.key传递key，无需单独声明Key参数，这样key默认是可选参数，不需要强制传入：

class VideoCall extends StatefulWidget {
  final String channelName;
  final ClientRole role;

  const VideoCall({
    super.key, // 直接使用super.key，无需自己定义Key变量
    required this.channelName,
    required this.role,
  });

  @override
  _VideoCallState createState() => _VideoCallState();
}

修改后，你原来调用VideoCall的代码完全不需要改动，直接运行即可消除报错。

方法二：兼容旧写法的Null Safety声明

如果你需要保留旧写法，必须将Key参数声明为可空类型（加?），确保移除required后符合非空校验规则：

class VideoCall extends StatefulWidget {
  final String channelName;
  final ClientRole role;

  const VideoCall({
    Key? key, // 标记为可空类型
    required this.channelName,
    required this.role,
  }) : super(key: key);

  @override
  _VideoCallState createState() => _VideoCallState();
}

这种写法下，key是可选参数，调用时不传也不会触发必填报错。

为什么之前的操作会报错？ #

• 最初的必填报错：说明你的VideoCall构造函数中key被标记为required，调用时未传参触发校验。
• 加key后新错误：大概率是传入的key值为null，但构造函数中Key参数被声明为非空类型，触发Null Safety错误。
• 移除required后报错：因为Null Safety下，非空参数必须有默认值或标记为可空，你之前的Key key是非空且无默认值，移除required后依然不符合规范。

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