Flutter配置Amplify时触发Auth plugin未添加异常该如何解决？

问题原因 #

你的代码中_configureAmplify是异步执行的，initState调用该方法后不会等待配置完成就会执行build方法，此时Bloc初始化直接触发了authCheckRequested事件，调用了Auth相关接口，但此时Amplify还未完成插件添加和配置流程，因此抛出对应异常。

解决方法 #

方案1：在应用启动时提前配置Amplify（更推荐） #

将Amplify配置逻辑移到main函数中，确保配置完成后再启动应用：

void main() async {
  // 确保Flutter框架初始化完成
  WidgetsFlutterBinding.ensureInitialized();
  // 执行Amplify配置
  await _configureAmplify();
  runApp(const AppWidget());
}

// 把原来的_configureAmplify方法抽成顶层函数
Future<void> _configureAmplify() async {
  Amplify.addPlugins([
    AmplifyAuthCognito(),
    AmplifyDataStore(modelProvider: ModelProvider.instance),
    AmplifyAPI(),
    AmplifyStorageS3(),
    AmplifyAnalyticsPinpoint(),
  ]);
  try {
    await Amplify.configure(amplifyconfig);
  } catch (e) {
    print("Amplify配置失败: $e");
  }
}

修改后可以删除AppWidget中initState里的_configureAmplify()调用逻辑。

方案2：页面内增加加载状态 #

如果不想在启动时配置，可以在页面中增加配置完成的状态判断，配置完成前展示加载占位：

class _AppWidgetState extends State<AppWidget> {
  bool _isAmplifyConfigured = false;

  @override
  void initState() {
    super.initState();
    _configureAmplify();
  }

  Future<void> _configureAmplify() async {
    Amplify.addPlugins([
      AmplifyAuthCognito(),
      AmplifyDataStore(modelProvider: ModelProvider.instance),
      AmplifyAPI(),
      AmplifyStorageS3(),
      AmplifyAnalyticsPinpoint(),
    ]);
    try {
      await Amplify.configure(amplifyconfig);
    } catch (e) {
      print("Amplify配置失败: $e");
    } finally {
      setState(() {
        _isAmplifyConfigured = true;
      });
    }
  }

  @override
  Widget build(BuildContext context) {
    // 配置完成前展示加载页
    if (!_isAmplifyConfigured) {
      return const MaterialApp(
        home: Scaffold(body: Center(child: CircularProgressIndicator())),
      );
    }
    // 原有业务代码不变
    final appRouter = AppRouter();
    return MultiRepositoryProvider(
      providers: [
        RepositoryProvider(
          create: (context) => AuthRepository(),
        ),
      ],
      child: MultiBlocProvider(
        providers: [
          BlocProvider(
              create: (context) => AuthBloc(context.read<AuthRepository>())
                ..add(const AuthEvent.authCheckRequested())),
        ],
        child: MaterialApp.router(
          title: 'Flutter Demo',
          theme: ThemeData(
            primarySwatch: Colors.blue,
          ),
          routerDelegate: appRouter.delegate(),
          routeInformationParser: appRouter.defaultRouteParser(),
        ),
      ),
    );
  }
}

注意事项 #

原有代码中catch块只打印了重配置提示，建议补充打印异常详情，方便排查其他配置类问题。

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