Flutter插件iOS端MethodChannel.invokeMethod无法触发Dart代码

问题概述 #

开发Flutter插件时，Android端双向MethodChannel通信完全正常，但iOS端仅支持Flutter侧主动调用原生逻辑，原生发起的MethodChannel调用始终无法触发Dart侧的方法处理器，无日志输出、无调试反馈。已尝试降级Flutter版本（3.0.5→2.10.3）、升级/降级Xcode、清理Xcode派生数据、重启设备等操作，均未解决问题。

环境信息 #

• 测试设备：iPhone 11（iOS 15.6.1）、iPhone X（iOS 15.5）、多款iOS模拟器
• 开发工具：VSCode、Xcode 13.4.1
• Flutter版本：3.0.5（曾降级至2.10.3）
• 插件创建方式：flutter create --org com.mycompany --template=plugin --platforms=android,ios t_plugin
• 依赖版本：plugin_platform_interface: ^2.0.2（曾尝试2.1.2）

预期与实际结果 #

预期：

1. Dart侧methodChannel.setMethodCallHandler能捕获到onFinish方法调用，打印对应日志
2. iOS侧invokeMethod的result回调触发，打印返回结果

实际：

• Dart侧无任何触发迹象，日志完全不输出
• iOS侧result回调从未执行

代码示例 #

iOS Swift代码 #

import Flutter
import UIKit

public class SwiftTPlugin: NSObject, FlutterPlugin, FlutterApplicationLifeCycleDelegate {

    private var channel: FlutterMethodChannel? = nil

    public static func register(with registrar: FlutterPluginRegistrar) {
        let channel = FlutterMethodChannel(name: "f_plugin_test", binaryMessenger: registrar.messenger())
        // 注意：此处存在类名拼写错误！
        let instance = SwiftTestPlugin()
        instance.channel = channel
        registrar.addMethodCallDelegate(instance, channel: channel)
        registrar.addApplicationDelegate(instance)
    }

    public func handle(_ call: FlutterMethodCall, result: @escaping FlutterResult) {
         // Flutter侧调用原生的逻辑正常生效
    }

    public func finish() {
        if (self.channel == nil) {
               print("CHANNEL IS NIL!");  // 从未触发，说明channel实例有效
         } else {
            print("CHANNEL IS _NOT_ NIL");  // 正常打印
         }

          self.channel!.invokeMethod("onFinish", arguments: "TEST", result: {(r:Any?) -> () in
                 print(r.debugDescription);  // 从未触发
          })
     }
}

Dart代码 #

import 'package:flutter/foundation.dart';
import 'package:flutter/services.dart';
import 'package:t_flutter/t_flutter.dart';
import 't_flutter_platform_interface.dart';
  
 const methodChannel = MethodChannel("f_plugin_test");

 class MethodChannelTFlutter extends TFlutterPlatform {

  @override
  void start() {
     methodChannel.setMethodCallHandler((methodCall) async {
       debugPrint("CAUGHT METHOD WITH HANDLER: ${methodCall.method}");  // 从未触发
       switch (methodCall.method) {
         case "onFinish":
           debugPrint("onFinish"); // 从未触发
           return;
         default:
           throw MissingPluginException('Not Implemented'); // 从未触发
       }
     });
 }
}

排查与解决思路 #

1. 修复iOS侧插件实例拼写错误 #

你的Swift代码中存在明显的类名拼写错误：注册插件时实例化的是SwiftTestPlugin，但实际类名是SwiftTPlugin，这会导致插件Delegate未正确绑定，原生消息无法传递到Dart侧。修改为：

public static func register(with registrar: FlutterPluginRegistrar) {
    let channel = FlutterMethodChannel(name: "f_plugin_test", binaryMessenger: registrar.messenger())
    let instance = SwiftTPlugin() // 修正类名
    instance.channel = channel
    registrar.addMethodCallDelegate(instance, channel: channel)
    registrar.addApplicationDelegate(instance)
}

2. 确保Dart侧处理器的注册时机与返回值 #

• 提前注册处理器：将setMethodCallHandler移至插件构造函数中，确保Flutter初始化时就完成绑定，避免start()方法未被调用导致处理器未注册：

  class MethodChannelTFlutter extends TFlutterPlatform {
    MethodChannelTFlutter() {
      methodChannel.setMethodCallHandler(_handleMethodCall);
    }
  
    Future<dynamic> _handleMethodCall(MethodCall methodCall) async {
      debugPrint("CAUGHT METHOD WITH HANDLER: ${methodCall.method}");
      switch (methodCall.method) {
        case "onFinish":
          debugPrint("onFinish");
          return "Received"; // 必须返回值，否则iOS侧result会超时
        default:
          throw MissingPluginException('Not Implemented');
      }
    }
  
    @override
    void start() {
      // 保留原有业务逻辑即可
    }
  }
  

• 必须返回值：iOS侧result回调需要Dart侧返回结果才会触发，无返回值会导致回调超时静默失败。

3. 验证iOS侧调用时机是否合法 #

确保调用finish()时，Flutter引擎已完全初始化。可以先通过Flutter调用原生方法的反向测试验证通道是否正常：

public func handle(_ call: FlutterMethodCall, result: @escaping FlutterResult) {
    if call.method == "testCallback" {
        // 在Flutter调用原生后立刻回调Dart，验证通道有效性
        self.channel?.invokeMethod("onFinish", arguments: "TEST", result: { r in
            print(r.debugDescription)
        })
        result("ok")
    }
}

如果此测试能触发Dart侧日志，说明finish()的调用时机过早（Flutter引擎未就绪），需要调整调用时机。

4. 启用Verbose日志排查 #

运行项目时添加--verbose参数，查看MethodChannel的消息流转日志：

flutter run --verbose

搜索MethodChannel相关关键词，确认iOS侧是否发送了onFinish消息，以及Dart侧是否接收到消息。

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