GetIt未注册GenderCubit依赖错误排查求助

我正在学习依赖注入（Dependency Injection）和Bloc框架，从昨晚开始遇到一个无法解决的错误：触发GenderAsset组件的onChanged回调时，执行print(context.read<GenderCubit>().genderValue)会抛出错误**"Bad state: GetIt: Object/factory with type <?> is not registered inside GetIt"**。但如果直接实例化GenderCubit而非通过Locator.sl()获取，错误就会消失。以下是相关代码，请求帮忙排查：

父StatefulWidget代码 #

Widget build(BuildContext context) {
  return BlocProvider(
    create: (context) => Locator.sl<GenderCubit>(),
    child: const _GenderView(),
  );
}

GenderView组件核心代码 #

body: Center(
  child: Padding(
    padding: const ProductPadding.ten(),
    child: Column(
      mainAxisAlignment: MainAxisAlignment.spaceEvenly,
      children: [
        GenderAsset(
          value: false,
          onChanged: (bool? value) {
            print(context.read<GenderCubit>().genderValue); // 报错行
          },
          asset: AssetValue.female.value.lottie,
          gender: LocaleKeys.gender_fm.tr(),
          color: ProductColor().pink,
          icon: FontAwesomeIcons.venus,
        ),
      ],
    ),
  ),
),

GetIt初始化代码 #

@InjectableInit()
abstract final class Locator {
  static final sl = GetIt.instance;

  static Future<void> locateServices() async {
    sl.init();
  }
}

GetIt依赖注册配置代码 #

extension GetItInjectableX on _i174.GetIt { // 初始化GetIt中的主作用域依赖注册
  _i174.GetIt init({
    String? environment,
    _i526.EnvironmentFilter? environmentFilter,
  }) {
    final gh = _i526.GetItHelper(
      this,
      environment,
      environmentFilter,
    );
    gh.lazySingleton<_i454.AppRouter>(() => _i454.AppRouter());
    gh.lazySingleton<_i46.BaseTheme>(() => _i46.BaseTheme());
    gh.factory<_i427.CacheMethods<_i906.BMIS>>(() => _i682.BMICache());
    gh.lazySingleton<_i162.ProductLocalization>(() => _i162.ProductLocalization(
          child: gh<_i409.Widget>(),
          key: gh<_i409.Key>(),
        ));
    gh.factory<_i427.CacheMethods<_i906.Users>>(() => _i575.UserCache());
    gh.factory<_i427.CacheMethods<_i906.Settings>>(() => _i138.AppCache());
    gh.factory<_i907.GenderCubit>(
        () => _i907.GenderCubit(genderValue: gh<_i110.GenderValue>()));
    return this;
  }
}

GenderValue枚举代码 #

enum GenderValue {
  male,
  female,
}

GenderCubit代码 #

@injectable
class GenderCubit extends Cubit<GenderState> {
  GenderCubit({GenderValue? genderValue})
      : _genderValue = genderValue ?? GenderValue.male,
        super(SelectGender(genderValue: genderValue));

  GenderValue? _genderValue;

  GenderValue get genderValue => _genderValue!;

  void changeGender2() {
    print("changeGender2");
  }

  void changeGender({GenderValue? newGender}) {
    _genderValue = newGender;
    emit(SelectGender(genderValue: _genderValue));
  }
}

问题排查与解决方案 #

核心原因 #

报错的根源是GetIt尝试解析GenderValue类型的依赖，但该枚举未在GetIt中注册。看GetIt配置代码，注册GenderCubit时调用了gh<_i110.GenderValue>()，但你的GenderValue只是普通枚举，既没标记@injectable也没手动注册到GetIt，导致GetIt找不到该类型实例。

两种解决方式 #

1. 手动注册GenderValue到GetIt
   在GetIt的init方法中添加枚举的单例注册：

   gh.lazySingleton<GenderValue>(() => GenderValue.male); // 和Cubit默认值保持一致
   

2. 移除Cubit对GetIt枚举注入的依赖
   既然GenderCubit本身已有默认值，完全可以不通过GetIt注入，修改GetIt中的Cubit注册代码：

   gh.factory<_i907.GenderCubit>(() => _i907.GenderCubit()); // 去掉genderValue参数，让Cubit自行使用默认值
   

额外验证点 #

• 确保Locator.locateServices()已在应用启动时调用（比如main函数中初始化），保证所有依赖完成注册。
• 若使用injectable代码生成，记得执行flutter pub run build_runner build更新注册配置，避免代码生成不及时导致的问题。

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