Go-Pay项目中的苹果支付收据验证21003错误解析

在Go-Pay项目实现苹果应用内支付(IAP)功能时，开发者可能会遇到一个常见的错误代码21003。这个错误通常发生在验证苹果支付收据的过程中，特别是当开发者错误地处理了验证请求中的可选参数时。

错误原因分析

21003错误码在苹果官方文档中被定义为"receipt-data属性缺失或格式错误"。然而，在实际开发中，我们发现即使receipt-data字段正确传递，当开发者错误地包含了某些不应该存在的字段时，也会触发这个错误。

具体到Go-Pay项目中的实现，问题出现在apple/verify_model.go文件中的VerifyRequest结构体。该结构体包含两个特殊字段：

1. Password - 共享密钥字段
2. ExcludeOldTranscations - 排除旧交易标志

这两个字段在非订阅场景下是完全不需要的，但如果在请求中包含了它们，即使值为空字符串或false，也会导致苹果服务器返回21003错误。

技术实现细节

在苹果支付验证的JSON请求中，字段的处理需要特别注意。不同于一些其他API，苹果的验证接口对于可选字段的处理非常严格：

• 对于非订阅交易，password字段不应该出现在请求中
• 对于非订阅交易，exclude-old-transactions字段也不应该出现

Go-Pay项目最初的实现可能没有对这些可选字段做特殊处理，导致即使开发者不设置这些值，在JSON序列化时也会生成包含这些字段的请求(字段值为零值)，从而触发苹果服务器的21003错误。

解决方案

正确的实现方式应该是在JSON序列化阶段对这些可选字段进行条件处理：

1. 对于Password字段：当值为空字符串时，完全从生成的JSON中移除该字段
2. 对于ExcludeOldTranscations字段：当值为false时(非订阅场景的默认值)，完全从生成的JSON中移除该字段

这种处理方式符合苹果API的设计预期，可以避免21003错误的发生。在Go语言中，可以通过自定义JSON序列化逻辑或使用omitempty标签结合指针类型来实现这种条件序列化行为。

最佳实践建议

1. 区分交易类型：在代码实现中明确区分订阅交易和非订阅交易，对这两种场景使用不同的请求结构
2. 严格字段控制：对于苹果API的可选字段，确保只在需要时才包含在请求中
3. 错误处理：对21003错误码做特殊处理，提示开发者检查是否错误包含了可选字段
4. 测试覆盖：编写针对非订阅交易的测试用例，验证请求中确实不包含订阅相关的字段

通过以上改进，可以确保Go-Pay项目在处理苹果支付验证时更加健壮，避免因字段处理不当导致的21003错误，为开发者提供更稳定可靠的支付验证功能。