无法在iOS物理真机上构建运行应用 模拟器可正常运行

模拟器和真机的运行环境、校验逻辑差异很大，清理构建产物、更新CocoaPods没解决的话，按以下优先级排查：

1. 签名与描述文件校验（90%的真机部署问题出在这） #

• 打开对应Target的Signing & Capabilities页，确认调试用的开发团队选择正确，勾选Automatically manage signing后等待Xcode自动生成匹配的描述文件，不要使用过期、未包含当前真机UDID的手动签名描述文件。如果用免费开发者账号调试，注意签名有效期只有7天，过期需要重新触发签名流程。
• 检查真机端证书信任状态：打开真机「设置-通用-VPN与设备管理」，找到对应开发者证书，手动点信任后再尝试安装。
• iOS16及以上系统需要手动开启开发者模式：进入「设置-隐私与安全性-开发者模式」打开开关，按提示重启手机后才能安装调试包，模拟器无此校验。

2. 架构与部署配置检查 #

• 打开Build Settings搜索Excluded Architectures，确认iOS SDK对应的Debug/Release配置下，没有错误添加arm64的排除规则——很多人之前为了适配x86模拟器加的排除配置忘记删除，会直接导致真机编译失败。
• 确认项目Deployment Target设置的最低系统版本，不高于当前调试真机的系统版本，模拟器可以随意下载对应版本镜像运行，真机系统版本低于部署目标会直接安装失败。
• 删除真机上已安装的同Bundle ID应用：如果真机上之前装过App Store渠道的同应用、或者用其他证书签名的同包名应用，会因为签名不一致导致覆盖安装失败，卸载旧包后重新编译即可。

3. CocoaPods与依赖校验 #

• 不要只更新CocoaPods版本，执行pod deintegrate清空现有Pods集成产物，删除Podfile.lock文件后重新执行pod install，再编译项目。
• 检查所有第三方依赖（尤其是静态库、动态库形式引入的SDK）是否包含真机arm64架构：模拟器运行用的是x86_64/arm64模拟器架构，真机需要arm64/armv7真机架构，老版本SDK如果只打包了模拟器架构，会直接报架构不匹配的链接错误，这种情况需要升级到支持真机架构的依赖版本。
• 检查代码和依赖中是否误用模拟器专属API：比如在非TARGET_OS_SIMULATOR判断分支下调用了仅模拟器可用的系统接口、引用了x86专属的系统库，会导致真机安装后启动崩溃。

4. 精准定位错误 #

如果以上步骤都没解决，直接打开Xcode左侧的Report Navigator（报告导航栏），找到最新的真机部署/编译日志，拉到最底部看标红的具体错误信息：

• 报CodeSign相关错误：全部属于签名、证书、描述文件不匹配问题
• 报Undefined symbol、missing required architecture arm64：属于依赖架构缺失、链接配置错误
• 报Could not locate device support files：是Xcode版本过低，没有对应真机系统版本的调试支持文件，升级Xcode或者手动添加对应版本的支持文件即可

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