StoreKit2支付未知错误(unknown error)排查与解决

IOS

2025-03-12 18:37:45

StoreKit2 支付 “unknown error occurred” 问题排查与解决

用 StoreKit2 处理支付时遇到 “an unknown error occurred” 错误，挺让人头疼的。别担心，咱们一起来看看这个问题可能的原因和解决方法。

一、问题原因分析

出现 "an unknown error occurred" 错误，通常意味着 StoreKit2 在处理支付过程中遇到了一个未明确定义的异常。笼统地说，原因可能是：

网络问题: 设备网络不稳定，或者与 App Store 服务器连接中断。
苹果服务器问题： 偶尔，苹果自家的服务器也会抽风，导致支付流程出错。
StoreKit2 配置问题: SKProduct 信息没配置好，或者 Xcode 里的 Capabilities 设置不对。
沙盒环境问题: 在沙盒环境测试时，可能会因为账户问题或环境不稳定遇到一些奇怪的错误。
代码逻辑问题: 虽然问题中的代码看着还行，但不排除在其他地方有影响支付流程的代码逻辑。
iOS 系统 Bug: 极少数情况下，可能是 iOS 系统自身的 Bug。

二、问题解决

下面，根据上面列出的可能原因，分情况给出排查和解决建议。

1. 网络问题排查

网络不稳定是最常见原因之一。

原理： 支付需要与苹果服务器通信。如果网络差，通信就容易失败。
操作：
- 换个网络试试 (Wi-Fi 切换到蜂窝数据，或反过来)。
- 确认设备能正常访问其他网站，排除网络完全不通的情况。
代码检查
确保你的 App 具有访问网络的权限.

2. 苹果服务器状态检查

虽然不常见，但苹果服务器确实有可能出问题。

原理： 苹果服务器宕机或维护时，支付会受影响。
操作：
- 访问苹果系统状态页面：https://www.apple.com/support/systemstatus/。查看 App Store 相关服务是否有问题。

3. StoreKit2 配置检查

原理: StoreKit 要正确工作，需要一些配置。
操作:
- 检查 Product ID: 确保代码里用的 Product ID 和 App Store Connect 里配置的一致。差一个字母都不行!
- 检查 Xcode Capabilities:
  - 打开 Xcode 项目，选择 target。
  - 在 "Signing & Capabilities" 标签页里，确保 "In-App Purchase" 功能已启用。
  - 检查是否添加了 StoreKit 配置文件。

4. 沙盒环境测试注意事项

原理: 沙盒环境用来测试，和真实环境不一样，有些坑。
操作/建议:
- 使用测试账号: 在 App Store Connect 里创建测试员账户，用这个账户在沙盒环境测试。别用真实 Apple ID！
- 清空购买历史: 有时，沙盒环境的购买记录会出问题，导致测试出错。可以试试退出测试账号，重新登录，或者用一个全新的测试账号。
- 设备重启: 如果遇到奇怪问题，重启设备有时能解决（玄学，但有时有用）。

5. 代码逻辑审查与优化

虽然提供的那段代码没有特别明显的问题，但建议从这几方面仔细看看:

错误处理: 支付可能出各种错。你的代码捕获了 Error，但对不同的错误类型，处理可能可以更精细。

原理： 区分错误类型，可以给用户更准确的提示。

代码示例（改进 purchaseProduct 方法）:

func purchaseProduct(product: Product, source: String) async -> Bool {
     do {
        let result = try await product.purchase()
        switch result {
        //...原case
         @unknown default:
         //...原default case
        }
      } catch let error as SKError {
            // 处理 StoreKit 相关的错误
            self.transactionState = "StoreKit Error: \(error.localizedDescription), Code: \(error.code.rawValue)"
            handleSKError(error, product: product, source: source) // 单独的方法来处理SKError
             return false
        } catch {
            //处理其他类型的错误
            self.transactionState = "Purchase failed: \(error.localizedDescription)"

        DispatchQueue.main.async {
            showMessageWithTitle("Error!", "There was an error processing your purchase", .error)

            Amplitude.sharedInstance.track(
                eventType: "payment_failed",
                eventProperties: ["PlanId": product.id, "Source": source, "Error": error.localizedDescription]
            )
           }
            return false
        }
   }

  func handleSKError(_ error: SKError, product: Product, source: String)
   {
        switch error.code {
         case .unknown:
           print("未知错误,用户可能需要联系Apple 支持")
          //添加可能的处理
         case .clientInvalid:
           print("不允许支付.")
          //添加可能的处理
         case .paymentCancelled:
            print("用户取消了购买.")
           //添加可能的处理

        //... 其他 StoreKit 错误码 ...

         default:
         // 处理其他 StoreKit 错误
         break
    }

     // 这里可以根据具体的错误, 做不同的操作,例如：
     // - 弹出不同的提示给用户。
     // - 记录详细的错误日志，方便调试。
     // - 尝试恢复购买（某些错误情况下可以这样做）。
  }

安全建议
记录错误时，小心不要泄露敏感信息。

异步处理： purchaseProduct 是异步方法,注意与 UI 的交互.

*  **原理：**  避免卡住主线程。

*  **代码示例(强调):**  你已经在主线程处理结果了，挺好。 确认 `showMessageWithTitle` 不会阻塞UI。

进阶： Transaction 监听
* 原理： 监听 StoreKit 的交易变化。即使 App 退出,下次启动时也能处理未完成的交易.
* 实现（简略）:

    ```swift
     // 在 App 启动时（比如 AppDelegate）添加监听
        var taskHandle: Task<Void, Never>?

       func observeTransactions()
       {
            taskHandle = Task.detached {
                for await result in Transaction.updates {
                    //处理Transaction
                      switch result{
                    case .verified(let transaction):
                        print("Transaction verified in listener")
                        //...处理 verified 的交易
                        await transaction.finish()
                    case .unverified(_,_):
                        print("Transaction unverified in listener")
                        //... 处理unverified 交易
                        break
                    }
                }
            }
        }

        func stopObservingTransactions()
        {
            taskHandle?.cancel()
        }
    ```
 *  可以在 AppDelegate 的 `application(_:didFinishLaunchingWithOptions:)` 里调用 `observeTransactions()`。 在不需要监听的时候 (比如App进入后台） 调用`stopObservingTransactions()`.