Firestore数据获取异常：图片下载与视频流播放故障求助

一、getData 还是 Listener？ #

• 如果需要实时同步Firestore数据变化（比如新增/修改视频后自动更新列表），当前使用的addSnapshotListener（Listener）是正确选择，它会在数据变动时自动触发更新。
• 如果只需要一次性加载数据，不需要后续实时同步，改用db.collection("videos").getDocuments更合适，能减少不必要的监听开销。

二、图片加载问题修复 #

你的代码存在字段类型不匹配、未实际下载图片、语法错误三个核心问题，修正步骤如下：

1. 修正Video结构体字段类型 #

Firestore中存储的是图片URL字符串，而非二进制Data，所以结构体字段需调整：

import Foundation

struct Video {
    var name: String
    var imageURL: String // 存储图片URL字符串，替换原Data类型的imageName
    var lessonName: String
    var fileURL: String
}

2. 修正VideosViewModel数据映射 #

调整Firestore字段映射逻辑，确保类型匹配：

import Foundation
import FirebaseFirestore

class VideosViewModel: ObservableObject {
    @Published var videos = [Video]()
    private var db = Firestore.firestore()
    
    // 通用图片下载方法
    static func downloadImage(withURL urlString: String, completion: @escaping (UIImage?) -> Void) {
        guard let url = URL(string: urlString) else {
            completion(nil)
            return
        }
        let dataTask = URLSession.shared.dataTask(with: url) { data, _, error in
            guard let data = data, error == nil else {
                completion(nil)
                return
            }
            DispatchQueue.main.async {
                completion(UIImage(data: data))
            }
        }
        dataTask.resume()
    }
    
    func fetchData() {
        // 实时监听版本（保留原Listener逻辑，修正字段映射）
        db.collection("videos").addSnapshotListener { [weak self] querySnapshot, error in
            guard let self = self, let documents = querySnapshot?.documents else {
                print("获取文档失败: \(error?.localizedDescription ?? "未知错误")")
                return
            }
            
            self.videos = documents.compactMap { doc -> Video? in
                let data = doc.data()
                let name = data["name"] as? String ?? ""
                let imageURL = data["imageName"] as? String ?? "" // 对应Firestore中的imageName字段
                let lessonName = data["lessonName"] as? String ?? ""
                let fileURL = data["fileURL"] as? String ?? ""
                
                // 过滤无效数据
                guard !fileURL.isEmpty else {
                    print("跳过无效视频：缺少fileURL")
                    return nil
                }
                return Video(name: name, imageURL: imageURL, lessonName: lessonName, fileURL: fileURL)
            }
        }
        
        // 如果不需要实时更新，替换为一次性获取版本：
        /*
        db.collection("videos").getDocuments { [weak self] querySnapshot, error in
            guard let self = self, let documents = querySnapshot?.documents else {
                print("获取文档失败: \(error?.localizedDescription ?? "未知错误")")
                return
            }
            
            self.videos = documents.compactMap { doc -> Video? in
                let data = doc.data()
                let name = data["name"] as? String ?? ""
                let imageURL = data["imageName"] as? String ?? ""
                let lessonName = data["lessonName"] as? String ?? ""
                let fileURL = data["fileURL"] as? String ?? ""
                
                guard !fileURL.isEmpty else {
                    print("跳过无效视频：缺少fileURL")
                    return nil
                }
                return Video(name: name, imageURL: imageURL, lessonName: lessonName, fileURL: fileURL)
            }
        }
        */
    }
}

3. 修正TableViewCell图片加载逻辑 #

移除错误语法，实现异步下载+cell复用保护：

func tableView(_ tableView: UITableView, cellForRowAt indexPath: IndexPath) -> UITableViewCell {
    let cell = tableView.dequeueReusableCell(withIdentifier: "Cell", for: indexPath)
    let video = viewModel.videos[indexPath.row]
    tableView.tableFooterView = UIView()
    
    // 配置文本
    cell.textLabel?.text = video.name
    cell.detailTextLabel?.text = video.lessonName
    cell.accessoryType = .disclosureIndicator
    
    // 配置图片：设置占位图+异步下载
    cell.imageView?.image = UIImage(systemName: "photo") // 加载前的占位图
    VideosViewModel.downloadImage(withURL: video.imageURL) { image in
        DispatchQueue.main.async {
            // 确保cell仍对应当前indexPath，避免复用错误
            if let currentCell = tableView.cellForRow(at: indexPath) {
                currentCell.imageView?.image = image ?? UIImage(systemName: "photo")
                currentCell.imageView?.tintColor = .gray
            }
        }
    }
    
    // 配置选中样式
    let backgroundView = UIView()
    backgroundView.backgroundColor = UIColor(named: "VideoLessonsCellHighlighted")
    cell.selectedBackgroundView = backgroundView
    cell.textLabel?.font = UIFont(name: "Helvetica-Bold", size: 14)
    cell.detailTextLabel?.font = UIFont(name: "Helvetica", size: 12)
    
    return cell
}

三、视频播放问题修复 #

核心问题是强制解包URL导致崩溃，以及未处理无效URL的情况，修正如下：

func playVideo(at indexPath: IndexPath){
    let selectedVideo = viewModel.videos[indexPath.row]
    guard let videoURL = URL(string: selectedVideo.fileURL) else {
        print("无效的视频URL: \(selectedVideo.fileURL)")
        // 给用户显示错误提示
        let alert = UIAlertController(title: "播放失败", message: "视频URL无效", preferredStyle: .alert)
        alert.addAction(UIAlertAction(title: "确定", style: .default))
        present(alert, animated: true)
        return
    }
    
    player = AVPlayer(url: videoURL)
    playerViewController.player = player
    
    present(playerViewController, animated: true) {
        self.playerViewController.player?.play()
    }
}

关键注意事项 #

1. 确保Firestore中存储的fileURL是HTTPS协议的合法视频链接，且格式支持AVPlayer播放（如MP4、MOV等）。
2. 图片下载可添加缓存逻辑（如使用URLCache），避免重复下载消耗流量。
3. 所有异步操作需切换回主线程更新UI，避免界面卡顿或崩溃。

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