Flutter中ThemeConfig字段重复初始化报错的解决咨询

问题现象 #

使用package:theme_config/theme_config.dart实现主题动态切换，包内几个静态变量声明为late final：

static late final Reader _read;
static late final SharedPreferences _preferences;
static late final ThemeProfile _profile;

调用Phoenix.rebirth(context)（通过flutter_phoenix包实现登出后应用重启）时，触发报错：

Field '_read@504051772' has already been initialized

原因分析 #

Phoenix重启应用时会重新执行main方法中的初始化逻辑，同时包内ThemeBuilder的initState会再次尝试为late final修饰的_read变量赋值。而late final变量仅允许初始化一次，重复赋值就会抛出上述错误。

现有代码 #

main方法 #

void main() async{
  //* 2. Initialize the package
  await ThemeConfig.init(themeProfile);  
  WidgetsFlutterBinding.ensureInitialized();
  runApp(Phoenix(
    child:MyApp()));
}

MyApp的build方法 #

@override
Widget build(BuildContext context) {
  final Store<AppState> store =
      Store<AppState>(appStateReducer, initialState: AppState.initialState());

  return StoreProvider<AppState>(
    store: store,
    child: StoreBuilder<AppState>(
        onInit: (store) => store.dispatch({}),
        builder: (BuildContext context, Store<AppState> store) => ThemeBuilder(
          builder: (theme) {
            return MaterialApp(
              theme: theme.light,
              darkTheme: theme.dark,
              themeMode: theme.mode,
              navigatorObservers: [ThemeConfig.routeObserver],
            );
          })),
  );
}

包内theme_buidler.dart的initState逻辑 #

@override
void initState() {
   super.initState();
   ThemeConfig._read = ref.read;
   ThemeConfig._initOverlay(refresh: () => mounted ? setState(() {}) : null);
   WidgetsBinding.instance.addObserver(this);
}

解决方案（不修改包源码） #

方案1：替换Phoenix重启方式为路由重置 #

放弃使用Phoenix.rebirth，改用路由跳转并清空栈的方式实现登出后的状态重置，避免应用整体重启导致的静态变量重复初始化问题：

// 登出时执行
void handleLogout(BuildContext context) {
  // 重置应用状态（根据你的Redux逻辑调整）
  StoreProvider.of<AppState>(context).dispatch(ResetAppStateAction());
  
  // 跳转到登录页并清空所有路由
  Navigator.of(context).pushAndRemoveUntil(
    MaterialPageRoute(builder: (_) => const LoginPage()),
    (route) => false,
  );
}

方案2：通过反射重置ThemeConfig静态变量（不推荐发布模式使用） #

利用dart:mirrors反射包重置ThemeConfig的私有静态变量，使其在重启后可以重新初始化：

1. 添加依赖到pubspec.yaml：

dependencies:
  dart:mirrors:

2. 编写重置方法：

import 'dart:mirrors';

void resetThemeConfig() {
  final classMirror = reflectClass(ThemeConfig);
  // 遍历所有私有静态变量并重置为null
  for (var declaration in classMirror.declarations.values) {
    if (declaration is VariableMirror && declaration.isStatic && 
        MirrorSystem.getName(declaration.simpleName).startsWith('_')) {
      classMirror.setField(declaration.simpleName, null);
    }
  }
}

3. 重启前调用重置方法：

// 登出时执行
void handleLogout(BuildContext context) {
  resetThemeConfig();
  Phoenix.rebirth(context);
}

注意：反射在Flutter发布模式下可能存在兼容性问题，且违反封装原则，仅作为临时方案使用。

方案3：包装ThemeBuilder避免重复赋值 #

如果ThemeBuilder是公开类，可以自定义包装类，跳过重复初始化逻辑：

class SafeThemeBuilder extends ThemeBuilder {
  const SafeThemeBuilder({super.key, required super.builder});

  @override
  void initState() {
    try {
      // 尝试触发late变量的初始化检查，如果已初始化则跳过赋值
      reflectClass(ThemeConfig).getField(Symbol('_read'));
    } catch (_) {
      // 未初始化时执行原initState逻辑
      super.initState();
      return;
    }
    // 已初始化时仅执行必要的观察者注册和Overlay初始化
    WidgetsBinding.instance.addObserver(this);
    ThemeConfig._initOverlay(refresh: () => mounted ? setState(() {}) : null);
  }
}

然后在build方法中替换为SafeThemeBuilder即可。

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