Flutter空安全升级报错：类型'Null'无法转为'String'

问题原因 #

Hive的box.get()方法在未找到对应key时会返回null，而你的AppStrings类所有字段均为非空String类型。空安全启用后，null无法直接赋值给非空变量，因此触发类型转换异常。

解决方案 #

根据业务需求选择以下任意一种方案：

方案1：为Hive获取方法设置默认值

给每个get()调用添加defaultValue参数，确保返回值永远是非空字符串，即使Hive中不存在对应key：

static Future<AppStrings> getAppText(String local) async {
  var appTextBox = await Hive.openBox("appTextBox");
  AppStrings appText = AppStrings(
    mainPageTitle: appTextBox.get('mainPageTitle', defaultValue: '默认标题'),
    timeText: appTextBox.get('timeText', defaultValue: '时间'),
    minutesText: appTextBox.get('minutesText', defaultValue: '分钟'),
    mainPageSubtitle: appTextBox.get('mainPageSubtitle', defaultValue: '副标题'),
    mainPageParagraph: appTextBox.get('mainPageParagraph', defaultValue: '段落内容'),
    mainPageButton: appTextBox.get('mainPageButton', defaultValue: '按钮'),
    restartButton: appTextBox.get('restartButton', defaultValue: '重启'),
    backButton: appTextBox.get('backButton', defaultValue: '返回'),
    profileTitle: appTextBox.get('profileTitle', defaultValue: '个人中心'),
    loadingPageSubtitle: appTextBox.get('loadingPageSubtitle', defaultValue: '加载中...'),
    loadingPageBottomText: appTextBox.get('loadingPageBottomText', defaultValue: '请稍候'),
    loadingPageTitle: appTextBox.get('loadingPageTitle', defaultValue: '加载'),
    profileButton: appTextBox.get('profileButton', defaultValue: '个人中心'),
    resultRestart: appTextBox.get('resultRestart', defaultValue: '重新开始'),
    resultTitle: appTextBox.get('resultTitle', defaultValue: '结果'),
    resultSwipe: appTextBox.get('resultSwipe', defaultValue: '滑动查看'),
    secondaryTitle: appTextBox.get('secondaryTitle', defaultValue: '二级标题'),
    tretiaryProductTitle: appTextBox.get('tertiaryTitle', defaultValue: '三级标题'),
  );
  return appText;
}

方案2：修改AppStrings字段为可空类型

将AppStrings类的所有字段改为String?，后续使用字段时需处理null场景（比如用??提供默认值或!断言）：

// 修改AppStrings类示例
class AppStrings {
  final String? mainPageTitle;
  final String? timeText;
  // ... 其他字段同理

  AppStrings({
    this.mainPageTitle,
    this.timeText,
    // ... 其他字段
  });
}

// 使用时处理null
Text(appText.mainPageTitle ?? '默认标题');

方案3：提前校验非空，主动抛出异常

如果业务要求Hive中必须存在所有key，可先逐个获取并校验，发现null时主动抛出异常：

static Future<AppStrings> getAppText(String local) async {
  var appTextBox = await Hive.openBox("appTextBox");
  
  // 逐个获取值
  final mainPageTitle = appTextBox.get('mainPageTitle');
  final timeText = appTextBox.get('timeText');
  final minutesText = appTextBox.get('minutesText');
  // ... 其他字段依次获取
  
  // 校验所有值非空
  if ([
    mainPageTitle, timeText, minutesText, mainPageSubtitle,
    mainPageParagraph, mainPageButton, restartButton, backButton,
    profileTitle, loadingPageSubtitle, loadingPageBottomText,
    loadingPageTitle, profileButton, resultRestart, resultTitle,
    resultSwipe, secondaryTitle, tretiaryProductTitle
  ].any((value) => value == null)) {
    throw StateError("Hive中缺少必要的本地化字符串资源");
  }
  
  // 由于已校验，可使用!断言非空
  return AppStrings(
    mainPageTitle: mainPageTitle!,
    timeText: timeText!,
    minutesText: minutesText!,
    // ... 其他字段同理
  );
}

推荐方案 #

如果是本地化场景，优先选择方案1，既能避免null异常，又能保证界面有默认内容展示；若业务依赖Hive中必须存在完整数据，选择方案3可提前暴露问题，便于排查。

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