Flutter集成测试遇LateInitializationError：box字段未初始化求助

你遇到的LateInitializationError是因为State类里的bookmarkList和bookmarkUrl在初始化时直接访问了全局的box变量，但box是在main函数里异步初始化的——State成员变量的初始化时机早于box完成初始化的时间，这时候box还没被赋值，自然就触发了错误。

修复方案一：在initState中初始化列表 #

把bookmarkList和bookmarkUrl改成late变量，然后在initState方法里完成初始化，这样就能保证访问box的时候它已经被正确初始化了：

late Box box;
const bookmarkBox = 'bookmark_box';

Future<void> main() async {
  await Hive.initFlutter();
  box = await Hive.openBox(bookmarkBox);
  runApp(const BookmarkApp());
}

class _BookmarkListPageState extends State<BookmarkListPage> {
  late List<dynamic> bookmarkList;
  late List<dynamic> bookmarkUrl;

  @override
  void initState() {
    super.initState();
    // 此时box已完成初始化，可安全访问
    bookmarkList = box.get('BookmarkTitle', defaultValue: ['Google', 'Apple']) ?? [];
    bookmarkUrl = box.get('BookmarkUrl', defaultValue: [
      'https://www.google.com/',
      'https://www.apple.com/jp/',
    ]) ?? [];
  }
}

修复方案二：通过构造函数传递Box实例 #

避免使用全局变量，通过构造函数把初始化好的Box传递给页面，这样能更清晰地控制依赖关系，也更利于测试：

const bookmarkBox = 'bookmark_box';

Future<void> main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await Hive.initFlutter();
  final box = await Hive.openBox(bookmarkBox);
  runApp(BookmarkApp(box: box));
}

// 修改BookmarkApp接收box参数
class BookmarkApp extends StatelessWidget {
  final Box box;
  const BookmarkApp({super.key, required this.box});

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: BookmarkListPage(box: box),
    );
  }
}

class BookmarkListPage extends StatefulWidget {
  final Box box;
  const BookmarkListPage({super.key, required this.box});

  @override
  _BookmarkListPageState createState() => _BookmarkListPageState();
}

class _BookmarkListPageState extends State<BookmarkListPage> {
  late List<dynamic> bookmarkList;
  late List<dynamic> bookmarkUrl;

  @override
  void initState() {
    super.initState();
    bookmarkList = widget.box.get('BookmarkTitle', defaultValue: ['Google', 'Apple']) ?? [];
    bookmarkUrl = widget.box.get('BookmarkUrl', defaultValue: [
      'https://www.google.com/',
      'https://www.apple.com/jp/',
    ]) ?? [];
  }
}

额外提示 #

全局的late Box box虽然能解决简单场景，但在复杂项目中容易出现状态管理混乱的问题，通过构造函数传递实例或者使用依赖注入的方式，代码的可测试性和维护性会更好。

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