SwiftUI使用fileImporter导入音频文件至Documents目录遇权限问题求助

你遇到的核心问题其实是安全范围URL的访问权限限制——通过fileImporter获取的系统Files应用内的文件URL是受沙箱保护的，直接读取或复制会因为权限不足失败。下面一步步帮你修复这个问题：

问题根源 #

当你通过fileImporter选中文件时，得到的URL带有安全范围标记，必须先调用startAccessingSecurityScopedResource()获取临时访问权限，操作完成后还要调用stopAccessingSecurityScopedResource()释放权限，否则就会出现你看到的"没有权限查看文件"的错误。

另外你原来的saveFile函数用try? Data.init(contentsOf: url)会吞掉错误，不利于排查问题，也建议改成显式的错误捕获逻辑。

修改后的完整代码 #

import SwiftUI

struct ContentView: View {
    @State var importFiles = false
    @State var files = [URL]()
    
    var body: some View {
        VStack{
            Spacer()
            Button(action: { importFiles = true }, label: {Text("Import files")})
                .padding()
            Button(action: { 
                files = listAllFiles()
            }, label: {Text("List files")})
                .padding()
            Spacer()
            ForEach(files, id: \.self){ file in
                Text(file.lastPathComponent)
                    .padding()
            }
        }
        .fileImporter(
            isPresented: $importFiles,
            allowedContentTypes: [.audio],
            allowsMultipleSelection: false
        ) { result in
            do {
                let selectedFiles = try result.get()
                guard let selectedFile = selectedFiles.first else {
                    print("No file selected")
                    return
                }
                
                // 关键：获取安全范围URL的访问权限
                guard selectedFile.startAccessingSecurityScopedResource() else {
                    print("Failed to access the selected file")
                    return
                }
                // 操作完成后必须释放权限，用defer确保无论成功失败都会执行
                defer {
                    selectedFile.stopAccessingSecurityScopedResource()
                }
                
                if let savedUrl = saveFile(url: selectedFile) {
                    files.append(savedUrl)
                }
            } catch {
                print("File selection failed: \(error.localizedDescription)")
            }
        }
    }
}

func getDocumentsDirectory() -> URL {
    return FileManager.default.urls(for: .documentDirectory, in: .userDomainMask)[0]
}

func listAllFiles() -> [URL] {
    let documentsUrl = getDocumentsDirectory()
    do {
        let directoryContents = try FileManager.default.contentsOfDirectory(at: documentsUrl, includingPropertiesForKeys: nil)
        print("Documents directory contents: \(directoryContents)")
        return directoryContents
    } catch {
        print("Failed to list files: \(error.localizedDescription)")
        return []
    }
}

func saveFile(url: URL) -> URL? {
    let fileName = url.lastPathComponent
    let actualPath = getDocumentsDirectory().appendingPathComponent(fileName)
    
    do {
        // 用copyItem比Data写入更高效，尤其适合音频这类大文件
        try FileManager.default.copyItem(at: url, to: actualPath)
        print("File saved successfully. Origin: \(url) Target: \(actualPath)")
        return actualPath
    } catch {
        print("Failed to save file: \(error.localizedDescription)")
        return nil
    }
}

关键修改点 #

1. 安全权限处理：在fileImporter的结果回调里，添加了startAccessingSecurityScopedResource()获取权限，并用defer块确保操作完成后释放权限，这是解决权限错误的核心。
2. 文件保存优化：把原来的Data写入改成FileManager.default.copyItem(at:to:)，更高效且能保留文件元数据，同时去掉了吞错误的try?，改为显式捕获错误方便排查。
3. UI同步修复：修改了listAllFiles函数，让它返回文件列表并直接更新UI的files数组，点击"List files"按钮后能实时显示Documents目录里的文件。
4. 增强错误日志：增加了更详细的错误描述，方便你快速定位问题。

额外注意事项 #

• 不需要在Info.plist里额外添加权限配置，fileImporter已经帮你处理了用户授权流程。
• 如果要支持多选文件，记得循环处理每个选中的URL，每个都要单独调用权限获取和释放的方法。

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