iOS调用trashItem移文件至回收站遇权限拒绝错误

我之前也遇到过类似的iCloud文档操作权限问题，结合你的描述，应该是iOS 13之后系统对iCloud容器内文件的访问规则有了更严格的限制，尤其是针对包结构的UIDocument。下面是几个针对性的排查和解决方向：

一、先确认iCloud文件的访问方式是否正确 #

iCloud容器的路径不是固定的，手动拼接URL很容易踩坑，而且iOS 13+对安全作用域资源的访问要求更严：

• 务必使用UIDocument实例的fileURL来获取目标路径，不要自己拼接。
• 在调用trashItem前，先通过startAccessingSecurityScopedResource()获取临时访问权限（只要你的应用开启了iCloud Documents权限，这个步骤就很有必要）：

let docURL = yourDocument.fileURL
guard docURL.startAccessingSecurityScopedResource() else {
    print("无法获取文件访问权限")
    return
}
do {
    var trashedURL: URL?
    try FileManager.default.trashItem(at: docURL, resultingItemURL: &trashedURL)
    print("文件已移入最近删除: \(trashedURL ?? docURL)")
} catch {
    print("移至回收站失败: \(error.localizedDescription)")
} finally {
    docURL.stopAccessingSecurityScopedResource()
}

二、检查Info.plist的iCloud配置是否完整 #

iOS 13之后，iCloud容器的配置项不能有遗漏，否则会导致权限校验失败：

• 确认NSUbiquitousContainers字典里，你的容器标识符（iCloud~com~hazlett~KnitMate）下：
  • NSUbiquitousContainerIsDocumentScopePublic设为YES，允许应用访问容器内的文档目录。
  • NSUbiquitousContainerSupportedFolderLevels设为Any，支持多层文件夹操作（你的路径里有Folder 1，这个配置必须有）。
• 另外，确保NSUbiquitousContainerName也正确设置了，这个是iCloud Drive里显示的文件夹名称。

三、处理UIDocument包结构的特殊情况 #

因为你的文档是包结构（本质是一个目录），操作前要确保：

• 对应的UIDocument已经调用了close(completionHandler:)，并且完成了关闭操作。如果文档处于打开状态，包内的文件会被锁定，导致trashItem无法操作。
• 可以先验证下URL的目录属性：

var isDir: ObjCBool = false
if FileManager.default.fileExists(atPath: docURL.path, isDirectory: &isDir), isDir.boolValue {
    // 是目录，继续操作
} else {
    print("URL指向的不是包目录")
}

四、用NSFileCoordinator协调文件操作 #

iCloud文档的操作经常需要文件协调器来避免冲突，尤其是在多设备同步或者系统后台操作的情况下：

let fileCoordinator = NSFileCoordinator(filePresenter: yourDocument)
fileCoordinator.coordinate(writingItemAt: docURL, options: .forDeleting, error: nil) { (coordinatedURL) in
    do {
        var trashedURL: URL?
        try FileManager.default.trashItem(at: coordinatedURL, resultingItemURL: &trashedURL)
    } catch {
        print("协调后移至回收站失败: \(error)")
    }
}

通过协调器拿到的URL是经过系统校验的，能避免很多权限和锁定问题。

五、关于错误日志的补充说明 #

你看到的Cocoa 257权限错误，大概率是这几个原因：

1. URL路径有编码问题，比如手动拼接时没有正确转义空格或特殊字符（用UIDocument的fileURL就不会有这个问题）。
2. 应用没有获取到安全作用域的访问权限，也就是跳过了startAccessingSecurityScopedResource步骤。
3. 文档处于打开状态，包内文件被锁定，无法被移动。

建议你先打印出传入trashItem的URL的absoluteString，确认和实际iCloud容器内的路径完全一致，也可以检查文件属性来排查权限：

do {
    let attrs = try FileManager.default.attributesOfItem(atPath: docURL.path)
    print("文件属性: \(attrs)")
} catch {
    print("获取文件属性失败: \(error)")
}

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