Dart出现Non-nullable instance field必须初始化报错该如何解决？

报错成因 #

Dart 2.12及以上版本默认开启空安全规则，所有非空类型（未加?后缀的类型）变量必须在编译期完成初始化，且运行时不能被赋值为null。
类的非空类型实例字段如果没有满足以下任意一个条件，就会触发Non-nullable instance field 'xxx' must be initialized报错：

• 声明时直接赋值初始化
• 在构造函数参数中通过this.xxx绑定赋值
• 在构造函数的初始化列表中完成赋值

规范处理方案 #

方案1：声明时直接初始化 #

适合字段默认值固定的场景，是安全性最高的处理方式：

class Demo {
  // 声明时直接赋值
  String url = 'https://default-domain.com';
  List<Article> articles = [];
}

方案2：构造函数阶段赋值 #

适合字段值需要由实例化时传入的场景：

class Demo {
  String url;
  List<Article> articles;

  // 方式1：构造参数直接绑定字段
  Demo(this.url, this.articles);

  // 方式2：初始化列表赋值，适合需要对入参做二次处理的场景
  // Demo(String inputUrl, List<Article> inputArticles):
  //   url = inputUrl.trim(),
  //   articles = List.unmodifiable(inputArticles);
}

方案3：使用late关键字延迟初始化 #

仅适合你可以完全保证字段在第一次被访问前一定会被赋值的场景（比如异步请求后赋值、依赖其他实例逻辑赋值）：

注意：如果late修饰的字段在首次访问前未赋值，运行时会直接抛出LateInitializationError异常

class Demo {
  late String url;
  late List<Article> articles;

  Future<void> fetchData() async {
    final res = await http.get(Uri.parse('xxx'));
    // 访问前完成赋值
    url = res.data['url'];
    articles = res.data['articles'].map<Article>((e) => Article.fromJson(e)).toList();
  }
}

方案4：改为可空类型 #

如果字段本身逻辑上就允许为null，直接在类型后加?声明为可空类型即可：

class Demo {
  // 可空类型默认初始值为null，不会触发初始化报错
  String? url;
  List<Article>? articles;
}

说明：可空类型的字段在使用前需要做空类型判断，或确认不为空时用!强制解包，避免空安全运行时报错。

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