Apple 的 TestFlight 外部測試說明指出,每個 App 最多可邀請 10,000 名外部測試者;這項上限不代表任何已上傳構建都能立即分發,詳見 Apple 外部測試者邀請說明。
症狀 → 最快解法:先確認構建是否可供外部測試,再核對測試組、審核狀態、測試資訊和邀請方式。遠端 Mac 負責建置與上傳;測試分發仍要在 App Store Connect 完成,別把分發設定問題誤判為遠端連線故障。
這篇指南適合已上傳構建、外部測試卻無法開始的獨立 iOS 開發者。
也適合旅途中要讓客戶或測試者收到測試版的自由工作者,以及需要定位分發阻塞點的小型遠端團隊。
TestFlight 外部測試排查 2026:先分清故障在哪一段
排查時把流程拆成三段:遠端 Mac 上的建置與上傳、App Store Connect 的測試分發、測試者裝置上的邀請與安裝。前一段完成,不代表下一段已就緒。
| 所在環節 | 你要核對的內容 | 可觀察證據 | 下一步 |
|---|---|---|---|
| 遠端 Mac:建置與上傳 | 專案是否完成歸檔,是否選對 App 與平台 | Xcode Organizer 中的歸檔紀錄、上傳結果或錯誤提示 | 有建置或上傳錯誤時,先修復並重新交付 |
| App Store Connect:構建處理 | 上傳狀態、構建狀態及頁面提示 | 構建詳情中的狀態與待處理資訊 | 依狀態處理合規或其他提示,不要只看上傳完成通知 |
| App Store Connect:測試分發 | 外部測試組是否選到合適構建、測試資訊是否完整 | 測試組中的構建選擇、審核狀態及設定 | 修正組別或補上資料,再依頁面要求提交 |
| 測試者裝置:接受邀請 | 邀請是否送出、連結是否可用、裝置是否符合條件 | 測試者名單、邀請方式與裝置上的接受結果 | 按郵件或公開連結流程確認加入資格 |
Apple 分別說明了構建上傳狀態與構建處理狀態。兩者不是同一個檢查點:上傳完成後,仍要回到 App Store Connect 查看構建目前是否可用,以及是否顯示需要處理的項目。
構建已上傳但沒有外測資格:核對狀態與提示
先不要重複上傳。打開 App Store Connect 的構建頁,確認選取的是正確 App、平台和構建,並查看狀態文字及頁面提示。若構建仍在處理,或出現待完成項目,就先依介面提供的資訊處理。
| 你看到的情況 | 代表甚麼 | 應採取的動作 |
|---|---|---|
| 上傳結果已完成,但構建尚未顯示可用 | 上傳紀錄不能單獨證明構建已準備好分發 | 查看構建狀態及後續提示 |
| 構建可見,但外部測試組無法選取 | 構建與組別可能不匹配,或尚有未完成條件 | 核對 App、平台、組別條件及構建提示 |
| 頁面要求處理出口合規資料 | 仍有與該構建相關的資料待完成 | 依提示填寫或確認,不要猜測答案 |
若畫面要求提供出口合規資訊,請照著 Apple 的測試版構建出口合規處理說明完成。不要因為 Xcode 顯示已上傳,就推定 App Store Connect 已完成全部處理。
測試組沒有可選構建:先排除選擇與條件不符
外部測試組已建立但看不到構建時,先確認你進入的是預期中的 App,再比較平台、構建和測試組設定。檢查組別是否有裝置或系統條件,使目前構建不符合選取要求。若頁面顯示沒有合用構建,先修正條件或改選符合資格的構建;不要把重複上傳當成第一步。
Apple 的外部測試者與構建管理說明介紹了外部測試組與構建的管理方式。對照頁面資訊時,請分清「構建存在」和「此測試組可使用」:前者不能證明後者成立。
外測提交後未進入測試:查明審核及待補資料
先查看 App Store Connect 顯示的審核狀態,再核對測試資訊是否完整。Apple 提供的測試資訊填寫說明可用來確認需要提供的內容。若構建被拒,依頁面上的拒絕原因處理;若仍待審核,就以目前顯示的狀態為準,不要自行推測審核時間或結果。
審核問題與遠端 Mac 的連線品質是不同類型的問題。遠端 Mac 可能完成了歸檔與上傳,但審核狀態仍須在 App Store Connect 核對。若你使用 Apple Developer 帳戶操作,也要確認目前帳戶能查看並管理相關 App 與測試資訊;權限不足時,請由具備相應存取權的團隊成員協助確認。
審核已通過但沒有邀請:核對通知方式與測試者資格
先確認測試者是否已加入正確的外部測試組,以及該組是否使用郵件邀請或公開連結。再查看通知是否已啟用,或是否需要由你手動通知測試者。Apple 的測試者資訊管理說明可協助你檢查測試者名單與管理資訊。
| 邀請方式 | 適合的使用情境 | 必查項目 | 主要風險 |
|---|---|---|---|
| 電郵邀請 | 你要指定測試者,並逐一確認加入狀態 | 電郵地址、測試組成員資格、通知是否已送出 | 地址錯誤或通知未發出時,測試者不會收到邀請 |
| 公開連結 | 你要讓符合條件的測試者自行加入 | 連結是否啟用、測試者條件及人數限制 | 連結可能被轉傳,加入者不一定是原定對象 |
公開連結能被轉發。若測試內容只應交給指定客戶或團隊,先選擇較可控的邀請方式;若決定繼續使用公開連結,應定期檢查連結狀態與測試組條件。不要只看到連結可開啟,就認定所有測試者都能加入。
提醒:公開連結的可見性、測試者條件及人數限制,都要以 App Store Connect 當前頁面設定為準。遇到無法加入時,先確認連結狀態與目標構建是否符合條件,再請測試者重試。
遠端 Mac 建置與上傳:按證據定位下一步
如果仍不確定問題是在構建還是分發,請分開留存遠端 Mac 與 App Store Connect 的紀錄。不要把「上傳成功」當成外部測試開始的證明,也不要把審核等待直接歸因於遠端 Mac。
- 在 Xcode 的 Organizer 查看歸檔紀錄,確認專案歸檔結果及對應 App。
- 查看上傳結果或錯誤提示,記下是否有需要處理的建置、簽署或上傳問題。
- 回到 App Store Connect,確認構建狀態及頁面提示;兩邊紀錄要能對應到同一個構建。
- 打開外部測試組,核對選用的構建、組別條件與測試者資格。
- 查看測試資訊與審核狀態,依拒絕原因或待補提示處理。
- 檢查通知方式、測試者名單或公開連結,再請測試者依目前設定嘗試加入。
- 若構建與分發設定都已核對,仍出現無法解釋的狀態或帳戶問題,保留頁面提示與操作紀錄,再聯絡 Apple 支援。
Apple 的上傳構建說明可用來核對交付步驟。這組證據能幫你把處理方向分成四類:修復建置或上傳、調整測試組、補充審核資料,或向 Apple 詢問帳戶與平台狀態。
常見問題
TestFlight 外部測試卡住時,先確認哪個狀態?
先在 App Store Connect 確認構建是否已處理完成、是否可供外部測試,以及頁面有沒有待處理提示。上傳成功只代表交付流程有進展,不等於構建已具備外測資格。確認狀態後,再檢查測試組、測試資訊和審核結果;不要先重複上傳。
外部測試組沒有可選構建,怎樣排查?
先確認你開啟的是正確 App 與平台,再檢查該測試組是否有系統或裝置條件會排除目前構建。回到構建頁核對狀態與可用性,並依 App Store Connect 的提示處理。若只是篩選條件或構建選擇不符,先修正設定;重新上傳不會自動解決組別不匹配。
外部測試審核通過後,測試者會自動收到通知嗎?
不要只憑審核通過推定邀請已送出。查看測試組的通知設定與測試者名單,確認是否已啟用自動通知;若沒有,按目前介面提供的方式通知測試者。接著確認對方使用的邀請郵件或公開連結仍有效,並符合測試組設定。
構建已上傳,測試者卻收不到邀請,問題在哪一端?
分別核對分發端與接收端:在 App Store Connect 確認測試者已加入正確組別、通知方式已設定,並確認公開連結仍啟用;再請測試者檢查邀請郵件及其裝置是否符合條件。若構建狀態本身尚未允許測試,先處理構建或審核提示,而非只重寄邀請。
若證據顯示阻塞點在持續建置或上傳,而你旅途中缺少可用的 macOS 工作環境,可以先評估遠端 Mac 雲端算力方案,再依工作地點查看香港的遠端 Mac 選項。本地 Mac 適合長期固定使用、需要實體介面或不希望依賴網路的情況;若只是階段性建置交付,攜帶本機設備會增加遺失、損壞與環境恢復的負擔。選擇 MACCOME 租用遠端 Mac 前,先確認你的網路可用性、存取方式與專案交付需求;如果真正卡在 App Store Connect 審核或測試組設定,租用 Mac 並不會替你解除那些分發條件。