Android端queryPurchaseHistoryAsync为何无法获取促销码兑换记录？

哦，这个坑我之前踩过！用促销码兑换后queryPurchaseHistoryAsync没返回记录确实挺头疼的，我来帮你捋捋可能遗漏的点：

• 促销码对应的是免费权益，历史接口默认过滤免费交易
  queryPurchaseHistoryAsync的设计初衷是返回用户产生过实际支付行为的历史记录，很多情况下免费兑换的促销码（比如免费订阅、免费一次性商品）不会被包含在这个接口的返回结果里。这时候你需要补充调用queryPurchasesAsync——这个接口会返回用户当前拥有的所有有效购买/兑换权益，包括通过促销码获取的内容，更适合用来校验用户是否已兑换成功。

• 没监听实时的兑换回调事件
  用户兑换促销码的操作，Google Play会主动通过PurchasesUpdatedListener发送购买更新通知，而不是只靠你主动查询历史。如果你只依赖了queryPurchaseHistoryAsync的定时查询，就可能错过兑换完成后的实时记录。确保你的应用在兑换流程中保持PurchasesUpdatedListener活跃，并且处理Purchase.PurchaseState.PURCHASED状态的事件，哪怕是免费兑换的订单也要处理。

• 查询的商品类型不匹配
  比如你调用queryPurchaseHistoryAsync时只传入了BillingClient.SkuType.INAPP，但促销码兑换的是订阅类商品（SkuType.SUBS），那自然查不到对应记录。要确保你查询的商品类型覆盖了促销码对应的品类，或者分别调用接口查询两种类型的记录。

• 历史记录的同步延迟
  Google Play的历史记录同步可能存在10-15分钟的延迟，刚完成兑换就调用queryPurchaseHistoryAsync可能还没同步到服务器。这种情况下可以先通过queryPurchasesAsync获取当前权益，等一段时间后再用历史接口做补充校验。

• 账号同步问题
  极少数情况下，设备上的Google Play账号同步异常会导致本地查询不到最新记录。可以引导用户先去Google Play的「订单」或「订阅」页面确认兑换是否成功，然后让应用重新调用queryPurchasesAsync拉取最新状态。

简单来说，queryPurchaseHistoryAsync更偏向于付费交易的历史台账，而促销码兑换的免费权益，优先用queryPurchasesAsync获取当前拥有的权益，同时配合实时回调监听，才能准确捕捉到兑换操作。

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