用途:当用户报告 RevenueCat 行为异常(offerings 为空、商品缺失、购买成功但权益未解锁、paywall 无法渲染、沙盒交易未进仪表盘)时,用本技能排查。
排查顺序:先识别平台(React Native、Flutter、KMP、原生 Android、原生 iOS),再走统一的代码侧九项检查:开启 debug 日志复现、核对 API key 平台前缀(iOS 用 appl_,Android 用 goog_/amzn_)、核对 bundle ID 或 package name、核对当前 offering 与包、核对商店商品状态、核对测试账号、核对网络、核对 appUserID、重装重试。多数问题在前五步解决。
仪表盘检查:使用 RevenueCat MCP 或 rc CLI,先 list-projects 选择项目,再依次检查 apps、products(get-product-store-state 看 store_status)、entitlements、offerings、webhooks,生成诊断报告并可经用户确认后执行 attach-products-to-entitlement、attach-products-to-package 等修复。对应 CLI 如 rc offerings list、rc apps list、rc apps keys <app-id>、rc products show <product-id> --store-state。
验证:日志从报错变为预期成功行、仪表盘反映变更、原复现步骤通过后才算修复。
参考:附带常见错误码(INVALID_APP_USER_ID、INVALID_CREDENTIALS、NETWORK_ERROR 等)、调试日志解读(iOS Purchases.logLevel = .debug,Android Purchases.logLevel = LogLevel.DEBUG)、平台已知问题(iOS 18 相关 StoreKit 问题、Android desugaring 等)、平台配置清单及 App Store 审核问题。
限制:资料未提供收费、价格与授权信息;具体命令行为以官方文档和实际工具为准。