iOS（Swift）Firebase Storage上传图片报错：对象不存在

你已经排除了用户认证的问题，那咱们从几个常见的核心排查方向入手：

1. 先确认本地待上传的文件/数据是否有效 #

这是最容易被忽略的关键点——如果你的上传代码基于本地文件URL（比如用putFile(from:)方法），先检查这个URL对应的文件真的存在：

guard FileManager.default.fileExists(atPath: yourLocalFileURL.path) else {
    print("本地文件不存在！")
    return
}

如果是把UIImage转成Data上传（用putData(_:)），要确认转Data的过程没失败：

guard let imageData = yourUIImage.jpegData(compressionQuality: 0.8) else {
    print("图片转Data失败，请检查图片是否有效")
    return
}

如果本地数据本身就不存在，Firebase会返回“对象不存在”的错误，这其实是在提示上传的源数据有问题。

2. 检查Firebase Storage的安全规则 #

有时候权限问题会被错误提示为“对象不存在”，一定要确保你的Storage规则允许当前认证用户写入目标路径。针对你的images/{userId}/{fileName}结构，规则应该类似这样：

rules_version = '2';
service firebase.storage {
  match /b/{bucket}/o {
    match /images/{userId}/{fileName} {
      // 只允许对应UID的用户写入
      allow write: if request.auth != null && request.auth.uid == userId;
      // 允许所有认证用户读取
      allow read: if request.auth != null;
    }
  }
}

如果规则里的路径匹配有误，或者写入条件不满足（比如变量名拼写错误），也会导致上传失败并返回误导性错误。

3. 核对上传代码的逻辑细节 #

给你一个经过验证的上传示例，你可以对比自己的代码找差异：

示例1：UIImage转Data上传 #

import FirebaseStorage

func uploadSelectedImage(_ image: UIImage, forUserId userId: String) {
    // 1. 把图片转成JPG Data
    guard let imageData = image.jpegData(compressionQuality: 0.8) else {
        print("图片转Data失败，请检查图片是否有效")
        return
    }
    
    // 2. 创建Storage引用
    let storageRef = Storage.storage().reference()
    let uniqueImageName = UUID().uuidString // 用UUID避免文件名冲突
    let targetRef = storageRef.child("images/\(userId)/\(uniqueImageName)")
    
    // 3. 执行上传
    let uploadTask = targetRef.putData(imageData, metadata: nil) { metadata, error in
        guard let _ = metadata else {
            print("上传失败：\(error?.localizedDescription ?? "未知错误")")
            return
        }
        // 上传成功后获取下载URL
        targetRef.downloadURL { url, error in
            guard let downloadURL = url else {
                print("获取下载URL失败：\(error?.localizedDescription ?? "未知错误")")
                return
            }
            print("上传成功！下载地址：\(downloadURL)")
        }
    }
}

示例2：本地文件URL上传 #

func uploadImageFromLocalURL(_ fileURL: URL, forUserId userId: String) {
    // 先验证文件存在
    guard FileManager.default.fileExists(atPath: fileURL.path) else {
        print("本地文件不存在：\(fileURL.path)")
        return
    }
    
    let storageRef = Storage.storage().reference()
    let fileName = fileURL.lastPathComponent
    let targetRef = storageRef.child("images/\(userId)/\(fileName)")
    
    let uploadTask = targetRef.putFile(from: fileURL, metadata: nil) { metadata, error in
        guard let _ = metadata else {
            print("上传失败：\(error?.localizedDescription ?? "未知错误")")
            return
        }
        targetRef.downloadURL { url, error in
            guard let downloadURL = url else {
                print("获取下载URL失败：\(error?.localizedDescription ?? "未知错误")")
                return
            }
            print("上传成功！下载地址：\(downloadURL)")
        }
    }
}

4. 额外排查点 #

• 如果你是通过相册/相机获取的图片URL，确认这个URL不是临时过期的（比如PHAsset的临时URL可能会失效，建议转成Data再上传更可靠）；
• 检查是否在上传前不小心删除了本地文件，或者文件路径被修改；
• 可以在Firebase控制台的Storage界面手动创建一个相同路径的文件，看看是否能正常读写，验证路径和权限是否没问题。

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