iOS自动续期订阅触发SKErrorDomain Code=0 (null)报错如何排查？

SKErrorDomain错误码0对应苹果官方定义的SKErrorUnknown，属于未归类的StoreKit通用错误，返回空描述是系统层面没有生成可解析的错误文本，属于非常常见的内购异常场景。

常见触发原因 #

• 用户侧App Store账号异常：账号未绑定有效支付方式、账号存在未结清的账单、账号所在区域不支持当前订阅产品、开启了屏幕使用时间的内购限制、账号刚完成登录状态未同步完成
• 客户端逻辑缺失：调用支付前未判断用户是否开启内购权限、交易失败后未及时调用finishTransaction导致队列交易堆积、重复添加相同支付请求到SKPaymentQueue
• 产品配置问题：订阅产品未在对应区域配置定价、自动续期订阅的权限配置未同步到App Store生产环境

可落地的排查措施 #

• 补充前置校验逻辑：调用[[SKPaymentQueue defaultQueue] addPayment:payment]前必须添加[SKPaymentQueue canMakePayments]判断，返回NO时直接提示用户开启内购权限，无需发起后续支付请求
• 完善错误日志采集：除了error.description，额外采集error.userInfo全量字段、error.userInfo[NSUnderlyingErrorKey]子错误信息、用户App Store区域、当前系统版本、对应订阅产品ID、发起支付时的网络状态，大部分未知错误可以从子错误字段中拿到明确原因
• 场景复现验证：
  • 使用未绑定支付方式的App Store账号测试订阅流程
  • 使用开启了内购限制的账号测试
  • 使用存在未结清账单的账号测试
• 交易流程校验：检查didFailTransaction方法内是否调用了[[SKPaymentQueue defaultQueue] finishTransaction:transaction]，未调用会导致交易队列堆积，后续新的支付请求大概率触发未知错误
• 降级兼容策略：遇到该错误时不要直接提示支付失败，可先引导用户检查App Store账号状态，间隔3-5秒后自动重试1次支付，大部分场景可自动恢复

内容的提问来源于stack exchange，提问作者vmeyer