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

> Missing Metadata 代表少了必填欄位。依序檢查語言、價格、期間、國家、審查截圖和付費合約，再把訂閱和 App 版本一起送審。

原始頁面：[App Store Connect Missing Metadata：訂閱卡住怎麼解](https://devoria.fr/zh-hant/blog/app-store-connect-missing-metadata-subscription)
作者：[Mehdi Azizi](https://devoria.fr/zh-hant/mehdi-azizi)
發布日期：2026-11-04
內容最後修訂：2026-11-04


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

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

## Missing Metadata 是什麼意思？

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

**注意，這個標籤在 2026 年 7 月改了。**[App Store Connect 版本說明](https://developer.apple.com/help/app-store-connect/release-notes/)在 7 月 15 日宣布了新的送審方式：每個 App 內購買項目都從自己的頁面，用 Add for Review 送出。[狀態說明頁](https://developer.apple.com/help/app-store-connect/reference/in-app-purchases-and-subscriptions/in-app-purchase-statuses/)已經不再列出「Missing Metadata」，第一個狀態變成「Prepare for Submission」，並註明：如果你的 App 內購買項目缺少必填中繼資料，請先補齊，再加入送審。[RevenueCat 的文件](https://www.revenuecat.com/docs/offerings/troubleshooting-offerings)也證實：送審前，新產品會顯示「Prepare for Submission」，即使它還缺中繼資料。

不過 [App Store Connect API](https://developer.apple.com/documentation/appstoreconnectapi/subscription/attributes-data.dictionary) 仍然會回傳 `MISSING_METADATA`，接著是 `READY_TO_SUBMIT`。所以依賴這個 API 的工具還是會顯示這些字。**不管標籤怎麼寫，診斷都一樣：有個必填欄位是空的。**

## 依序檢查的原因

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

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

**1. 產品的語言。**根據 [App 內購買項目資訊說明](https://developer.apple.com/help/app-store-connect/reference/in-app-purchases-and-subscriptions/in-app-purchase-information/)，顯示名稱和描述至少要在一種語言中填寫。名稱長度是 2 到 30 個字元，描述最多 45 個字元。沒有任何語言的產品無法送出。

**2. 群組的語言。**訂閱群組也有一個顯示名稱，你的訂閱者在 iPhone 上管理訂閱時會看到。它要在群組頁面的 Display Name and Description 區塊新增，[Apple 的訂閱說明頁](https://developer.apple.com/help/app-store-connect/manage-subscriptions/offer-auto-renewable-subscriptions/)有寫。這個欄位看起來不是必填。但有位開發者在 [Apple 論壇](https://developer.apple.com/forums/thread/778561)上說，只要它是空的，他群組裡的所有訂閱都會卡住。狀態顯示在訂閱上，而不是群組上，所以才容易搞混。

**3. 價格和期間。**訂閱需要設定期間（一週到一年）和價格。當產品載入不到時，技術說明 [TN3186](https://developer.apple.com/documentation/technotes/tn3186-troubleshooting-in-app-purchases-availability-in-the-sandbox) 第一步就是檢查這些：產品 ID、價格和語言。另外要記得，送審之後期間就不能再改了。

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

**5. 審查截圖。**這就是我在 TradaZen 上的狀況，也是論壇上常見的原因。「App Review Screenshot」要呈現這個購買項目在 App 裡的樣子，通常就是你的付費牆。它只給審查人員看，永遠不會出現在 App Store 上。它的規格跟你的 [App Store 截圖](https://devoria.fr/zh-hant/blog/app-store-screenshot-sizes-2026)一樣。上傳之後只能替換，不能刪除。

別把它跟 1024 x 1024 像素的宣傳圖片搞混。宣傳圖片只有在你要在產品頁上推廣這個購買項目，或建立贏回優惠時才用得到，而且有自己的規則。我是在[訂閱宣傳圖片](https://devoria.fr/zh-hant/blog/guideline-2-3-2-subscription-promotional-image-rejected)被退件之後才學到的。

**6. 付費 App 合約。**要提供 App 內購買項目，帳號持有人必須在 Business 裡[簽署 Paid Apps Agreement](https://developer.apple.com/help/app-store-connect/manage-agreements/sign-and-update-agreements/)，再填好銀行和稅務資料。這不是產品的欄位，但一切都取決於它。Apple 寫道，在你接受最新版合約之前，無法建立新的 App 內購買項目。它在[準備送審購買項目](https://developer.apple.com/help/app-review/before-submitting-for-review/configure-in-app-purchases/)的頁面還補充：這份合約生效前，付費購買在審查中無法運作。在 Business 裡，合約、銀行帳戶和稅務表單都必須是生效狀態。這些步驟在 [Apple 開發者帳號](https://devoria.fr/zh-hant/blog/apple-developer-account-price-free-or-99)指南裡有詳細說明。

**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 內購買項目的送審流程](https://developer.apple.com/help/app-store-connect/manage-submissions-to-app-review/submit-an-in-app-purchase/)會讓你選擇平台、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 審核時間](https://devoria.fr/zh-hant/blog/app-store-review-time)指南說明了多跑一輪會多花幾天。

## 跟 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 訂閱](https://devoria.fr/zh-hant/blog/revenuecat-ios-in-app-subscription-setup)指南裡，顯示上的陷阱則在[付費牆常見錯誤](https://devoria.fr/zh-hant/blog/ios-paywall-beginner-mistakes)。產品準備好之後，也要確認你的付費牆符合 [guideline 3.1.2](https://devoria.fr/zh-hant/blog/guideline-3-1-2-app-subscription-rejected)。

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

[iOS & Android Kit](https://devoria.fr/zh-hant/kits/ios) 是從我自己 App 的起始程式碼出發：引導流程、付費牆和訂閱都已經寫好，第三步「接上金流」會帶你完成設定。從 App Store Connect 的產品到購買驗證，整條流程都寫在 [iOS App 內訂閱](https://devoria.fr/zh-hant/expertise/ios-in-app-subscription)頁面上。

如果你正在準備第一次上架，[來做免費診斷](https://devoria.fr/zh-hant/diagnostic)：它會幫你把步驟排好順序，並寄給你我的 Apple 防退件檢查清單。如果做完這些訂閱還是卡住，[跟我預約一小時](https://devoria.fr/zh-hant/coaching)：我們一起打開你的 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 不一致，或最近的修改還沒同步。你的付費牆必須處理這種情況，不能把使用者卡住。


## 你的專案

[iOS & Android Kit](https://devoria.fr/zh-hant/kits/ios)：用 Claude Code 打造你的 iPhone 和 Android App：我自己 App 的起始程式碼、上架商店的完整流程，以及所有套件。$3,599。

[診斷：你離自己的 iPhone App 還差什麼](https://devoria.fr/zh-hant/diagnostic)：7 個問題，60 秒：找出真正卡住你發布 iPhone App 的原因，拿到你的 4 步驟路線，以及最適合你的套件。