从iCloud获取图片时触发「Missing required primary zone」错误，重试可恢复

看起来你遇到的这种“偶尔失败但重试几次就好”的情况，在iCloud媒体资源请求里其实挺常见的，大概率是网络波动或者iCloud服务的临时限流/不稳定导致的，不一定是你的代码Bug，但咱们可以先排查下代码细节，再聊聊可能的原因和优化方向。

先贴出你的代码方便分析：

let options = PHImageRequestOptions()
options.deliveryMode = PHImageRequestOptionsDeliveryMode.highQualityFormat
options.isSynchronous = false
options.isNetworkAccessAllowed = true
options.progressHandler = { (progress, error, stop, info) in
    if let error = error {
        print(error.localizedDescription)
    }
    DispatchQueue.main.async {
        let numFormatter = NumberFormatter()
        numFormatter.maximumFractionDigits = 0
        if let progressString = numFormatter.string(from: NSNumber(value: progress * 100)) {
            print("Downloading from iCloud \(progressString) %")
            if progress >= 0.99 {
                self.hideLoadingLabel()
            }
        }
    }
    print("progress: \(progress)")
}
PHImageManager.default().requestImage(for: self.selectedAsset, targetSize: CGSize(width: 300, height: 300), contentMode: .aspectFill, options: options) { image, info in
    self.hideLoadingLabel()
    guard let image = image else { return }
    let vc = RSKImageCropViewController(image: image, cropMode: RSKImageCropMode.circle)
    vc.delegate = self
    DispatchQueue.main.async {
        self.navigationController?.pushViewController(vc, animated: true)
    }
}

代码里可以优化的细节 #

你的基础配置没什么问题，但有几个点可以完善，也能帮你更好定位问题：

• 错误处理不完整：进度回调里只打印了错误描述，但没记录错误类型/错误码，建议打印完整的error对象，比如print("Progress error: \(error)")，这样能知道是不是PHError里的网络相关错误（比如PHError.networkError）
• Completion里没处理错误：当前只判断了image是否存在，没利用info字典里的错误信息，这里可以补充捕获请求失败的具体原因
• 缺少自动重试逻辑：你现在是手动重试，其实可以在请求失败时自动触发重试，设置一个重试次数上限（比如3次）就很友好

为什么重试能解决问题？ #

这种情况基本都是临时的网络或服务端问题：

• 网络层面：iCloud请求需要跨区域连接Apple的服务器，偶尔的丢包、延迟过高会导致请求超时失败，重试相当于重新发起连接，避开了当时的网络波动
• 服务端层面：Apple的iCloud服务可能会有临时的限流、节点负载过高，重试几次后请求会被分配到更空闲的节点，自然就成功了

至于是不是Apple的Bug？大概率不是——如果是框架本身的Bug，重试通常不会解决问题，反而会持续失败。这种“软失败”场景其实是分布式服务里的常见情况，客户端重试是标准的解决方案。

优化建议 #

给你几个让代码更健壮的小改动：

1. 完善错误捕获和日志
   在requestImage的completion里补充错误处理：

   PHImageManager.default().requestImage(for: self.selectedAsset, targetSize: CGSize(width: 300, height: 300), contentMode: .aspectFill, options: options) { image, info in
       self.hideLoadingLabel()
       if let image = image {
           // 原有的图片处理逻辑
           let vc = RSKImageCropViewController(image: image, cropMode: RSKImageCropMode.circle)
           vc.delegate = self
           DispatchQueue.main.async {
               self.navigationController?.pushViewController(vc, animated: true)
           }
       } else {
           // 捕获请求错误
           if let error = info?[PHImageResultErrorKey] as? Error {
               print("Image request failed: \(error.localizedDescription), code: \(error._code)")
               // 这里可以根据错误码判断是否需要重试
               self.retryImageRequest()
           }
       }
   }
   

2. 实现自动重试机制
   写一个带重试次数的方法，避免手动重试：

   private func requestImageWithRetry(remainingRetries: Int = 3) {
       guard remainingRetries > 0 else {
           print("All retries exhausted, failed to get image")
           hideLoadingLabel()
           return
       }
       
       let options = PHImageRequestOptions()
       options.deliveryMode = PHImageRequestOptionsDeliveryMode.highQualityFormat
       options.isSynchronous = false
       options.isNetworkAccessAllowed = true
       options.progressHandler = { (progress, error, stop, info) in
           // 原有的进度处理逻辑...
       }
       
       PHImageManager.default().requestImage(for: self.selectedAsset, targetSize: CGSize(width: 300, height: 300), contentMode: .aspectFill, options: options) { [weak self] image, info in
           guard let self = self else { return }
           self.hideLoadingLabel()
           
           if let image = image {
               let vc = RSKImageCropViewController(image: image, cropMode: RSKImageCropMode.circle)
               vc.delegate = self
               DispatchQueue.main.async {
                   self.navigationController?.pushViewController(vc, animated: true)
               }
           } else if let error = info?[PHImageResultErrorKey] as? Error {
               print("Retry \(3 - remainingRetries + 1) failed: \(error.localizedDescription)")
               self.requestImageWithRetry(remainingRetries: remainingRetries - 1)
           }
       }
   }
   

   调用的时候直接用requestImageWithRetry()就行，它会自动重试最多3次。

3. 注意PHImageResultIsDegradedKey
   如果你的需求允许先显示低清图再加载高清图，可以把deliveryMode改成opportunistic，这样用户体验会更好，但如果必须要高清图，当前的highQualityFormat是对的。

总的来说，你的操作没有问题，这种情况属于iCloud请求的正常“偶发软失败”，通过补充错误日志和自动重试机制，就能让你的代码更稳定，不用手动重试啦。

内容的提问来源于stack exchange，提问作者Діма Комар