uni-app接入iOS支付常见问题解析

Question

在使用 uni-app 接入 iOS 支付过程中，常见的技术问题之一是：**如何正确配置 iOS 应用的 Bundle ID 与 App Store Connect 的共享密钥，以确保支付流程顺利进行？** 该问题涉及 iOS 开发者账号配置、Xcode 项目设置以及 uni-app 的 manifest.json 文件配置。若 Bundle ID 不一致或 App Store Connect 的共享密钥未正确设置，将导致支付请求失败或返回“invalid product”等错误。开发者需确保前后端配置一致，并在 Apple Developer 和 App Store Connect 中正确创建和审核内购项目。

Answer 1

一、iOS 支付接入中的 Bundle ID 与共享密钥配置详解

在使用 uni-app 接入 iOS 支付流程时，开发者常常会遇到支付请求失败或返回“invalid product”等问题。这些问题往往与 iOS 应用的 Bundle ID 和 App Store Connect 的共享密钥配置密切相关。本文将从基础配置到深入分析，系统讲解如何正确设置这些关键参数。

1. Bundle ID 的作用与配置

Bundle ID 是 iOS 应用的唯一标识符，必须与 Apple Developer 和 App Store Connect 中注册的应用标识一致。在 uni-app 中，Bundle ID 的配置主要通过 manifest.json 文件进行设置。

配置步骤如下：

1. 登录 Apple Developer 网站，创建 App ID 并启用 In-App Purchase 功能。
2. 在 Xcode 中打开项目，进入 Signing & Capabilities 页面，确保 Bundle ID 与 Apple Developer 中一致。
3. 在 uni-app 的 manifest.json 文件中配置 iOS 包名（Bundle ID）：

"plus": {
  "distribute": {
    "ios": {
      "bundleid": "com.example.myapp"
    }
  }
}

2. App Store Connect 共享密钥的作用与配置

App Store Connect 的共享密钥（Shared Secret）是用于服务器端验证购买凭证的重要字段。若未正确配置，将导致支付验证失败。

配置步骤如下：

1. 登录 App Store Connect，进入 Users and Access > Keys 页面。
2. 创建新的共享密钥或使用已有密钥，并保存密钥值。
3. 将该密钥配置在后端服务中，用于验证 Apple 的支付收据。

示例：Node.js 后端验证支付凭证时使用共享密钥：

const receipt = '用户支付凭证';
const sharedSecret = 'your-shared-secret';

const response = await axios.post('https://buy.itunes.apple.com/verifyReceipt', {
  "receipt-data": receipt,
  "password": sharedSecret
});

3. 配置一致性验证流程图

graph TD A[uni-app manifest.json] --> B{Bundle ID一致性检查} B -->|一致| C[Xcode 项目配置] C --> D{Apple Developer App ID} D -->|一致| E[App Store Connect 内购配置] E --> F{共享密钥是否配置} F -->|是| G[支付流程正常] F -->|否| H[支付失败或 invalid product] B -->|不一致| H D -->|不一致| H

4. 常见错误与排查方法

错误类型	可能原因	解决方法
invalid product	Bundle ID 不一致，或内购商品未创建	检查 manifest.json、Xcode 和 Apple Developer 的 Bundle ID 是否一致；确认内购商品已创建并审核通过
receipt validation failed	共享密钥错误或收据格式错误	检查后端代码中的共享密钥是否正确；确认收据数据是否完整
Cannot connect to iTunes Store	网络问题或 Apple 服务器不可用	检查设备网络；尝试在不同时间重试；查看 Apple 系统状态页面