Flutter全局配置Dart文件读取flutter_secure_storage时await报错如何处理

Dart 语法规则明确限定 await 表达式仅能在 async 修饰的函数内部使用，全局顶层作用域不属于函数作用域，直接在顶层编写await读取存储值必然触发编译报错，与flutter_secure_storage插件本身无关。

1. 启动阶段全量初始化（推荐） #

这种方式可以保证App启动完成后，所有全局业务参数已经从本地存储加载完毕，不会出现业务逻辑读到未初始化空值的问题。

• 全局业务变量先保留原本设置的默认值作为兜底，避免初始化异常导致空指针
• 封装独立的异步初始化函数，专门负责从安全存储读取配置、做类型转换后赋值给全局变量
• 在App入口的main()函数中，先完成Flutter引擎绑定，再await执行初始化函数，全部加载完成后再调用runApp()启动页面

对应参考代码：

import 'package:flutter/material.dart';
import 'package:flutter_secure_storage/flutter_secure_storage.dart';

// 实例化安全存储
final FlutterSecureStorage storage = const FlutterSecureStorage();

// 全局业务参数（保留原有默认值兜底）
String priceGlobal = 'PKR ';
int TaxGlobal = 12;
double discount = 0.8;
int DeliveryGlobal = 50;

// 全局颜色配置（无外部依赖，保持原有定义即可）
const kPrimaryColor = Color(0xFF3c80e3);
const kBackgroundLightColor = Color(0xFFFFFFFF);
const kBackgroundDarkColor = Color(0xFF121212);
const kErrorLightColor = Color(0xFFB00020);
const kErrorDarkColor = Color(0xFFCF6679);
const kCardDarkColor = Color(0xFF242529);
const kCardImageBCColor = Color(0xffF5F5F5);
const kPrimaryLightFontColor = Color(0xFF1F1F1F);
const kSecondaryLightFontColor = Color(0xFF9098B1);
const kPrimaryDarkFontColor = Color(0xFFF0F0F0);
const kSecondaryDarkFontColor = Color(0xFF969696);
var kYellowColor = Color(0xFFFFCC00);
var kBlackColor = Color(0xFF223263);
var kGreyColor = Color(0xFF9098B1);

// 配置加载初始化函数
Future<void> loadSecureGlobalConfig() async {
  // 读取存储值，空值时沿用默认参数
  final taxStr = await storage.read(key: "_TaxPercentTaxPercent");
  final deliveryStr = await storage.read(key: "_DeliveryCharges");
  // 类型转换时做异常兜底，避免非数值存储值导致崩溃
  TaxGlobal = int.tryParse(taxStr ?? '') ?? TaxGlobal;
  DeliveryGlobal = int.tryParse(deliveryStr ?? '') ?? DeliveryGlobal;
}

App入口的修改逻辑：

void main() async {
  // 必须先初始化Flutter绑定，否则无法调用原生通道读取安全存储
  WidgetsFlutterBinding.ensureInitialized();
  // 等配置全部加载完成再启动App
  await loadSecureGlobalConfig();
  runApp(const MyApp());
}

避坑说明 #

• 不要尝试使用顶层await写法：旧版本Dart完全不支持该语法，即便新版本支持，顶层await也会阻塞Dart isolate启动流程，容易引发App启动卡顿、白屏
• 存储读取的返回值一定要做类型转换和空值兜底：安全存储的返回值是字符串类型，且可能因为存储被清空、写入异常出现空值/非预期格式内容，直接强制转类型会触发运行时崩溃
• 原代码存在变量设计缺陷：重复命名的_TaxPercentTaxPercent、直接把字符串存储值赋值给int类型全局变量的逻辑，就算解决了await语法问题也会出现类型不匹配报错

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