Uniapp 内购漏单
Uniapp 内购漏单问题解决方案
问题描述
Uniapp 应用在接入苹果（Apple IAP）或谷歌（Google Play Billing）内购时，可能出现支付成功但未正常交付商品的情况（漏单）。常见原因包括网络波动、支付回调处理不当、服务端验证失败等。
客户端优化方案
确保支付回调监听
在应用启动时（如 App.vue 的 onLaunch 中）注册全局支付监听，避免因页面跳转导致回调丢失。示例代码（以苹果 IAP 为例）：
uni.onIAPPaymentComplete(res => {
if (res.transactionState === 'purchased') {
// 调用服务端验证接口
this.verifyPayment(res.transactionReceipt);
}
});处理网络中断场景
支付过程中若网络中断，需在应用恢复时主动查询未完成的订单。使用 uni.getIAPTransaction 获取本地未完成的交易记录。
服务端验证机制
双重校验流程
- 客户端支付成功后，立即将支付凭证（如苹果的
receipt-data）发送至服务端。 - 服务端向苹果/谷歌服务器发起二次验证，确认支付有效性。
- 验证通过后，再更新用户权益并返回结果给客户端。
订单状态标记
数据库设计时需包含订单状态字段（如 pending、completed、failed），通过定时任务补偿处理长时间处于 pending 的订单。
日志与监控
关键日志记录
- 客户端：记录支付发起、回调触发时间及原始数据。
- 服务端：保存验证请求和响应日志，便于追溯问题。
实时报警
监控支付成功但未完成交付的订单比例，超过阈值时触发报警，人工介入排查。
测试与模拟
沙箱环境测试
- 苹果 IAP 使用 Sandbox 账号测试，模拟网络延迟、中断等异常场景。
- 谷歌 Play 使用测试许可证和虚假卡号验证。
补单工具开发
提供管理后台手动补单功能，输入交易凭证后可强制重新验证并交付商品。
其他注意事项
避免重复发货
服务端验证时需检查订单是否已处理，防止因客户端重复提交导致多次发货。
用户引导
支付结果页提供「未到账反馈」入口，收集漏单案例辅助排查。
通过以上方法可显著降低漏单概率，需结合具体业务逻辑调整实现细节。
