iOS14+ SwiftUI中UIDocumentPicker内容变灰无法选择问题求助

问题现象 #

• 视频、音频、PDF等文件在UIDocumentPicker中呈灰色不可选状态
• 模拟器中仅能通过长按释放的方式选择文件，真机上完全无法操作，仅文件结构可见，所有文档均灰显

原代码 #

struct DocumentPicker: UIViewControllerRepresentable {
    @ObservedObject var chatViewModel: RedesignChatViewModel
    func makeUIViewController(context: UIViewControllerRepresentableContext<DocumentPicker>) -> UIDocumentPickerViewController {
        let viewController = UIDocumentPickerViewController(forOpeningContentTypes: [.pdf, .mp3, .audio, .video, .movie, .item])
        viewController.shouldShowFileExtensions = true
        viewController.allowsMultipleSelection = false
        viewController.delegate = context.coordinator
        return viewController
    }
    func updateUIViewController(_ uiViewController: UIDocumentPickerViewController, context: Context) {
    }
}

extension DocumentPicker {
    func makeCoordinator() -> Coordinator {
        Coordinator(self)
    }
    class Coordinator: NSObject, UIDocumentPickerDelegate {
        var parent: DocumentPicker
        var path: String?
        init(_ documentPicker: DocumentPicker) {
            self.parent = documentPicker
        }
        func documentPicker(_ controller: UIDocumentPickerViewController, didPickDocumentsAt urls: [URL]) {
            guard let url = urls.first else { return }
        func documentPickerWasCancelled(_ controller: UIDocumentPickerViewController) {
            controller.dismiss(animated: true)
        }
}

问题根源 #

1. UTI类型冲突：同时使用.audio、.video这类通用UTI和.mp3、.movie这类具体UTI，导致系统无法正确识别可选择的文件类型
2. 权限配置缺失：iOS14及以上版本需要明确声明文件访问相关权限，否则会限制文件选择
3. Coordinator代码语法错误：documentPicker(_:didPickDocumentsAt:)方法未闭合，导致代理逻辑失效，无法处理文件选择事件

修复方案 #

1. 清理UTI类型，避免冲突

移除重复的UTI类型，选择通用类型或具体类型的合理组合，示例：

// 使用通用类型，覆盖所有音频、视频、PDF文件
let viewController = UIDocumentPickerViewController(forOpeningContentTypes: [.pdf, .audio, .video])
// 或者使用具体类型，精准控制可选择文件
let viewController = UIDocumentPickerViewController(forOpeningContentTypes: [.pdf, .mp3, .mpeg4Audio, .quickTimeMovie])

2. 添加Info.plist权限配置

在项目的Info.plist中添加以下配置，声明文件访问权限：

<key>NSAppleMusicUsageDescription</key>
<string>需要访问音频文件用于聊天发送</string>
<key>NSPhotoLibraryUsageDescription</key>
<string>需要访问视频及文档文件用于聊天发送</string>
<key>UIFileSharingEnabled</key>
<true/>
<key>LSSupportsOpeningDocumentsInPlace</key>
<true/>

3. 修复Coordinator代码错误并处理安全访问权限

修正语法错误，同时在iOS14+中必须处理安全范围资源的访问：

extension DocumentPicker {
    func makeCoordinator() -> Coordinator {
        Coordinator(self)
    }
    class Coordinator: NSObject, UIDocumentPickerDelegate {
        var parent: DocumentPicker
        var path: String?
        
        init(_ documentPicker: DocumentPicker) {
            self.parent = documentPicker
        }
        
        func documentPicker(_ controller: UIDocumentPickerViewController, didPickDocumentsAt urls: [URL]) {
            guard let url = urls.first else { return }
            
            // iOS14+必须申请安全访问权限
            guard url.startAccessingSecurityScopedResource() else {
                // 权限获取失败时的处理逻辑
                return
            }
            defer {
                // 用完必须停止访问，释放资源
                url.stopAccessingSecurityScopedResource()
            }
            
            // 将选中的文件URL传递给ViewModel处理
            parent.chatViewModel.handleSelectedDocument(url: url)
            controller.dismiss(animated: true)
        }
        
        func documentPickerWasCancelled(_ controller: UIDocumentPickerViewController) {
            controller.dismiss(animated: true)
        }
    }
}

4. 优化UIDocumentPicker初始化参数（iOS14+推荐）

使用forOpeningContentTypes:asCopy:参数明确是否复制文件，避免权限问题：

let viewController = UIDocumentPickerViewController(forOpeningContentTypes: [.pdf, .audio, .video], asCopy: true)

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