Flutter报错：可选参数默认值必须为常量（Riverpod场景）

报错The default value of an optional parameter must be constant和Uint8List类型无直接关系，核心问题是类定义不符合Dart语法规则和Riverpod的状态要求：

• 错误对可空字段使用late关键字：late仅用于延迟初始化非空、无法在构造阶段赋值的字段，可空类型（后缀带?）默认值就是null，不需要late修饰，添加后会干扰Dart对可选参数默认值的常量校验。
• 类设计为可变状态：bio/image/imgId三个字段未加final修饰，可变状态本身不符合Riverpod的状态不可变最佳实践，也会触发静态分析的额外校验。
• Uint8List没有const默认构造函数，如果强行给它设置非null默认值（比如空字节数组）会触发常量报错，但默认值为null时完全合法，不需要强制替换为String类型。

方案1：保留Uint8List类型（无需修改字段类型） #

做3处调整即可解决问题：

1. 移除三个可空字段前的late关键字，所有字段添加final修饰，保证状态不可变
2. 给主构造函数添加const修饰符，可选参数无需额外设置默认值（null本身是合法编译时常量）
3. 修正列表相等判断和hashCode计算逻辑，避免Uint8List值比较错误

修改后的完整代码：

import 'dart:typed_data';

/// [NoSignalUser]
/// 应用内使用的普通用户模型，包含业务所需的全部字段
class NoSignalUser {
  final String id;
  final String name;
  final String email;
  final String? bio;
  final Uint8List? image;
  final String? imgId;
  const NoSignalUser({
    required this.id,
    required this.name,
    required this.email,
    this.bio,
    this.image,
    this.imgId,
  });

  NoSignalUser copyWith({
    String? id,
    String? name,
    String? email,
    String? bio,
    Uint8List? image,
    String? imgId,
  }) {
    return NoSignalUser(
      id: id ?? this.id,
      name: name ?? this.name,
      email: email ?? this.email,
      bio: bio ?? this.bio,
      image: image ?? this.image,
      imgId: imgId ?? this.imgId,
    );
  }

  Map<String, dynamic> toMap() {
    return {
      'id': id,
      'name': name,
      'email': email,
      'bio': bio,
      'imgId': imgId,
    };
  }

  factory NoSignalUser.fromMap(Map<String, dynamic> map) {
    return NoSignalUser(
      id: map['id'] as String,
      name: map['name'] as String,
      email: map['email'] as String,
      bio: map['bio'] as String?,
      imgId: map['imgId'] as String?,
      image: map['image'] as Uint8List?,
    );
  }

  @override
  bool operator ==(Object other) {
    if (identical(this, other)) return true;

    return other is NoSignalUser &&
        other.id == id &&
        other.name == name &&
        other.email == email &&
        other.bio == bio &&
        other.image?.length == image?.length &&
        other.imgId == imgId;
  }

  @override
  int get hashCode {
    return Object.hash(id, name, email, bio, image, imgId);
  }
}

注意：如果需要序列化Uint8List字段，建议先转成base64字符串再存入Map，使用时再解码回Uint8List即可。

方案2：替换Uint8List为String类型（按需选择） #

如果需要将图片字段改为String类型（存储网络图片URL、base64编码图片字符串等），仅需将image字段类型从Uint8List?改为String?，其余逻辑和方案1完全一致，const构造函数天然符合常量要求，不会触发报错。

对应字段修改示例：

// 替换原Uint8List类型
final String? image;
const NoSignalUser({
  required this.id,
  required this.name,
  required this.email,
  this.bio,
  this.image, // 默认值为null，是合法常量
  this.imgId,
});

• 如果需要给可选参数设置非null默认值，比如bio默认空字符串、imgId默认空字符串，直接显式赋值this.bio = ''、this.imgId = ''即可，空字符串是编译时常量，不会触发报错。
• 不要给Uint8List?类型的image字段设置Uint8List(0)作为默认值，Uint8List的默认构造不是const构造，该值不是编译时常量，会直接触发本次遇到的报错，保持默认null即可。

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