Swift开发iOS应用：Firebase数据不显示且启动白屏问题求助

核心问题分析 #

你的代码存在几个关键错误，导致无法正确从Firebase加载数据，最终CollectionView无内容显示白屏：

1. 数据解析逻辑错误：Firestore文档中的title和subtitle是字符串类型，你直接尝试转成Channel类型，转换必然失败，导致channel数组始终为空。
2. 数据模型缺失构造方法：Channel结构体没有提供从字典初始化的方式，无法直接从Firestore返回的document.data()创建实例。
3. 循环逻辑错误：每个Firestore文档应该对应一个Channel实例，但你现在把title和subtitle分别转成Channel并添加，逻辑完全错误。
4. 拼写错误：quarySnapshot应为querySnapshot，属于不良编码习惯，可能引发后续问题。
5. UI更新线程问题：Firestore回调在后台线程执行，虽然reloadData有时会隐式切换主线程，但明确指定主线程更安全。

分步修复代码 #

1. 修复Channel模型，添加字典初始化方法 #

修改Channel结构体，添加从Firestore字典初始化的构造器：

struct Channel {
    let title: String
    let subtitle: String
    
    // 从Firestore字典初始化的构造器
    init?(dict: [String: Any]) {
        guard let title = dict["title"] as? String,
              let subtitle = dict["subtitle"] as? String else {
            return nil
        }
        self.title = title
        self.subtitle = subtitle
    }
}

2. 修正ViewController中的Firestore数据获取逻辑 #

修复解析逻辑、拼写错误，并确保在主线程更新UI：

class ViewController: UIViewController {

    @IBOutlet weak var cv: UICollectionView!

    var channel = [Channel]()
    
    override func viewDidLoad() {
        super.viewDidLoad()
       
        cv.delegate = self
        cv.dataSource = self
        
        let db = Firestore.firestore()
        db.collection("content").getDocuments() { [weak self] (querySnapshot, err) in
            guard let self = self else { return }
            
            if let err = err {
                print("获取数据失败: \(err.localizedDescription)")
            } else {
                guard let docs = querySnapshot?.documents else {
                    print("没有找到任何文档")
                    return
                }
                
                for document in docs {
                    if let channelItem = Channel(dict: document.data()) {
                        self.channel.append(channelItem)
                    } else {
                        print("文档数据格式错误: \(document.data())")
                    }
                }
                
                DispatchQueue.main.async {
                    self.cv.reloadData()
                }
            }
        }
    }
}

extension ViewController: UICollectionViewDelegate, UICollectionViewDataSource {
    func collectionView(_ collectionView: UICollectionView, numberOfItemsInSection section: Int) -> Int {
        return channel.count
    }
    
    func collectionView(_ collectionView: UICollectionView, cellForItemAt indexPath: IndexPath) -> UICollectionViewCell {
        let cell = collectionView.dequeueReusableCell(withReuseIdentifier: "cell", for: indexPath) as! ContentCell
        let channelItem = channel[indexPath.row]
        cell.setup(channel: channelItem)
        return cell
    }
}

3. 额外检查项 #

• 确认Firestore控制台中content集合的文档确实包含title和subtitle字段，且字段名拼写与代码完全一致（区分大小写）。
• 确认App已正确配置Firebase，GoogleService-Info.plist文件已添加，且Firestore读取权限已开放（开发阶段可暂时设置为允许所有读取，上线后收紧）。
• 检查CollectionView的cell复用标识符是否与Storyboard/XIB中的标识符完全匹配。
• 确认CollectionView的约束已正确设置，避免因约束问题导致单元格无法显示。

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