Flutter项目Xcode真机运行报错：找不到BoringSSL-GRPC.modulemap文件
2026-5-14
解决Flutter项目真机运行时找不到BoringSSL-GRPC.modulemap的问题
我之前也碰到过这个一模一样的问题，折腾了好一阵才解决，给你几个亲测有效的方案，按顺序试试：
方案1：彻底清理缓存并重新安装依赖
这是最常见的解决思路，很多时候是缓存或Pods安装不完整导致的：
- 先在Flutter项目根目录执行：
flutter clean - 进入ios目录，删除Pods文件夹和Podfile.lock：
cd ios rm -rf Pods Podfile.lock - 重新安装Pods（更新仓库确保拉取最新依赖）：
pod install --repo-update - 回到根目录重启Flutter项目：
cd .. flutter run
方案2：检查并更新Flutter和Dart版本
旧版本的Flutter和依赖库可能存在兼容性问题：
- 切换到稳定版并更新Flutter：
flutter channel stable flutter upgrade - 更新项目的Dart依赖：
flutter pub upgrade - 完成后重复方案1的清理和Pods安装步骤。
方案3：手动修复Xcode的模块映射路径
如果上面的方法都没用，可能是Xcode找不到正确的模块映射路径，手动指定试试：
- 打开Xcode，选中你的项目target，进入Build Settings标签
- 在搜索框输入
Module Map，找到Import Paths相关设置 - 添加路径：
$(SRCROOT)/Pods/Headers/Private/openssl_grpc - 同时检查
Header Search Paths，确保包含$(SRCROOT)/Pods/Headers/Private/openssl_grpc并设置为recursive - 清理Xcode缓存（按下
Command + Shift + K），然后重新编译运行
方案4：锁定openssl_grpc的稳定版本
有些版本的openssl_grpc可能存在打包问题，尝试锁定一个经过验证的稳定版本：
- 在ios目录的Podfile中添加：
pod 'openssl_grpc', '1.1.1100'
- 执行
pod install重新安装依赖，然后再尝试运行项目
内容的提问来源于stack exchange，提问作者Shruti Ramnandan Sharma
