Swift开发：Firebase Storage上传头像无法覆盖旧图的问题求助

你遇到的Firebase Storage头像上传后App仍显示旧图的问题，核心原因是缓存机制干扰：SDWebImage会缓存旧的头像资源，Firebase Storage的下载URL也可能因为缓存未及时更新，导致App加载的还是旧数据。

1. 上传后主动获取最新下载URL并刷新界面 #

你的上传代码仅完成了文件上传，未同步更新本地头像引用。修改上传逻辑，在上传完成后获取最新的下载URL并直接刷新头像：

let storage = Storage.storage()
let storageRef = storage.reference()
let photoRef = storageRef.child("\(UserModel.docId)-ProfilePicture")

let uploadTask = photoRef.putFile(from: fileURL, metadata: nil) { [weak self] metadata, err in
    guard let metadata = metadata else {
        print("error uploading to database")
        return
    }
    // 上传完成后立即获取最新下载URL
    photoRef.downloadURL { newUrl, error in
        guard let newUrl = newUrl else {
            print("Failed to get new download URL")
            return
        }
        print("Photo uploaded, new URL: \(newUrl)")
        // 直接刷新头像，确保加载最新资源
        self?.profileImage.sd_setImage(with: newUrl, placeholderImage: UIImage(systemName: "person.circle.fill"))
    }
}

2. 加载图片时强制跳过缓存或刷新缓存 #

使用SDWebImage时，通过设置缓存策略，强制App获取最新资源：

let storage = Storage.storage()
let storageRef = storage.reference()
let ref = storageRef.child("\(UserModel.docId)-ProfilePicture")

ref.downloadURL { [weak self] newUrl, error in
    if let error = error {
        print("Image does not exist")
        self?.profileImage.image = UIImage(systemName: "person.circle.fill")
    } else {
        guard let newUrl = newUrl else { return }
        print("loaded database image")
        // 设置缓存策略：优先刷新缓存，失败重试
        self?.profileImage.sd_setImage(
            with: newUrl,
            placeholderImage: UIImage(systemName: "person.circle.fill"),
            options: [.refreshCached, .retryFailed]
        )
    }
}

如果完全不需要缓存，可直接禁用：

self?.profileImage.sd_setImage(
    with: newUrl,
    placeholderImage: UIImage(systemName: "person.circle.fill"),
    options: [.ignoreCache]
)

3. 手动清除指定缓存（可选） #

如果旧缓存已经存在，可手动清除对应URL的SDWebImage缓存后再加载：

if let url = newUrl {
    SDImageCache.shared.removeImage(forKey: url.absoluteString)
    self?.profileImage.sd_setImage(with: url)
}

4. 调整Firebase Storage缓存规则（可选） #

在Firebase控制台找到对应头像文件，修改其缓存控制头，设置较短的缓存有效期（比如1分钟），让客户端更快获取最新资源。

• 避免直接用StorageReference给SDWebImage加载，优先获取downloadURL后再加载，便于精准控制缓存。
• 上传完成后必须同步更新本地的头像资源引用，不能依赖旧的缓存URL。

内容的提问来源于stack exchange，提问作者Marco.py