Flutter iOS端出现PlatformException通道连接错误求助

项目依赖包 #

font_awesome_flutter
google_maps_flutter
http
flutter_typeahead
google_maps_flutter_web
permission_handler
google_sign_in
flutter_stripe
flutter_dotenv
url_launcher
recase
intl
awesome_notifications
workmanager
hive
hive_flutter
hive_generator
flutter_lints
flutter_svg
flutter_launcher_icons
build_runner

iOS端错误日志 #

[ERROR:flutter/runtime/dart_vm_initializer.cc(41)] Unhandled Exception: PlatformException(channel-error, Unable to establish connection on channel., null, null)
#0      PathProviderApi.getDirectoryPath (package:path_provider_foundation/messages.g.dart:40:7)
<asynchronous suspension>
#1      getApplicationDocumentsDirectory (package:path_provider/path_provider.dart:121:24)
<asynchronous suspension>
#2      HiveX.initFlutter (package:hive_flutter/src/hive_extensions.dart:12:18)
<asynchronous suspension>
#3      main (package:projectName/main.dart:22:3)
<asynchronous suspension>

已尝试的修复操作 #

• 删除并重建iOS文件夹
• 重装CocoaPods并执行pod install
• 执行flutter clean和flutter pub get

可能的解决方案 #

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

确保path_provider和hive_flutter版本与当前Flutter SDK匹配，在pubspec.yaml中指定兼容版本后执行flutter pub upgrade：

path_provider: ^2.1.2
hive_flutter: ^1.1.0

2. 验证iOS项目配置 #

• 打开Runner.xcworkspace，检查Runner目标的Build Phases → Embed Frameworks是否包含必要框架
• 确认Info.plist无重复通道配置或冲突权限设置

3. 手动配置path_provider iOS集成 #

在iOS项目Podfile中添加path_provider_foundation的本地路径（替换版本号为实际安装版本），再执行pod install：

pod 'path_provider_foundation', :path => File.join('..', '..', '.pub-cache', 'hosted', 'pub.dartlang.org', 'path_provider_foundation-2.3.2')

4. 彻底清理缓存 #

• Xcode中执行Cmd+Shift+K清理构建文件夹
• 删除~/.pub-cache目录，重新执行flutter pub get

5. 切换到稳定版Flutter SDK #

flutter channel stable
flutter upgrade

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