升级Flutter/Dart后Xcode无法安装Runner至iOS真机求助

1. 彻底清理Flutter iOS构建缓存 #

执行以下命令彻底清除旧缓存并重新构建依赖：

flutter clean
rm -rf ios/Pods
rm ios/Podfile.lock
rm -rf ~/Library/Developer/Xcode/DerivedData
cd ios && pod deintegrate && pod install

升级Flutter/Dart后，旧的Pod缓存、Xcode构建残留很可能导致签名逻辑冲突，彻底清理后重新初始化依赖能解决多数隐性问题。

2. 核对Xcode签名配置细节 #

打开Xcode的Runner项目，进入Signing & Capabilities标签：

• 勾选Automatically manage signing，确保选择的团队是你当前有效的开发者账号
• 确认Bundle Identifier与Apple开发者后台注册的App ID完全一致（注意大小写、特殊字符不能有差异）
• 登录Apple开发者后台，检查Certificates, Identifiers & Profiles > Devices中是否已添加当前iPhone的UDID
  如果使用手动签名：
• 确保Provisioning Profile包含当前设备的UDID，且与Bundle ID严格匹配
• 在Build Settings中，Code Signing Identity要对应所选证书，Provisioning Profile选择正确的配置文件

3. 验证设备开发者信任设置 #

在iPhone上进入设置 > 通用 > VPN与设备管理，找到你的开发者账号条目，点击「信任」该账号，完成后重启设备再尝试安装。

4. 检查Flutter与Xcode版本兼容性 #

执行flutter doctor查看输出，确认当前Flutter版本支持iOS 16.6.1：

• 如果存在版本不兼容提示，升级Flutter到最新稳定版：flutter upgrade
• 若最新稳定版仍有问题，可尝试降级到前一个稳定版（比如通过flutter downgrade <版本号>）

5. 重置设备与Xcode的连接 #

断开iPhone与电脑的连接，关闭Xcode；重启iPhone和电脑后重新连接设备，等待Xcode完全识别设备后再运行项目。

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