iOS：从沙盒外Files文件夹加载PDF时PDFDocument为nil求助

核心问题1：URL创建方式错误 #

你当前用URL(fileURLWithPath:)传入了带file://前缀的完整URL字符串，这是错误用法。fileURLWithPath:的参数应该是不带协议前缀的本地路径字符串，而带file://的字符串需要用URL(string:)来初始化。

错误代码的问题：

// 错误：fileURLWithPath 不需要 file:// 前缀
let url = URL(fileURLWithPath: "file:///private/var/mobile/Library/Mobile%20Documents/iCloud~com~uvita/Documents/Symptom%20Checker_E07DB307-667A-4BFA-A4D7-AE6F0F2AE3F4.pdf")

修正后的URL创建方式二选一：

// 方式1：用 URL(string:) 处理带 file:// 的完整URL字符串
if let url = URL(string: "file:///private/var/mobile/Library/Mobile%20Documents/iCloud~com~uvita/Documents/Symptom%20Checker_E07DB307-667A-4BFA-A4D7-AE6F0F2AE3F4.pdf") {
    guard let pdf = PDFDocument(url: url) else { return nil }
    // 处理PDF
}

// 方式2：去掉 file:// 前缀，用 fileURLWithPath:
let path = "/private/var/mobile/Library/Mobile%20Documents/iCloud~com~uvita/Documents/Symptom%20Checker_E07DB307-667A-4BFA-A4D7-AE6F0F2AE3F4.pdf"
// 注意：路径中的百分号转义需先解码
if let decodedPath = path.removingPercentEncoding {
    let url = URL(fileURLWithPath: decodedPath)
    guard let pdf = PDFDocument(url: url) else { return nil }
    // 处理PDF
}

核心问题2：iCloud文件的访问权限与本地可用性 #

即使URL正确，iCloud Drive中的文件可能只是占位符文件（未实际下载到本地），或者App未获得足够访问权限，都会导致PDFDocument加载失败。

解决步骤：

• 确保App已开启iCloud Drive权限：在项目配置的Signing & Capabilities中添加iCloud，勾选iCloud Drive。
• 检查文件状态并触发下载：

  let fileManager = FileManager.default
  // 检查文件是否存在
  guard fileManager.fileExists(atPath: url.path) else {
      print("文件不存在")
      return nil
  }
  // 检查是否为iCloud占位符文件
  if fileManager.isUbiquitousItem(at: url) {
      do {
          // 手动触发文件下载
          try fileManager.startDownloadingUbiquitousItem(at: url)
          // 可结合NSFilePresenter监听下载完成状态后再加载PDF
      } catch {
          print("下载失败：\(error)")
          return nil
      }
  }
  

• 使用NSFileCoordinator访问iCloud文件（避免并发访问冲突）：

  let coordinator = NSFileCoordinator()
  var error: NSError?
  coordinator.coordinate(readingItemAt: url, options: [], error: &error) { safeURL in
      guard let pdf = PDFDocument(url: safeURL) else {
          print("加载PDF失败")
          return
      }
      // 处理PDF
  }
  if let error = error {
      print("文件协调失败：\(error)")
  }
  

额外排查点 #

1. 路径转义问题：确认Mobile%20Documents这类转义字符已正确解码，否则会指向不存在的文件夹。
2. 文件完整性：用系统Files App打开该PDF，确认文件本身未损坏。

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