Play Billing Library：恢复购买选queryPurchases还是queryPurchaseHistoryAsync？

嘿，这个问题问到点子上了——跨设备或刷机后恢复购买是付费应用体验里的关键环节，我帮你理清楚queryPurchases()和queryPurchaseHistoryAsync()的区别，以及对应场景下的正确用法：

先搞懂两个方法的核心差异 #

• queryPurchases()：这是查询用户当前拥有的有效购买项，比如永久解锁的非消耗品、处于订阅期内的订阅。它返回的是用户当前实实在在能享受的权益状态，是实时同步Play商店的结果。
• queryPurchaseHistoryAsync()：这是查询用户的购买历史记录，不管当前是否有效——哪怕订阅过期了、消耗品已经用掉了，只要用户买过，都会返回该商品的最近一次购买记录。但它不代表用户当前还拥有这个权益。

针对你的场景：换新机/刷机后该用哪个？ #

优先用**queryPurchases()**！

因为你的需求是确认用户是否「仍然拥有解锁应用功能的权益」：

• 对于永久解锁的非消耗品，用户一旦购买成功，queryPurchases()会一直返回这条购买记录（只要登录同一个Google账号），直接用它来触发本地升级函数就对了。
• 如果是订阅类的解锁，它会返回当前处于有效期内的订阅，同样可以直接解锁功能。

那queryPurchaseHistoryAsync()什么时候用？
它适合作为「兜底方案」：当用户点击「恢复购买」按钮，但queryPurchases()没有返回结果时，可以调用它来验证用户是否真的有过购买记录。比如用户的订阅刚过期，但之前确实买过，或者网络问题导致queryPurchases()查询失败，这时候用历史记录辅助排查，或者引导用户联系支持。

实践中的最佳流程建议 #

1. 应用启动自动检查：每次打开应用时，调用queryPurchases()，如果查到有效购买项，直接静默解锁功能，不用用户操作。
2. 提供手动恢复按钮：在设置或付费界面加一个「恢复购买」按钮，点击时：
   • 先调用queryPurchases()，有结果就解锁；
   • 若无结果，调用queryPurchaseHistoryAsync()，如果查到对应商品的购买记录，可以尝试再次确认（比如重新发起购买验证，或直接解锁，具体看你的商品类型）；
   • 处理网络异常，给用户友好提示，比如「网络不稳定，请稍后再试」。

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