使用最新CocoaPods构建Flutter iOS应用时出现MLKitVision模块缺失错误

云原生阿岚

2026-6-30

解决方案

针对Flutter 3.16.9构建iOS时No such module 'MLKitVision'的报错，尝试以下步骤：

手动指定MLKitVision版本
在iOS目录的Podfile中添加明确的MLKitVision依赖声明，避免版本拉取异常：
```
pod 'MLKitVision', '~> 3.2.0'
```
执行pod install --repo-update重新安装依赖。
检查Xcode框架搜索路径
打开iOS项目的.xcworkspace，进入项目的Build Settings，搜索Framework Search Paths，添加路径$(PROJECT_DIR)/Pods/MLKitVision并设置为Recursive，确保Xcode能找到该模块。
切换Flutter Pod集成模式
在Podfile顶部添加动态框架配置，解决静态框架的链接问题：
```
use_frameworks! :linkage => :dynamic
```
执行pod deintegrate && pod install重新生成Pods。
调整mobile_scanner版本
当前使用的mobile_scanner-3.5.7可能存在兼容性问题，尝试升级到最新稳定版或降级到已知兼容的版本（如3.5.5），修改pubspec.yaml：
```
mobile_scanner: ^3.5.5
```
执行flutter pub get后重新处理iOS依赖。
手动导入MLKitVision框架
若CocoaPods无法正常拉取框架，可直接下载MLKitVision框架拖入Xcode项目（勾选"Copy items if needed"），并在Build Phases的Link Binary With Libraries中添加该框架。