---
title: "排查 App Store 集成问题"
description: "解决常见的 Apple App Store 配置问题——协议待处理、服务器通知延迟以及价格不匹配等情况。"
---

本文介绍常见的 App Store 集成问题，每个部分均包含症状描述、根本原因及解决方案。
## 产品未显示 \{#products-dont-appear\}

以下两种表现通常指向同一个根本原因：

- App Store Connect API 密钥配置正确，但 Adapty 无法获取任何产品。
- 产品已在 App Store Connect 中创建，但未出现在 Adapty 中，或显示数量少于预期。SDK 在尝试购买时报告 "Product Id not found"。
最常见的根本原因是 **Apple 协议未签署** — 付款协议、税务表格或银行表格处于待处理或未签署状态。当协议处于待处理状态时，App Store Connect API 会在产品相关端点静默返回 403 错误。Adapty 不会收到任何明确的报错提示，产品会被静默过滤掉。

请前往 **App Store Connect → Agreements, Tax, and Banking**，签署所有待处理的协议。然后在 Adapty 的 **App settings → iOS SDK** 中重新同步。
## App Store 服务器通知显示"Delayed" \{#app-store-server-notifications-show-delayed\}

在 App Store Connect 中，App Store 服务器通知的状态可能会显示为 **Delayed**。这意味着 Apple 在发送订阅事件通知方面出现了延迟——续订、取消和账单问题等通知会排队等待，并延迟到达。

安装统计数据不受影响。Adapty 从应用首次启动开始统计安装量，而非依赖服务器端通知。

如果续订或取消数据出现滞后，**Delayed** 状态是最可能的原因。随着 Apple 处理积压的通知，该状态通常会自动恢复正常。
## Adapty 中的价格与 App Store 不匹配 \{#prices-in-adapty-dont-match-app-store\}

Adapty 产品编辑页面上的**价格**字段的行为方式取决于产品的添加方式。

如果你在 Adapty 中创建产品并从看板推送到商店，该价格将作为商店的初始价格使用。
如果你添加的产品在商店中已存在，此价格仅作为占位符使用。Adapty 的分析、集成和 SDK 均以从 App Store 实际获取的价格为准，而非该占位符。App Store 价格发生变更后不会同步更新占位符，且目前无法在看板中手动编辑占位符。
## CSV 价格导出为空 \{#csv-price-export-is-empty\}

如果你导出的 CSV 价格文件只有列标题，说明 App Store Connect API 密钥未完成配置。请参阅[第 6 步 — 添加 App Store Connect API 密钥](app-store-connection-configuration#step-6-add-app-store-connect-api-key)。
## 无法将新产品推送至 App Store \{#cant-push-new-products-to-app-store\}

当你在看板中创建产品时，Adapty 可以将新产品推送至 App Store Connect。如果你的 App Store 集成尚未完整配置，推送选项将被禁用。以下两项设置为必填项：

- **Apple app ID**：在 [第 1 步 — 提供 Bundle ID 和 Apple app ID](app-store-connection-configuration#step-1-provide-bundle-id-and-apple-app-id) 中进行配置。
- **App Store Connect API 密钥**：在 [第 6 步 — 添加 App Store Connect API 密钥](app-store-connection-configuration#step-6-add-app-store-connect-api-key) 中进行配置。