Swift中FileManager无法找到iPhone Files应用内文件的问题求助

核心原因 #

Files应用展示的文件并非都存放在本地documentDirectory，可能分布在iCloud云盘、应用沙盒的Inbox目录，或是其他应用的共享容器中，你的代码仅读取本地文档目录，自然无法找到跨位置的文件。

针对性解决方案 #

1. 检查应用沙盒的Inbox目录 #

当用户通过「添加到[你的应用]」导入文件时，文件会默认存放在documentDirectory下的Inbox子目录，而非直接放在根目录：

func getInboxDirectory() -> URL {
    let documentsUrl = getDocumentsDirectory()
    return documentsUrl.appendingPathComponent("Inbox")
}

可以直接遍历这个目录查找目标文件。

2. 读取iCloud云盘中的文件 #

如果文件存放在iCloud云盘（包括应用专属的iCloud容器），需要先开启iCloud能力（Xcode中Signing & Capabilities添加iCloud并勾选iCloud Documents），再通过以下代码获取iCloud文档目录：

func getiCloudDocumentsDirectory() -> URL? {
    guard let iCloudContainerUrl = FileManager.default.url(forUbiquityContainerIdentifier: nil) else {
        return nil
    }
    return iCloudContainerUrl.appendingPathComponent("Documents")
}

之后可以遍历该目录查找文件，注意需要处理iCloud文件的加载状态（比如使用NSFileCoordinator确保文件已下载）。

3. 递归遍历所有可访问目录 #

如果不确定文件位置，可以递归遍历应用沙盒和iCloud容器的所有目录：

func searchFile(named fileName: String) -> URL? {
    let fileManager = FileManager.default
    
    // 遍历本地文档目录
    guard let localEnumerator = fileManager.enumerator(at: getDocumentsDirectory(), includingPropertiesForKeys: nil) else {
        return nil
    }
    for case let url as URL in localEnumerator {
        if url.lastPathComponent == fileName {
            return url
        }
    }
    
    // 遍历iCloud文档目录
    if let iCloudDir = getiCloudDocumentsDirectory(), 
       let iCloudEnumerator = fileManager.enumerator(at: iCloudDir, includingPropertiesForKeys: nil) {
        for case let url as URL in iCloudEnumerator {
            if url.lastPathComponent == fileName {
                return url
            }
        }
    }
    
    return nil
}

4. 处理跨应用共享文件的权限 #

如果文件来自其他应用，需要通过UIDocumentPickerViewController获取访问权限，临时访问文件或复制到自己的沙盒：

// 打开文件选择器
func openDocumentPicker() {
    let picker = UIDocumentPickerViewController(forOpeningContentTypes: [.item])
    picker.delegate = self
    present(picker, animated: true)
}

// 实现UIDocumentPickerDelegate
extension YourViewController: UIDocumentPickerDelegate {
    func documentPicker(_ controller: UIDocumentPickerViewController, didPickDocumentsAt urls: [URL]) {
        guard let fileUrl = urls.first else { return }
        
        // 开启临时访问权限
        guard fileUrl.startAccessingSecurityScopedResource() else {
            print("无法获取文件访问权限")
            return
        }
        defer { fileUrl.stopAccessingSecurityScopedResource() }
        
        // 复制文件到本地文档目录
        let destUrl = getDocumentsDirectory().appendingPathComponent(fileUrl.lastPathComponent)
        do {
            try FileManager.default.copyItem(at: fileUrl, to: destUrl)
            print("文件已复制到本地：\(destUrl)")
        } catch {
            print("复制失败：\(error.localizedDescription)")
        }
    }
}

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