iOS开发读取.pkpass内置pass.json遇未知编码问题如何解决

AI 小北

2026-10-6

首先你遇到的不是字符编码问题，优先排查文件本身的身份和提取流程是否正确，按照以下步骤排查即可：

排查步骤

第一步：确认.pkpass解压流程正确
.pkpass本质是标准ZIP格式归档，你需要完整解压整个归档文件后再提取内部的pass.json，不能直接读取未解压的归档片段。可以直接用shell命令完成完整解压：
```
unzip 你的凭证文件.pkpass -d pass_extract
```
解压后的目录下必须包含pass.json、manifest.json、signature三个核心文件，确认你读取的是该目录下的pass.json。
第二步：校验文件身份
如果你确认已经完整解压仍得到二进制内容，先验证你读取的是不是正确的pass.json文件：
1. 打开同目录下的manifest.json，这是纯文本文件，里面记录了所有文件对应的SHA-1哈希值，找到pass.json对应的哈希字符串
2. 执行命令计算你手上二进制文件的哈希：
```
shasum pass.json
```
3. 对比两个哈希值，如果不一致说明你提取文件时出错，误将其他二进制文件（如签名文件、资源文件）当成了pass.json。
第三步：排查嵌套压缩/自定义加密
如果哈希值匹配仍为二进制内容，说明该pass.json被发行方额外做了压缩或加密处理，优先测试常见压缩格式：
1. 测试gzip压缩：
```
gzip -dc pass.json
```
  若输出明文JSON则说明是gzip压缩，代码中先做gzip解压再解析即可。
2. 测试zlib压缩，可通过Python快速验证：
```
import zlib
with open("pass.json", "rb") as f:
    print(zlib.decompress(f.read()))
```
3. 以上都无输出的情况下，属于发行方自定义加密逻辑，需要联系凭证发行方获取对应的解密密钥和算法规则。
第四步：解析逻辑实现
按照苹果PassKit的官方规范，正常的pass.json为UTF-8编码的纯文本JSON，拿到明文后直接用UTF-8编码读取解析即可，不需要尝试其他编码格式。