Flutter iOS端通道通信异常求助：多插件报错无法解决

问题现象 #

开发Flutter iOS应用时，多个插件均出现通道通信失败：

• path provider 报错：PlatformException(channel-error)
• shared_preferences 报错：

  Unable to establish connection on channel: "dev.flutter.pigeon.shared_preferences_foundation.LegacyUserDefaultsApi.getAll"., null, null
  

• floor数据库（依赖sqflite）报错：

  MissingPluginException(No implementation found for method getDatabasesPath on channel com.tekartik.sqflite)
  

已尝试过flutter clean、flutter pub get、重新安装Pod、升级Flutter SDK及插件版本，问题仍未解决。

排查与解决步骤 #

1. 检查AppDelegate配置 #

确保AppDelegate正确初始化Flutter引擎，无自定义引擎导致的通道注册异常：

• Objective-C版本AppDelegate示例：

  #import "AppDelegate.h"
  #import "GeneratedPluginRegistrant.h"
  
  @implementation AppDelegate
  
  - (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    [GeneratedPluginRegistrant registerWithRegistry:self];
    return [super application:application didFinishLaunchingWithOptions:launchOptions];
  }
  
  @end
  

• Swift版本AppDelegate示例：

  import UIKit
  import Flutter
  import GeneratedPluginRegistrant
  
  @UIApplicationMain
  class AppDelegate: FlutterAppDelegate {
    override func application(
      _ application: UIApplication,
      didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?
    ) -> Bool {
      GeneratedPluginRegistrant.register(with: self)
      return super.application(application, didFinishLaunchingWithOptions: launchOptions)
    }
  }
  

重点确认GeneratedPluginRegistrant被正确调用，无自行创建FlutterEngine却未注册插件的情况。

2. 验证Podfile配置 #

确保Podfile启用Flutter插件集成，无禁用相关配置：

platform :ios, '14.0' # 确保版本符合插件要求

flutter_application_path = '../'
load File.join(flutter_application_path, '.ios', 'Flutter', 'podhelper.rb')

target 'Runner' do
  use_frameworks!
  use_modular_headers!

  flutter_install_all_ios_pods File.dirname(File.realpath(__FILE__))
end

post_install do |installer|
  installer.pods_project.targets.each do |target|
    flutter_additional_ios_build_settings(target)
  end
end

执行以下命令重新安装Pods：

cd ios
pod deintegrate
pod install --repo-update

3. 检查Xcode项目设置 #

• 确认Runner target的Build Phases中，Embed Frameworks包含Flutter.framework及所有插件的.framework文件
• 检查Build Settings里的Valid Architectures包含当前编译架构（如arm64、x86_64）
• 确保Deployment Target与Podfile指定的iOS版本一致

4. 排查自定义Flutter引擎或通道冲突 #

若使用自定义FlutterEngine，需手动注册所有插件：

FlutterEngine *engine = [[FlutterEngine alloc] initWithName:@"my_engine"];
[engine run];
[GeneratedPluginRegistrant registerWithRegistry:engine];

避免同时使用默认引擎和自定义引擎导致通道注册冲突。

5. 清理深层缓存 #

除flutter clean外，清理Xcode派生数据：

1. 打开Xcode，选择Xcode -> Preferences -> Locations
2. 点击Derived Data旁箭头，删除对应项目的文件夹
3. 重启Xcode后重新编译

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