Flutter Android前台服务二次入口点MissingPluginException问题求助

问题核心 #

你在Android前台服务中启动的新FlutterEngine未注册所需插件（permission_handler、record等），这些插件仅在主FlutterEngine中完成了注册，导致新Isolate调用插件时找不到原生实现，抛出MissingPluginException。

修复步骤 #

1. 在Android端手动注册插件到新FlutterEngine #

修改Kotlin代码中的startDartIsolate方法，在执行Dart入口点前，将所有用到的插件注册到新创建的flutterEngine中：

private fun startDartIsolate() {
    val loader: FlutterLoader = FlutterInjector.instance().flutterLoader()

    if (!loader.initialized()) {
        loader.startInitialization(applicationContext)
    }

    applicationContext.let { ctx ->
        loader.apply {
            startInitialization(ctx)
            ensureInitializationComplete(ctx, emptyArray<String>())
        }

        flutterEngine = FlutterEngine(ctx, null, false, false)
        flutterEngine?.serviceControlSurface?.attachToService(this, null, true)

        // 关键步骤：注册所有插件到新FlutterEngine
        GeneratedPluginRegistrant.registerWith(flutterEngine!!)

        val callbackName = "second"
        val entryPoint = DartExecutor.DartEntrypoint(
            loader.findAppBundlePath(),
            callbackName
        )

        flutterEngine?.dartExecutor?.executeDartEntrypoint(entryPoint)
    }
}

说明：GeneratedPluginRegistrant是Flutter自动生成的类，包含你pubspec.yaml中所有插件的注册逻辑。如果项目中没有这个类，执行flutter clean + flutter pub get即可重新生成。

2. 确认Dart端注册逻辑顺序 #

确保Dart入口点的初始化代码顺序正确：

@pragma('vm:entry-point')
void second() async {
    // 先初始化Flutter绑定
    WidgetsFlutterBinding.ensureInitialized();
    // 确保Dart端插件注册完成
    DartPluginRegistrant.ensureInitialized();

    // 后续权限检查、录音逻辑...
}

3. 特定插件的手动注册（可选） #

如果个别插件仍无法正常工作，可直接注册该插件的Android实现类，比如针对permission_handler添加：

PermissionHandlerPlugin.registerWith(flutterEngine!!.dartExecutor.binaryMessenger)

其他插件可查看其Android源码找到对应的注册方法。

额外注意事项 #

• 确保前台服务已申请所有必要权限，并在Manifest中正确配置：

  <uses-permission android:name="android.permission.RECORD_AUDIO" />
  <uses-permission android:name="android.permission.FOREGROUND_SERVICE" />
  <uses-permission android:name="android.permission.FOREGROUND_SERVICE_MICROPHONE" /> <!-- Android 14+ 需添加 -->
  

• 避免重复初始化资源，若业务允许，可考虑通过MethodChannel在主Engine和前台服务间通信，减少多Engine的资源消耗。

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