Flutter空安全迁移报错：'Null'不是'String'的子类型

问题根源 #

appTextBox.get('mainPageTitle')可能返回null（比如对应key不存在时），但AppStrings的mainPageTitle参数是非空String类型，直接赋值触发空安全错误；改成返回AppStrings?后，调用该方法的代码要求传入非空AppStrings，因此出现类型不匹配。

方案1：给Hive查询设置默认值（推荐） #

直接在get方法中指定默认值，确保返回值永远是非空String，这样AppStrings实例化无需修改，方法也保持返回非空类型：

static Future<AppStrings> getAppText(String local) async {
  var appTextBox = await Hive.openBox("appTextBox");
  AppStrings appText = AppStrings(
    mainPageTitle: appTextBox.get('mainPageTitle', defaultValue: '默认首页标题'),
    // 其他参数同理，都加上defaultValue
    ....
  );
  return appText;
}

方案2：手动处理null值，确保返回非空AppStrings #

先判断Hive返回的是否为null，若为null则抛异常或使用默认值构建实例：

static Future<AppStrings> getAppText(String local) async {
  var appTextBox = await Hive.openBox("appTextBox");
  final mainTitle = appTextBox.get('mainPageTitle');
  if (mainTitle == null) {
    // 可选：抛异常提示数据缺失，或直接用默认值
    throw Exception("mainPageTitle 未在Hive中配置");
    // 或者替换为：
    // return AppStrings(mainPageTitle: '默认标题', ...);
  }
  AppStrings appText = AppStrings(
    mainPageTitle: mainTitle,
    ....
  );
  return appText;
}

方案3：允许返回可空AppStrings，修改调用处逻辑 #

如果确实需要保留AppStrings?的返回类型，调用该方法时必须处理可空情况：

// 1. 使用空安全判断
final appText = await getAppText(local);
if (appText != null) {
  // 正常使用appText
} else {
  // 处理null情况，比如显示默认内容
}

// 2. 使用??提供默认实例
final appText = await getAppText(local) ?? AppStrings(mainPageTitle: '默认标题', ...);

// 3. 确认不会为null时用!断言（谨慎使用，null时会崩溃）
final appText = await getAppText(local)!;

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