App Store Connect Missing Metadata：訂閱卡住怎麼解

Missing Metadata 的意思是，你的訂閱或 App 內購買項目至少少了一項必填資訊。請依序檢查語言、價格、期間、國家、審查截圖，以及付費 App 合約。只要產品還停在這個狀態，你就沒辦法送審，App 也載入不到它。另外，第一個訂閱還必須跟著 App 的某個版本一起送出。

2026 年 7 月，我在交易模擬器 TradaZen 上遇到這個狀態。新的週訂閱已經設好期間、價格、群組，還有兩種語言，卻還是一直顯示 Missing Metadata。唯一缺的，是審查截圖。下面依序整理要檢查的原因、產品的各種狀態和解法，最後再講跟 RevenueCat 的關係。

Missing Metadata 是什麼意思？

到今年為止，Apple 說明文件對這個狀態的定義是：產品已建立，但你還沒上傳截圖，或還沒填完它的中繼資料。這個狀態從來不會告訴你缺的是哪個欄位。問題就在這裡：你得自己找。

注意，這個標籤在 2026 年 7 月改了。App Store Connect 版本說明在 7 月 15 日宣布了新的送審方式：每個 App 內購買項目都從自己的頁面，用 Add for Review 送出。狀態說明頁已經不再列出「Missing Metadata」，第一個狀態變成「Prepare for Submission」，並註明：如果你的 App 內購買項目缺少必填中繼資料，請先補齊，再加入送審。RevenueCat 的文件也證實：送審前，新產品會顯示「Prepare for Submission」，即使它還缺中繼資料。

不過 App Store Connect API 仍然會回傳 MISSING_METADATA，接著是 READY_TO_SUBMIT。所以依賴這個 API 的工具還是會顯示這些字。不管標籤怎麼寫，診斷都一樣：有個必填欄位是空的。

依序檢查的原因

我會照這個順序檢查，從產品頁面一路查到帳號。

原因	在哪裡修正
名稱或描述空白	產品頁面
群組沒有顯示名稱	群組頁面
缺少價格或期間	產品頁面
沒有可販售的國家	Availability
缺少審查截圖	Review Information
付費合約未生效	Business
第一個訂閱單獨送出	送審

1. 產品的語言。根據 App 內購買項目資訊說明，顯示名稱和描述至少要在一種語言中填寫。名稱長度是 2 到 30 個字元，描述最多 45 個字元。沒有任何語言的產品無法送出。

2. 群組的語言。訂閱群組也有一個顯示名稱，你的訂閱者在 iPhone 上管理訂閱時會看到。它要在群組頁面的 Display Name and Description 區塊新增，Apple 的訂閱說明頁有寫。這個欄位看起來不是必填。但有位開發者在 Apple 論壇上說，只要它是空的，他群組裡的所有訂閱都會卡住。狀態顯示在訂閱上，而不是群組上，所以才容易搞混。

3. 價格和期間。訂閱需要設定期間（一週到一年）和價格。當產品載入不到時，技術說明 TN3186 第一步就是檢查這些：產品 ID、價格和語言。另外要記得，送審之後期間就不能再改了。

4. 供應範圍。在 Availability 裡至少選一個國家或地區。Apple 特別說明，沒有設定供應範圍，就不會出現「Approved」狀態。

5. 審查截圖。這就是我在 TradaZen 上的狀況，也是論壇上常見的原因。「App Review Screenshot」要呈現這個購買項目在 App 裡的樣子，通常就是你的付費牆。它只給審查人員看，永遠不會出現在 App Store 上。它的規格跟你的 App Store 截圖一樣。上傳之後只能替換，不能刪除。

別把它跟 1024 x 1024 像素的宣傳圖片搞混。宣傳圖片只有在你要在產品頁上推廣這個購買項目，或建立贏回優惠時才用得到，而且有自己的規則。我是在訂閱宣傳圖片被退件之後才學到的。

6. 付費 App 合約。要提供 App 內購買項目，帳號持有人必須在 Business 裡簽署 Paid Apps Agreement，再填好銀行和稅務資料。這不是產品的欄位，但一切都取決於它。Apple 寫道，在你接受最新版合約之前，無法建立新的 App 內購買項目。它在準備送審購買項目的頁面還補充：這份合約生效前，付費購買在審查中無法運作。在 Business 裡，合約、銀行帳戶和稅務表單都必須是生效狀態。這些步驟在 Apple 開發者帳號指南裡有詳細說明。

7. 第一個訂閱單獨送出。這不算缺中繼資料。但產品明明都填完了卻一直送不出去，這是最常見的原因。下面會詳細說明。

產品的各種狀態，以及各自的解法

這是我隨時放在手邊的檢查清單。第一欄是 API 回傳的狀態，第二欄是 2026 年 7 月起 Apple 說明文件的標籤。

狀態（API）	目前標籤	解法
MISSING_METADATA	Prepare for Submission	填好欄位
READY_TO_SUBMIT	Prepare for Submission	Add for Review
無對應狀態	Ready for Review	Submit for Review
WAITING_FOR_REVIEW	Waiting for Review	等 Apple
IN_REVIEW	In Review	等 Apple
APPROVED	Approved	設定國家且 App 已核准
REJECTED	Rejected	修正後按 Update Review

詳細來說：

• 從 Missing Metadata 到 Ready to Submit。把原因 1 到 5 的欄位填好，儲存，重新整理頁面。我 7 月看到的畫面顯示的是 Missing Metadata，下一個狀態叫 Ready to Submit。
• 從 Ready to Submit 到 Ready for Review。在訂閱頁面點 Add for Review，把它加到現有的送審或新的送審。App 內購買項目的送審流程會讓你選擇平台、App 版本，必要時還有群組。從這一刻起，只剩參考名稱、價格和供應範圍可以修改。
• 從 Ready for Review 到 Waiting for Review。確認 App 版本和群組在同一個送審裡，然後點 Submit for Review。
• 從 Waiting for Review 到 Approved。什麼都不用做，只要確保付費牆能正常運作。如果購買項目變成「Accepted」而不是「Approved」，代表同一個送審裡有其他項目被退件：只要不是全部都通過，Apple 就不會核准任何項目。
• Rejected。原因會出現在送審的訊息裡。修正該項目，點 Update Review，再重新送出。

第一個訂閱要跟 App 版本一起送出

Apple 說明文件裡寫得很清楚：第一個訂閱，和每種類型的第一個購買項目一樣，都必須跟 App 的新版本一起送審。新群組送出時至少要帶一個它的訂閱。第一個項目核准後，只要 App 有已核准的版本，同類型的後續項目就能不靠新版本單獨送審。

TradaZen 就是這樣。7 月的版本帶著年訂閱和月訂閱一起送出。週訂閱當時還是 Missing Metadata，就沒被放進送審。App 核准之後，它就能單獨送出，不需要新的 build。

如果你送出 App 時沒帶上它的訂閱，之後就得再出一個新版本才能讓訂閱通過審核。App Store 審核時間指南說明了多跑一輪會多花幾天。

跟 RevenueCat 的關係：空的 offering

RevenueCat 本身不賣任何東西。SDK 先從它的伺服器讀取你的產品 ID，再從 iPhone 向 App Store 要產品。如果 App Store 沒回傳，offering 就會是空的，付費牆也就沒東西可顯示。這時 SDK 的日誌會出現：「There's a problem with your configuration. None of the products registered in the RevenueCat dashboard could be fetched from the App Store.」

根據 RevenueCat，中繼資料完整的產品在送審前就能在 sandbox 裡載入，不完整的則不行。RevenueCat 和 Apple 提供的其他方向：

• 付費 App 合約和銀行資料，根據 RevenueCat，最多可能要 24 小時才會生效；
• 產品的修改，根據 Apple，最多可能要一小時才會同步到 sandbox；
• App Store Connect、RevenueCat 和你的程式碼之間，產品 ID 不一致。

在 TradaZen 上，如果某個訂閱的產品沒被回傳，程式碼會隱藏那張卡片，但不會讓付費牆壞掉。2026 年 10 月，我又因為另一個原因看到沒有方案的付費牆：從 SDK 快取讀到的 offering 是空的。從那之後，只要 offering 是空的，App 的程式碼就會直接向 StoreKit 要產品，如果商店沒回應，就讓使用者重試。

沒有方案的付費牆絕對不能變成死路，不管對使用者還是審查人員都一樣，審查人員必須能完成購買。完整的串接方式在我的 RevenueCat iOS 訂閱指南裡，顯示上的陷阱則在付費牆常見錯誤。產品準備好之後，也要確認你的付費牆符合 guideline 3.1.2。

不用花一整週就把訂閱串好

iOS & Android Kit 是從我自己 App 的起始程式碼出發：引導流程、付費牆和訂閱都已經寫好，第三步「接上金流」會帶你完成設定。從 App Store Connect 的產品到購買驗證，整條流程都寫在 iOS App 內訂閱頁面上。

如果你正在準備第一次上架，來做免費診斷：它會幫你把步驟排好順序，並寄給你我的 Apple 防退件檢查清單。如果做完這些訂閱還是卡住，跟我預約一小時：我們一起打開你的 App Store Connect，把那個空欄位找出來。

常見問題

為什麼都填好了，我的訂閱還是卡在 Missing Metadata？

先檢查審查截圖，再檢查訂閱群組的顯示名稱，它看起來不是必填。接著確認價格、期間、至少一個國家，以及 Business 裡的付費 App 合約。每次修正後都要先儲存並重新整理頁面，再下結論。

訂閱需要截圖嗎？

需要，就是審查截圖，叫做 App Review Screenshot。它呈現這個購買項目在 App 裡的樣子，通常是付費牆，只給審查人員看，不會顯示在 App Store 上。別把它跟 1024 x 1024 像素的宣傳圖片搞混，宣傳圖片只在推廣購買項目或贏回優惠時才用得到。

可以不出新版本就送審訂閱嗎？

第一個不行。第一個訂閱和它的群組要跟 App 的新版本一起送出。第一個訂閱核准後，只要 App 有已核准的版本，後續的訂閱就能單獨送出。

App 內購買項目的 Prepare for Submission 是什麼意思？

這是 2026 年 7 月起 Apple 說明文件給尚未加入送審的產品的標籤。即使缺少中繼資料，也會顯示這個標籤。App Store Connect API 仍然用 MISSING_METADATA 和 READY_TO_SUBMIT 區分這兩種情況。

為什麼 RevenueCat 回傳空的 offering？

因為 App Store 沒有回傳任何產品給 iPhone。最常見的原因：中繼資料不完整、付費 App 合約未生效、產品 ID 不一致，或最近的修改還沒同步。你的付費牆必須處理這種情況，不能把使用者卡住。