Flutter中Null检查运算符报错致Excel数据存储失败求助

问题根源 #

报错Null check operator used on a null value是因为dataSheet变量未初始化，处于null状态，强行用!访问触发了空指针异常。改成?.后程序不报错，但appendRows调用会因dataSheet为null被跳过，数据根本没写入工作表。

解决步骤 #

1. 先完成工作表初始化
   在调用insert方法前，必须确保dataSheet已被正确初始化。在DataSheetApi中补充初始化逻辑：

static Excel? _excel;
static Sheet? dataSheet;

static Future<void> initSheet() async {
  _excel = Excel.createExcel();
  dataSheet = _excel!['Sheet1']; // 创建或获取目标工作表
}

调用insert前先执行await DataSheetApi.initSheet();，保证dataSheet不为null。

2. 修复insert函数并添加保存操作
   完善insert函数，增加空判断避免静默失败，同时必须执行Excel文件的保存步骤（这是很多人忽略的关键环节）：

static Future insert(List<Map<String, dynamic>> rowList) async {
  if (dataSheet == null || _excel == null) {
    throw Exception('请先初始化工作表');
  }
  dataSheet!.values.map.appendRows(rowList);
  // 将修改后的Excel写入本地文件，替换为你的目标路径
  final fileBytes = _excel!.save()!;
  await File('storage/emulated/0/your_excel_file.xlsx').writeAsBytes(fileBytes);
}

注意：Android需申请存储权限，iOS需配置文件访问权限，确保路径可读写。

3. 验证数据变量有效性
   确认viewImage、opt11等变量值符合Excel写入要求，若字段不允许空值，需提前处理null情况。

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