Apple Wallet Pass多二维码配置异常：传入数组仅显示单个二维码求助

开发者阿泽

2026-6-17

解决Apple Wallet Pass多二维码横向滑动切换的问题

以下是针对单张Pass展示多个可滑动二维码的排查和解决措施：

确认Pass类型支持多条形码
并非所有Apple Wallet Pass类型都支持多条形码横向切换，比如StoreCard等部分类型默认仅显示第一个条形码。优先选择Coupon、EventTicket或BoardingPass这类明确支持多条形码展示的Pass类型，在pass.json的根节点指定对应的类型（如"passTypeIdentifier": "pass.com.yourdomain.coupon"，同时确保"coupon": {}节点存在）。

修正JSON格式错误
你提供的代码中存在多余的转义双引号（"），这会导致JSON解析异常，Pass只会加载第一个合法的条形码项。正确的barcodes数组格式应为：

"barcodes": [
    {
      "format": "PKBarcodeFormatQR",
      "message": "QR Code 1: https://example.com/code1",
      "messageEncoding": "iso-8859-1",
      "altText": "QR Code 1"
    },
    {
      "format": "PKBarcodeFormatQR",
      "message": "QR Code 2: https://example.com/code2",
      "messageEncoding": "iso-8859-1",
      "altText": "QR Code 2"
    }
  ]

用JSON校验工具确认整个pass.json无语法错误，比如逗号遗漏、括号不匹配等问题。

检查iOS版本兼容性
Apple Wallet的多条形码横向滑动功能是iOS 14及以上版本才支持的特性。如果测试设备系统版本低于iOS 14，无论配置如何都只会显示第一个二维码，需将设备升级到iOS 14或更高版本后重试。
排查自定义布局限制
若你使用了自定义的layout.json或pass.strings配置，需确认条形码区域的布局设置未限制仅显示单个条形码。避免在布局中给条形码容器设置固定宽度或隐藏滚动属性，确保Wallet应用能自动渲染可滚动的条形码列表。
清除Pass缓存并重新添加
设备上已有的Pass缓存可能导致新配置不生效。先删除Wallet中对应的旧Pass，重新生成经过正确签名的Pass文件，再添加到Wallet中测试。