Xcode上传watchOS应用到App Store卡住无报错如何排查

上传过程日志存储位置 #

• 全量分发流程日志路径：~/Library/Logs/DistributionPipeline/
  该目录会按每次分发任务生成带时间戳的子目录，包含校验、上传、元数据同步全流程日志，blobstore上传完成后的后续同步环节日志均存储在此处。
• Xcode Organizer 专用操作日志：~/Library/Logs/Xcode/Organizer/
  分发流程触发的异常栈信息会同步记录在该目录下的日志文件中。
• 底层Transporter工具日志：~/.itmstransporter/Logs/
  Xcode底层调用苹果Transporter工具完成上传，blobstore上传完成后卡壳通常是元数据校验、签名二次校验环节异常，相关报错都会记录在该路径的日志内。

排查建议 #

• 优先使用命令行工具上传：先将归档文件导出为ipa存到本地，执行命令
  xcrun altool --upload-app --type ios --file 你的ipa文件绝对路径 --username 你的Apple ID --password 应用专用密码
  watchOS独立应用的type参数同样填ios即可，命令行模式会输出实时进度和明确报错信息，不会出现UI层无提示卡壳的问题。
• 核对App Store Connect配置：确认后台创建的watchOS独立应用的Bundle ID、版本号、构建号和上传包完全匹配，独立watchOS应用无需绑定iOS宿主，不要误填iOS应用的关联配置。
• 清理本地缓存后重试：退出Xcode后执行rm -rf ~/Library/Caches/com.apple.dt.Xcode清理Xcode缓存，再删除~/.itmstransporter/目录下除Logs外的所有缓存文件，重启Xcode后重新提交。
• 调整网络环境：blobstore上传完成后卡壳大概率是后续元数据同步请求被拦截，关闭代理、VPN工具，切换到手机热点或运营商公网后重试，部分办公内网的防火墙会拦截苹果服务端的同步接口请求。
• 本地提前做合规校验：执行codesign -vvvv 你的watchOS应用.app的绝对路径命令在本地先完成签名校验，确认包内没有仅iOS可用的无效框架、私有API调用，避免服务端静默校验失败无回包。

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