iOS应用无法修改沙盒外文件：权限问题排查求助

1. 修正安全范围资源访问逻辑 #

从UIDocumentPickerViewController获取的URL本身是安全范围资源，直接对父目录调用startAccessingSecurityScopedResource()无效——安全范围权限仅授予用户明确选择的文件/目录，而非其父目录。正确流程：

• 直接使用选中的文件URL操作
• 在操作全程保持安全范围访问激活

修正DocumentPicker的Coordinator代码：

func documentPicker(_ controller: UIDocumentPickerViewController, didPickDocumentsAt urls: [URL]) {
    guard let fileURL = urls.first else { return }
    
    // 激活安全范围访问
    guard fileURL.startAccessingSecurityScopedResource() else {
        print("无法获取安全范围资源访问权限")
        return
    }
    defer { fileURL.stopAccessingSecurityScopedResource() }
    
    // 保存文件书签（而非父目录）
    parent.bookmarkController.addBookmark(for: fileURL)
    
    // 重命名属于写入操作，需用coordinate(writingItemAt:)
    let coordinator = NSFileCoordinator()
    var error: NSError?
    coordinator.coordinate(writingItemAt: fileURL, options: .forReplacing, error: &error) { coordinatedURL in
        do {
            try renameFile(at: coordinatedURL, to: parent.newName)
            print("文件重命名成功")
        } catch {
            print("重命名失败：\(error.localizedDescription)")
        }
    }
    if let error = error {
        print("文件协调错误：\(error.localizedDescription)")
    }
}

2. 修复书签管理逻辑 #

当前书签保存父目录且未启用安全范围选项，导致后续无法恢复权限。修正BookmarkController的addBookmark方法：

func addBookmark(for url: URL) {
    do {
        // 创建带安全范围的书签
        let bookmarkData = try url.bookmarkData(
            options: .withSecurityScope,
            includingResourceValuesForKeys: nil,
            relativeTo: nil
        )
        
        let uuid = UUID().uuidString
        try bookmarkData.write(to: getAppSandboxDir().appendingPathComponent(uuid))
        
        urls.append(url)
    } catch {
        print("添加书签失败：\(error.localizedDescription)")
    }
}

加载书签时需重新激活安全范围：

func loadAllBookmarks() {
    guard let files = try? FileManager.default.contentsOfDirectory(at: getAppSandboxDir(), includingPropertiesForKeys: nil) else {
        urls = []
        return
    }
    
    self.urls = files.compactMap { file in
        do {
            let bookmarkData = try Data(contentsOf: file)
            var isStale = false
            let url = try URL(
                resolvingBookmarkData: bookmarkData,
                options: .withSecurityScope,
                relativeTo: nil,
                bookmarkDataIsStale: &isStale
            )
            
            if isStale {
                // 处理过期书签
                try FileManager.default.removeItem(at: file)
                return nil
            }
            
            // 验证书签可用性
            guard url.startAccessingSecurityScopedResource() else {
                print("无法激活书签资源")
                return nil
            }
            defer { url.stopAccessingSecurityScopedResource() }
            
            return url
        } catch {
            print("加载书签失败：\(error.localizedDescription)")
            return nil
        }
    }
}

3. 配置Info.plist必要权限 #

应用未出现在"文件与文件夹"权限列表，是因为缺少权限描述和配置。在Info.plist中添加以下键值对：

• UIFileSharingEnabled：设置为YES（允许与系统文件应用交互）
• LSSupportsOpeningDocumentsInPlace：设置为YES（允许原地修改文档）
• NSFileProviderDomainUsageDescription：添加权限申请描述（例如"需要访问音频文件以完成重命名操作"）

4. 开发者账号的影响 #

未加入开发者计划的免费账号，真机测试沙箱限制更严格，但不会直接导致安全范围资源访问失败——核心问题还是代码逻辑和配置错误。若修正后仍有问题：

• 尝试使用付费开发者账号重新签名
• 检查设备是否信任该开发者证书（设置→通用→VPN与设备管理）

5. 额外注意事项 #

• 重命名操作必须在startAccessingSecurityScopedResource()激活周期内完成
• 确保newName不为空，且目标文件名未与目录内现有文件冲突

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