Expo本地构建新iPhone 13 Pro失败：配置文件与账号问题排查

核心问题分析 #

EAS云端构建正常但本地构建失败，说明Apple Developer账号的设备、证书配置本身有效，问题出在本地Xcode的凭据缓存、配置文件同步或Expo本地构建的配置关联上。以下是针对性解决步骤：

1. 补全Xcode本地账号凭据（关键步骤） #

虽然之前通过Expo CLI操作，但本地构建依赖Xcode本地存储的Apple Developer账号凭据：

• 打开Xcode，进入Xcode > 设置 > 账户，添加你的Apple Developer团队账号
• 登录后点击团队名称旁的管理证书，确认开发证书状态正常；再点击下载手动配置文件，拉取最新的设备与配置关联信息
• 回到项目的Signing & Capabilities面板，重新选择团队，让Xcode自动匹配或生成适配当前设备的配置文件

2. 彻底清理本地缓存与原生目录 #

• 执行npx expo prebuild --clean，彻底重置iOS原生目录（比手动删除ios目录更可靠，会重新生成与Expo配置同步的原生文件）
• 清理Xcode衍生数据：rm -rf ~/Library/Developer/Xcode/DerivedData，然后重启Xcode
• 清理Expo CLI缓存：npx expo start --clear

3. 手动验证并同步配置文件 #

• 登录Apple Developer官网，进入Certificates, Identifiers & Profiles > 设备，确认iPhone 13 Pro的UDID已注册且状态正常
• 进入配置文件，找到对应开发配置文件，查看设备列表确认包含该设备UDID；若存在延迟，手动重新生成配置文件并下载到本地
• 在Xcode中导入新配置文件：Xcode > 窗口 > 设备与模拟器 > 选中你的设备 > 显示配置文件 > +，添加下载的配置文件

4. 调整本地构建命令参数 #

• 直接使用UDID而非设备名称构建，避免名称识别误差：

  npx expo run:ios --udid 0000xxxx-xxxxxxxxxxxxxxxx
  

• 加上--verbose参数查看详细日志，定位具体验证失败环节：

  npx expo run:ios --udid [你的设备UDID] --verbose
  

5. 重置设备开发者模式与信任设置 #

• 关闭再重新开启iPhone 13 Pro的开发者模式（设置 > 隐私与安全性 > 开发者模式），重启设备
• 首次安装构建包后，进入设置 > 通用 > VPN与设备管理，信任你的开发者证书

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