TPInAppReceipt常见问题解答：解决99%的收据验证难题

2026/7/30 23:37:44

TPInAppReceipt常见问题解答：解决99%的收据验证难题

【免费下载链接】TPInAppReceiptReading and Validating In App Purchase Receipt Locally.项目地址: https://gitcode.com/gh_mirrors/tp/TPInAppReceipt

TPInAppReceipt是一款用于本地读取和验证iOS应用内购买收据的专业工具，能够帮助开发者轻松处理收据验证过程中的各种复杂问题。本文将解答使用TPInAppReceipt时最常见的问题，助你快速解决收据验证难题。

收据验证失败的常见原因及解决方法

证书链验证失败

证书链验证是确保收据真实性的重要环节，常见错误包括证书数据无效、链验证失败和吊销检查失败。

解决方法：

确保使用正确的根证书。TPInAppReceipt会根据收据环境自动选择Apple根证书，你也可以通过X509ChainVerifier或SecChainVerifier自定义根证书。
检查证书是否过期或被吊销。证书链验证会检查证书的有效性和状态，确保使用的是最新的有效证书。

签名验证错误

签名验证用于确认收据的完整性，常见错误有无效密钥和无效签名。

解决方法：

确认使用正确的签名验证器。TPInAppReceipt提供了SignatureVerifier（基于swift-crypto）和SecSignatureVerifier（基于Security.framework）两种选择，根据你的使用场景选择合适的验证器。
检查签名数据是否完整。确保收据数据没有被篡改或损坏，签名数据与收据数据匹配。

哈希验证不通过

哈希验证用于验证收据与设备、应用信息的匹配性，常见错误包括设备标识符缺失和哈希不匹配。

解决方法：

提供正确的设备标识符。哈希验证需要设备标识符、收据的 opaque 值和应用的 bundle identifier 来计算哈希值，确保提供了有效的设备标识符。
检查应用信息是否匹配。确保应用的 bundle identifier 和版本信息与收据中的信息一致，你可以使用MetaVerifier来验证这些信息。

如何进行自定义验证

TPInAppReceipt允许你构建自定义的验证器，以满足特定的验证需求。你可以使用@VerifierBuilder来组合不同的验证器，灵活地包含或排除任何验证步骤。

以下是一个自定义验证器的示例：

let validator = ReceiptValidator { X509ChainVerifier(rootCertificates: [rootCert]) SignatureVerifier() HashVerifier(deviceIdentifier: deviceId) MetaVerifier( appVersionProvider: { Bundle.main.appVersion }, bundleIdentifierProvider: { Bundle.main.bundleIdentifier } ) } let result = await validator.validate(receipt)

在自定义验证器中，你可以选择使用不同的验证器组合，验证器会通过TaskGroup并行运行，如果任何一个验证器失败，其余的验证器将被取消。