iOS使用QuickLook(QLPreviewController)无法预览文件问题求助

云上老周

2026-10-7

问题原因

你遇到的预览失败问题，核心原因是URL初始化方法使用错误：
你存储在filesList[index].filePath中的值本身已经是带file://协议前缀的URL字符串，而NSURL(fileURLWithPath:)方法仅适用于处理不带协议前缀的纯本地路径字符串。用该方法处理带file://的字符串时，会将完整的file://xxx内容识别为路径的一部分，最终生成无效的文件URL，你打印输出中多余的 -- file:///后缀就是URL异常的直接表现。无效URL导致QuickLook无法识别到正确的文件路径与格式，进而触发不支持格式报错、仅显示文件名与data字样的异常。

解决方案

将previewItemAt方法中的URL初始化逻辑修正为以下任意一种即可：

方案1：根据路径格式自动选择初始化方式（推荐）

func previewController(_ controller: QLPreviewController, previewItemAt index: Int) -> QLPreviewItem {
    let pathStr = filesList[index].filePath ?? ""
    let url: URL
    if pathStr.hasPrefix("file://") {
        url = URL(string: pathStr)!
    } else {
        url = URL(fileURLWithPath: pathStr)
    }
    // 可添加文件存在性校验，排查文件是否真的存储在对应路径
    print("文件是否存在: \(FileManager.default.fileExists(atPath: url.path))")
    return url as QLPreviewItem
}

方案2：先移除`file://`前缀再用原方法初始化

func previewController(_ controller: QLPreviewController, previewItemAt index: Int) -> QLPreviewItem {
    var pathStr = filesList[index].filePath ?? ""
    if pathStr.hasPrefix("file://") {
        pathStr = String(pathStr.dropFirst(7))
    }
    let url = URL(fileURLWithPath: pathStr)
    return url as QLPreviewItem
}