使用audio_service时Flutter Android出现Firebase重复初始化错误求助

问题背景 #

• 正在使用audio_service包
• 引入该包后，Firebase初始化环节报错（错误日志见图片）；移除该包后应用运行正常，无Firebase相关错误

Firebase初始化代码 #

Future<void> main() async {
  WidgetsFlutterBinding.ensureInitialized();
  if (Firebase.apps.isEmpty) {
    await Firebase.initializeApp(
      options: DefaultFirebaseOptions.currentPlatform,
    ).then((value) {
      logger.i('Firebase Initialized:${value.options}');
    });
  }
  runApp(const MyApp());
}

核心约束 #

• main()必须只调用一次
• Firebase必须只初始化一次

解决思路指导 #

1. 限制Firebase仅在主Isolate初始化 #

audio_service启动后台任务时会创建新的Isolate，可能导致main()被重复执行。可以通过判断当前Isolate是否为主Isolate，避免重复初始化Firebase：

import 'dart:isolate';

Future<void> main() async {
  // 仅在主Isolate中执行Firebase初始化
  if (Isolate.current.debugName == 'main') {
    WidgetsFlutterBinding.ensureInitialized();
    if (Firebase.apps.isEmpty) {
      await Firebase.initializeApp(
        options: DefaultFirebaseOptions.currentPlatform,
      ).then((value) {
        logger.i('Firebase Initialized:${value.options}');
      });
    }
  }
  runApp(const MyApp());
}

2. 单独配置audio_service后台入口 #

给audio_service指定独立的后台入口函数，避免后台Isolate执行主入口的初始化逻辑：

// 主入口
Future<void> main() async {
  WidgetsFlutterBinding.ensureInitialized();
  if (Firebase.apps.isEmpty) {
    await Firebase.initializeApp(
      options: DefaultFirebaseOptions.currentPlatform,
    ).then((value) {
      logger.i('Firebase Initialized:${value.options}');
    });
  }
  runApp(const MyApp());
}

// audio_service后台入口，添加注解避免被优化移除
@pragma('vm:entry-point')
void audioServiceBackgroundEntry() {
  AudioServiceBackground.run(() => AudioPlayerHandler());
}

3. 检查依赖版本兼容性 #

运行flutter pub outdated查看audio_service与Firebase相关包的版本是否存在冲突，尝试升级到双方兼容的稳定版本。

4. 清理重建项目 #

• 执行flutter clean清理缓存
• 删除pubspec.lock文件后重新执行flutter pub get
• 重新运行项目flutter run

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