iPhone14 Safari无法下载.pkpass文件问题修复求助

问题描述 #

我使用Pass Converter将Google Pass转换为Apple Pass，输出文件存储在AWS S3中。用户访问链接时本应下载.pkpass文件（命名格式如applepass-95370f2a-cd77-4bcc-b52b-be22dff45415.pkpass），但在iPhone14的Safari中出现“Safari无法下载此文件”的错误。Windows端修改User Agent后可正常下载，且已通过凭证验证工具确认文件本身有效。

上传S3的代码如下：

if (req.passText.charAt(0) === '{') {
    try {
        const pkPassBuffer = await googleToPkPass(JSON.parse(req.passText), req.fullUrl);
        const params = { content: pkPassBuffer, contentType: 'application/vnd.apple.pkpass', }
        const applePassUrl = await uploadToS3(params);
        res.send({ msg: 'success', url: applePassUrl })
    } catch (e) {
        console.log(e);
    }
}

const uploadToS3 = async ({ content, contentType }) => {
 let random = seedrandom(`${new Date().getTime()}`)();
 const keyId = uuidv4(`link/${random}`, uuidv4.URL);
 const params = {
  Bucket: bucket,
   Key: `applepass-${keyId}.pkpass`,
   Body: content,
  ContentEncoding: "base64",
   ContentType: contentType,
   };

  const uploadedfile = await s3.upload(params).promise();
   return uploadedfile.Location.replace("s3.amazonaws.com/", "");
  }; 

问题根源 #

代码中上传S3时错误设置了ContentEncoding: "base64"，而pkPassBuffer是二进制Buffer而非base64编码字符串，导致S3返回的响应头包含Content-Encoding: base64，Safari无法正确解析文件格式。

解决步骤 #

1. 移除错误的ContentEncoding配置
   修改uploadToS3函数，删除ContentEncoding: "base64"项：

   const uploadToS3 = async ({ content, contentType }) => {
    let random = seedrandom(`${new Date().getTime()}`)();
    const keyId = uuidv4(`link/${random}`, uuidv4.URL);
    const params = {
     Bucket: bucket,
      Key: `applepass-${keyId}.pkpass`,
      Body: content,
      ContentType: contentType,
      };
   
     const uploadedfile = await s3.upload(params).promise();
      return uploadedfile.Location.replace("s3.amazonaws.com/", "");
     }; 
   

2. 确保S3响应头正确
   确认S3对象的响应头满足：

   • Content-Type必须为application/vnd.apple.pkpass
   • 可选：添加Content-Disposition: attachment; filename="applepass-xxx.pkpass"，明确告知浏览器以附件形式下载
   • 可选：设置Cache-Control: no-cache避免缓存旧的错误响应

3. 验证响应头
   使用curl命令检查文件的响应头：

   curl -I https://your-s3-bucket-url/applepass-xxx.pkpass
   

   确保输出中没有Content-Encoding: base64，且Content-Type正确。

4. 重新测试
   重新上传文件后，用iPhone14的Safari访问链接，应该可以正常识别文件并提示添加至Apple Wallet。

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