Swift中QLPreviewController预览远程文件无法显示完整文件名如何解决

1. 自定义PreviewItem未实现previewItemTitle属性：QLPreviewItem协议包含可选的previewItemTitle字段，你当前的自定义实现仅提供了previewItemURL，系统会自动从本地临时文件路径提取标题，默认会隐藏已知格式的文件后缀，导致仅展示文件名主体。
2. 服务端响应的文件名可能缺失后缀：代码中使用的httpURLResponse.suggestedFilename取自响应头的Content-Disposition字段，若服务端未正确配置返回带后缀的文件名，本地存储的临时文件本身就不带后缀，QL预览时自然无法展示。
3. MIME类型判断逻辑存在局限性：当前代码仅允许PDF类型的文件走预览流程，你示例的.jpeg格式文件会直接被拦截跳出，无法完成后续预览逻辑。
4. 文件后缀隐藏属性未正确配置：代码中注释掉的previewURL.hasHiddenExtension = true若被启用，会强制系统隐藏文件后缀，即使文件名包含后缀也不会在预览标题中展示。

• 完善PreviewItem类实现，手动指定完整文件名
  首先给自定义PreviewItem补充previewItemTitle属性：

class PreviewItem: NSObject, QLPreviewItem {
    var previewItemURL: URL?
    var previewItemTitle: String? // 新增标题属性
}

修改quickLook方法，增加入参接收原始完整文件名，创建预览项时手动赋值标题：

// 方法新增fileName参数
func quickLook(url: URL, fileName: String) {
    // 原有下载、文件存储逻辑保持不变
    let previewItem = PreviewItem()
    previewItem.previewItemURL = previewURL
    previewItem.previewItemTitle = fileName // 直接赋值接口返回的完整带后缀文件名
    self.previewItems.append(previewItem)
}

调用方法时传入接口拿到的原始文件名：

quickLook(url: url!, fileName: img!)

• 调整MIME类型判断逻辑，兼容需要支持的文件格式
  按需扩展支持的MIME类型，避免非PDF文件被拦截：

guard
    let httpURLResponse = response as? HTTPURLResponse,
    let mimeType = httpURLResponse.mimeType,
    // 按需添加你需要支持的文件MIME类型
    ["application/pdf", "image/jpeg", "image/png", "image/gif"].contains(mimeType)
else {
    print("不支持的文件类型：\((response as? HTTPURLResponse)?.mimeType ?? "未知")")
    return
}

• 明确配置文件后缀不隐藏
  将注释的后缀配置行修改为关闭隐藏：

previewURL.hasHiddenExtension = false

• 兜底处理服务端文件名缺失后缀的问题
  如果服务端返回的suggestedFilename不带后缀，可以从原始文件名img中提取后缀补全，避免临时文件名缺失后缀。

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