iTunes Connect 構建版本上傳後消失：私有 API 拒絕與排查指南

現象描述

Xcode/Transporter 上傳 IPA 成功，構建版本在「活動」頁面顯示「處理中」，刷新後消失，郵箱無拒絕郵件，反复上傳 20+ 次均相同。

核心原因：二進制文件被自動拒絕

App Store Connect 後台自動掃描發現違規行為（最常見：調用私有 API），直接標記為「無效二進制文件」，不進入人工審核流程，因此不發送郵件通知，構建版本自動從列表隱藏。

排查步驟

1. 查看構建版本詳情：App Store Connect → 活動 → 找到該構建版本（可能需點「查看所有」） → 點擊版本號 → 查看「構建版本元數據」或「問題」標籤，通常會提示 ITMS-90338: Non-public API usage 等錯誤代碼。
2. 檢查郵件垃圾箱：部分通知會被誤判為垃圾郵件，搜索「App Store Connect」關鍵詞。
3. 本地靜態分析：Xcode → Product → Analyze，或使用 appstoreconnect CLI 工具預檢。

常見觸發私有 API 的代碼模式

定位具體違規符號

# 1. 解壓 IPA
unzip YourApp.ipa -d Payload

# 2. 使用 nm / otool 檢查未導出符號
nm -u Payload/YourApp.app/YourApp | grep -E '^_'

# 3. 對照 Apple 公開 API 列表（Apple Developer 文檔）確認是否為私有符號

申訴與溝通渠道

• App Store Connect → 幫助 → 聯繫我們 → App Store 應用審核，提交工單說明已修復私有 API 調用，請求人工複核。
• Apple Developer Forums：搜索相似案例，官方工程師偶爾回復指導。
• Technical Support Incident (TSI)：付費開發者帳號每年 2 次技術支持事件，可獲得工程師一對一協助。

案例復盤：iPhone 7 發布期間的誤判

提問者提到「上架那幾天發布 iPhone 7，壓力大產生疏忽」。高峰期審核系統可能誤判、延遲通知。建議：

1. 錯峰提交（避開新品發布首週）。
2. 提交前跑完完整自動化測試（UI Tests + 靜態分析）。
3. 保留構建版本編號遞增記錄，便於溝通時精確定位。

總結

構建版本「處理中→消失無通知」= 自動掃描拒絕（多為私有 API）。本地靜態分析 + 符號表檢查 + 更新第三方 SDK 是標準自檢流程。遇到誤判可通過工單/TSI 申訴，但預防永遠優於補救。