Apple Wallet出现spurious push及unchanged pass错误，如何解决？

这两个错误是Apple Wallet服务端集成里相当常见的问题，我帮你逐个拆解原因和修复方案：

错误1：设备收到spurious push，passesUpdatedSince请求未返回序列号 #

问题根源 #

从日志里的时间戳30657301263000就能看出核心问题——这个值是毫秒级的Unix时间戳，但Apple Wallet要求的是秒级时间戳，直接导致服务端查询不到对应时间范围内的更新内容；另外，"spurious push"说明你的服务端可能触发了不必要的推送（比如测试误操作、逻辑bug导致的重复推送），当设备收到推送后发起更新请求时，服务端没有对应的数据可以返回。

修复步骤 #

• 修正时间戳处理逻辑：确保服务端在处理passesUpdatedSince参数时，将客户端传入的时间戳转换为秒级（如果客户端传的是毫秒，就除以1000），同时检查推送触发时携带的时间参数是否为正确的秒级Unix时间戳。
• 严格控制推送触发条件：只有当通行证确实发生更新（比如内容修改、状态变更）时，才向Apple的推送服务器发送更新通知，避免误发无效推送。
• 规范passesUpdatedSince接口响应：如果查询后没有符合条件的更新通行证，直接返回204 No Content状态码，或者返回空的serialNumbers数组（格式示例：{"serialNumbers": []}），不要返回空响应或错误状态码。
• 同步服务端与标准时间：确保你的服务端时间和全球标准时间同步，避免因为时间偏差导致查询逻辑失效。

错误2：服务器忽略if-modified-since头，返回完整未变更通行证数据 #

问题根源 #

Apple Wallet会通过If-Modified-Since请求头来判断通行证是否有更新，你的服务端没有正确校验这个头，每次都返回完整的通行证数据，违反了HTTP缓存规范，因此被Apple标记为错误。

修复步骤 #

• 实现If-Modified-Since校验逻辑：当客户端请求单个通行证时（通过序列号），先读取请求头里的If-Modified-Since值，解析为RFC 1123格式的时间，和该通行证的最后更新时间对比。
• 返回正确的响应状态码：如果通行证最后更新时间 <= If-Modified-Since的时间，直接返回304 Not Modified状态码，不要返回任何通行证数据；如果有更新，返回200 OK和完整的通行证JSON。
• 设置标准响应头：在返回通行证数据时，务必在响应头里添加Last-Modified字段，值为通行证最后更新时间的RFC 1123格式（比如日志里的Fri, 19 Jul 2019 09:43:14 GMT），让客户端下次请求能携带正确的If-Modified-Since头。
• 校验时间格式一致性：确保服务端生成和解析的时间格式都是RFC 1123标准，避免因为格式不匹配导致校验失败。

总结 #

这两个问题本质都是服务端没有严格遵循Apple Wallet REST API的规范，只要把时间戳处理、推送逻辑、HTTP缓存头这几点按要求修正，就能彻底解决这些错误日志。

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