Flutter升级后GetIt初始化报错：NavigationService未注册

• 检查注解完整性
  确认所有需要注入的类（包括NavigationService、MyOrganizations、相关ViewModel/Service）都正确添加了@injectable注解；如果是第三方类或需要自定义实例的类，要创建带@module注解的模块类，用@provides方法手动声明注册逻辑。空安全升级过程中容易出现注解被误删或格式错误，仔细核对每个类的注解。

• 强制重新生成注入代码
  不要手动修改自动生成的locator.config.dart（下次构建会被覆盖），正确的清理生成流程：

  1. 删除项目中所有injectable生成的配置文件（如locator.config.dart、injectable.config.dart）
  2. 执行flutter clean清除缓存
  3. 运行flutter pub run build_runner build --delete-conflicting-outputs强制重新生成注入代码，确保旧代码完全被替换

• 排查提前访问locator的场景
  很多时候错误不是注册顺序问题，而是某些类在GetIt完成初始化前就调用了locator<XXX>()：

  • 检查ViewModel/Service的构造函数、静态变量初始化块，有没有直接获取依赖的代码
  • 把依赖获取逻辑移到init()方法中，或者用late关键字延迟初始化变量，避免在类实例化阶段就访问locator

• 手动注册的正确方式
  如果自动生成的注册顺序确实有问题，不要改生成文件，而是在主locator初始化文件中补充手动注册：

  // 在调用configureDependencies()之后或之前，根据需求添加
  GetIt.I.registerLazySingleton<NavigationService>(() => NavigationService());
  

  或者用@module指定优先级：创建一个优先级高的模块类，注册需要提前加载的服务，injectable会按照模块的依赖关系调整注册顺序

• 开启调试排查注册状态
  初始化GetIt时开启调试模式，方便定位问题：

  final getIt = GetIt.instance;
  // 调试用，上线关闭
  getIt.allowReassignment = true;
  await getIt.init();
  // 打印所有已注册类型，确认目标类是否在列表中
  print(getIt.registeredTypes);
  

• 排查循环依赖
  如果存在A依赖B、B又依赖A的循环依赖，injectable无法正确生成注册代码，会导致类未注册。检查所有依赖链，重构代码解开循环（比如引入中间服务、使用延迟加载）

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