Flutter WorkManager调用Pigeon报错：无法建立通道连接

问题本质 #

你遇到的PlatformException(channel-error)本质是WorkManager后台任务的无UI headless Flutter环境未正确初始化通信依赖，且原生端仅给前台FlutterEngine注册了Pigeon Api，后台独立运行的Engine未绑定对应实现，导致通道无法建立。

修复步骤 #

1. Dart端：初始化后台服务绑定

在callbackDispatcher开头添加ServicesBinding初始化（后台不需要UI相关的WidgetsBinding），确保能获取到合法的通信通道：

@pragma('vm:entry-point')
void callbackDispatcher() {
  // 初始化后台必备的服务绑定，替代UI用的WidgetsBinding
  ServicesBinding.ensureInitialized();
  
  Workmanager().executeTask((taskName, inputData) async {
    switch (taskName) {
      case "fetchBackground":
        BridgeApiFlutter.setup(BridgeApiFlutterImpl());
        // 现在可以正常调用原生Api了
        final result = await BridgeApiNative().helloNative("hello!");
        print("yeah $result");
        break;
    }
    return Future.value(true);
  });
}

2. Android端：全局注册Pigeon HostApi

让原生端为所有创建的FlutterEngine（包括后台headless的）自动注册Api实现：

第一步：实现HostApi逻辑

创建原生Api的具体实现类：

class BridgeApiNativeImpl : BridgeApiNative {
    override fun helloNative(world: String): String {
        // 这里写你的原生业务逻辑
        return "Native回应: $world"
    }
}

第二步：自定义Application全局监听

创建自定义Application类，监听所有FlutterEngine的创建事件：

class MyApplication : FlutterApplication() {
    override fun onCreate() {
        super.onCreate()
        // 监听所有FlutterEngine的创建，自动注册HostApi
        FlutterInjector.instance().flutterEngineFactory().addEngineLifecycleListener(
            object : FlutterEngineLifecycleListener {
                override fun onEngineCreated(flutterEngine: FlutterEngine) {
                    super.onEngineCreated(flutterEngine)
                    BridgeApiNative.setup(flutterEngine.dartExecutor.binaryMessenger, BridgeApiNativeImpl())
                }
            }
        )
    }
}

第三步：配置Manifest

修改AndroidManifest.xml，指定使用自定义Application：

<application
    android:name=".MyApplication"
    android:label="你的App名称"
    android:icon="@mipmap/ic_launcher">
    <!-- 其他原有配置 -->
</application>

验证 #

重新运行App，WorkManager的后台任务就能正常调用原生Api，不会再抛出通道连接异常。前台的Pigeon调用也不受影响。

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