Flutter集成测试调用flutter_dotenv抛出NotInitializedError如何解决？

触发原因 #

flutter_test框架默认会在每个testWidgets用例执行完成后清空全局单例状态，仅在main函数开头执行一次DotEnv加载的话，第一个测试用例执行结束后DotEnv单例的初始化标记会被清除，第二个用例访问时就会抛出未初始化错误。

修复方案 #

方案1：将DotEnv加载逻辑移至setUpAll回调（首选） #

setUpAll回调会在当前测试文件所有用例执行前仅运行一次，且其执行产生的全局状态不会被测试用例间的重置逻辑清除：

import 'package:flutter_test/flutter_test.dart';
import 'package:flutter_dotenv/flutter_dotenv.dart';

void main() {
  TestWidgetsFlutterBinding.ensureInitialized();

  // 所有用例执行前统一加载一次.env
  setUpAll(() async {
    await dotenv.load(fileName: ".env");
  });

  testWidgets('第一个测试用例', (tester) async {
    // 正常调用dotenv.env['xxx']
  });

  testWidgets('第二个测试用例', (tester) async {
    final testPassword = dotenv.env['TEST_PASSWORD'];
    // 不再抛出未初始化错误
  });
}

注意：flutter_dotenv 5.x版本已提供全局单例dotenv，无需手动实例化DotEnv()

方案2：缓存env内容避免重复访问单例 #

如果仍存在状态被清除的问题，可以在加载完成后把env配置缓存到全局变量，后续所有用例直接访问缓存：

import 'package:flutter_test/flutter_test.dart';
import 'package:flutter_dotenv/flutter_dotenv.dart';

// 全局缓存env配置
late Map<String, String> envConfig;

void main() {
  TestWidgetsFlutterBinding.ensureInitialized();

  setUpAll(() async {
    await dotenv.load(fileName: ".env");
    envConfig = Map.unmodifiable(dotenv.env);
  });

  testWidgets('测试用例', (tester) async {
    final testPassword = envConfig['TEST_PASSWORD'];
  });
}

方案3：适配集成测试运行路径 #

集成测试运行时的工作目录和单元测试存在差异，如提示找不到.env文件，可调整加载路径：

• 把项目根目录的.env文件复制一份到integration_test目录下
• 加载时指定对应路径：

await dotenv.load(fileName: "integration_test/.env");

验证点 #

确认pubspec.yaml中已正确声明.env资源：

flutter:
  assets:
    - .env

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