Apple Wallet Pass个性化功能异常：无法完成个性化配置

问题概述 #

Wallet凭证背面的「Add Personal Info」按钮点击后弹出错误：Unable to personalise Pass - The pass cannot currently be personalized，且服务端从未收到Apple Wallet应发送的webServiceURL/version/passes/passTypeIdentifier/serialNumber/personalize POST请求，后续个性化注册请求也无踪迹（但积分变更这类凭证更新请求能正常接收）。

已知前提 #

• NFC凭证已正常生成，个性化按钮显示正常
• 已获取NFC凭证权限
• 对比第三方可用示例凭证的pass.json、personalization.json等核心文件，字段配置完全一致（仅替换了团队标识与webServiceURL）

已做排查 #

• 用全新证书重新生成凭证
• 服务端新增/personalized路径（注意文档要求的是/personalize，需核对拼写）
• 新增服务端全链路日志，覆盖请求入口、路由解析环节
• 完全复刻示例凭证字段，仅替换团队标识与服务地址

关键排查点 #

1. 证书与权限 #

• 确认签名证书包含Pass Personalization权限：Apple Developer后台查看证书权限，个性化是独立权限，即使有NFC权限也需单独启用
• 检查证书链完整性：服务端需配置Apple最新信任链的根证书、中间证书，避免Wallet因证书不信任终止请求
• 核对pass.json中passTypeIdentifier与证书标识符完全匹配，无大小写或拼写错误

2. 服务端配置 #

• 严格匹配personalize接口路径：必须遵循webServiceURL/<version>/passes/<passTypeIdentifier>/<serialNumber>/personalize格式，注意是personalize而非personalized
• 确保接口支持POST方法：该接口仅接受POST，检查是否有限制请求方法的配置
• 验证请求头处理：Wallet发送的请求带特定Authorization头（基于设备令牌），确认服务端未拦截或因签名校验失败丢弃请求
• 排查防火墙/CDN：确认未屏蔽Apple Wallet的请求IP段，也未对请求路径做错误重定向

3. 凭证配置细节 #

• 检查personalization.json的requiredPersonalizationFields：字段名称需与服务端一致，不能包含Apple不支持的类型
• 确认webServiceURL是HTTPS且域名SSL证书有效：Apple不允许HTTP地址
• 验证serialNumber唯一性：每个凭证的序列号必须唯一，避免重复导致Wallet跳过请求

测试建议 #

• 用Charles/Proxyman抓包：在测试设备上配置代理，查看Wallet是否发出请求、是否被拦截或返回错误
• 用passlint工具检查pkpass：验证凭证文件的合规性与完整性
• 临时替换服务地址：把我方凭证的webServiceURL换成第三方可用地址，测试是否能触发请求，区分是凭证还是服务端问题

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