Firebase图片加载异常：原代码无法加载图片至UICollectionView求助

一周前还能正常从Firebase Database获取图片和视频，现在仅能获取文本数据，UICollectionView无法加载图片，程序无崩溃、无报错。

Podfile依赖 #

pod 'Firebase/Core'
pod 'Firebase/Analytics'
pod 'Firebase/Auth'
pod 'Firebase/Database'
pod 'Firebase/Crashlytics'

相关代码 #

UICollectionView Cell配置代码 #

func collectionView(_ collectionView: UICollectionView, cellForItemAt indexPath: IndexPath) -> UICollectionViewCell {
    let cell = collectionView.dequeueReusableCell(withReuseIdentifier: seasonCoverImage.identifier, for: indexPath) as! seasonCoverImage
    
    cell.backgroundColor = .white
    
    let im = seasons[indexPath.row]
    
    cell.ImageViewCover.contentMode = .scaleAspectFit
    cell.ImageViewCover.clipsToBounds = true
    
    cell.ImageViewCover.download(from: im.ImageUrl!)
    cell.TitleLbSeason.text = im.Season
    
    return cell
}

UIImageView下载扩展 #

import Foundation
import UIKit

extension UIImageView {
    func downloadnow(from url: URL, contentMode mode: ContentMode = .scaleAspectFit) {
        contentMode = mode
        URLSession.shared.dataTask(with: url) { data, response, error in
            guard
                let httpURLResponse = response as? HTTPURLResponse, httpURLResponse.statusCode == 200,
                let mimeType = response?.mimeType, mimeType.hasPrefix("image"),
                let data = data, error == nil,
                let image = UIImage(data: data)
                else { return }
            
            DispatchQueue.main.async() { [weak self] in
                self?.image = image
            }
        }.resume()
    }
    
    func download(from link: String, contentMode mode: ContentMode = .scaleAspectFill) {
        guard let url = URL(string: link) else { return }       
        downloadnow(from: url, contentMode: mode)
    }
}

补充说明 #

• 图片存储在Firebase Storage的文件夹中
• 图片的带访问令牌URL（如https://firebasestorage.googleapis.com/v0/b/xxxxx/o/xxxx%2image_1.jpg?alt=media&token=e62xxxx-xxxx-xxxx-xxxx-xxxxx）已存储在Firebase Database的如下节点：

  Seasons
    |
    |-FourSeasonsPhoto
       |
       |- ImgURL <-- 存储图片URL
       |- Desc
       |- 其他字段...
  

• 通过以下代码访问图片数据：

  let seasonsRef = Database.database().reference().child("Seasons")
  let seasonImgRef = seasonsRef.child("FourSeasonsPhoto")
  

排查方向 #

1. 访问令牌过期：Firebase Storage带token的下载URL默认有有效期（通常1小时），如果存储的是固定token的URL，过期后会返回403禁止访问。直接在浏览器打开存储的URL，验证是否能正常加载图片。解决方法：改用Firebase Storage SDK动态生成下载URL，或者设置更长的有效期。

2. 缺失错误日志：当前下载方法中guard分支直接return，没有输出任何错误信息。建议在else分支添加日志打印，定位具体失败原因：

   else {
       print("图片下载失败：\(error?.localizedDescription ?? "未知错误")，响应状态码：\(httpURLResponse?.statusCode ?? -1)，MIME类型：\(mimeType ?? "未知")")
       return
   }
   

3. Storage安全规则变更：检查Firebase Storage的安全规则，是否最近修改过权限（比如从公开访问改为需认证用户访问），而App当前的用户认证状态异常，导致无法访问图片。

4. URL格式错误：验证从Database获取的ImageUrl字符串是否正确，是否存在未转义的特殊字符（如空格），导致URL(string: link)初始化失败。可在download(from:)方法中打印link的值确认。

5. 本地缓存问题：清空App的本地缓存，或者卸载重装App，排除缓存导致的加载异常。

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