无法将图片上传至Firebase Storage，求排查问题原因

我通过Image Picker让用户从相册选图上传到帖子，想把图片存到Firebase Storage，已创建event_images文件夹，但调用上传代码时出现“failed to upload event image to firebase”错误，相关代码如下：

上传函数实现 #

public typealias UploadPictureCompletion = (Result<String, Error>) -> Void
public func uploadEventHeaderImage(with data: Data, fileName: String, completion: @escaping UploadPictureCompletion){
        bucket.child("event_images/\(fileName)").putData(data, metadata: nil, completion: {metadata, error in
            
            guard error == nil else{
                //failed
                print("failed to upload event image to firebase")
                completion(.failure(StorageErrors.failedToUpload))
                return
            }
            
            self.bucket.child("event_images/\(fileName)").downloadURL(completion: {url, error in
                guard let url = url else{
                    print("failed to get download url from firebase")
                    completion(.failure(StorageErrors.failedToGetDownloadURL))
                    return
                }
                let urlString = url.absoluteString
                print("download ur returned: \(urlString)")
                completion(.success(urlString))
            })
        })
        
    }

调用代码 #

let filename = "\(eventId).png"
guard let data = headerImage.pngData() else {
    return
}

StorageManager.shared.uploadEventHeaderImage(with: data,
                                           fileName: filename,
                                           completion: {result in
    switch result {
        
    case .success(let downloadUrl):
        UserDefaults.standard.set(downloadUrl, forKey: "event_image_url")
        print(downloadUrl)
    case .failure(let error):
        print("Storage manager error: \(error)")
    }
})

以下是可能的问题及解决办法：

• Storage权限配置错误
  默认的Firebase Storage安全规则限制未认证用户读写，若未做用户认证或规则过严会导致上传失败。可先临时设置测试规则（上线前务必修改）：

  rules_version = '2';
  service firebase.storage {
    match /b/{bucket}/o {
      match /{allPaths=**} {
        allow read, write: if true;
      }
    }
  }
  

  测试通过后，再调整为符合业务的规则，比如仅允许认证用户访问event_images：

  rules_version = '2';
  service firebase.storage {
    match /b/{bucket}/o {
      match /event_images/{fileName} {
        allow read, write: if request.auth != null;
      }
    }
  }
  

• Storage实例初始化异常
  检查StorageManager中的bucket是否正确初始化。确保App启动时执行了FirebaseApp.configure()，且bucket实例创建正确：

  let bucket = Storage.storage().reference()
  

  若使用自定义存储桶，需传入对应URL或名称。

• 图片数据无效
  虽然代码中做了pngData()的判空，但可新增日志确认数据有效性：

  guard let data = headerImage.pngData() else {
      print("图片转PNG数据失败")
      return
  }
  print("图片数据大小：\(data.count) bytes")
  

  若数据大小为0，说明Image Picker获取的图片对象无效或格式不支持。

• 文件名包含非法字符
  Firebase Storage文件名不能包含\、/、#、[、]、*等特殊字符。可对eventId做转义处理：

  let safeFilename = eventId.replacingOccurrences(of: #"[\\/#\[\]\*]"#, with: "", options: .regularExpression) + ".png"
  

• 网络连接问题
  测试设备是否能正常访问Firebase服务，可切换网络环境（比如从WiFi切到手机流量）排查。

• 未打印具体错误信息
  修改上传函数的错误处理逻辑，打印Firebase返回的具体错误，便于精准排查：

  guard error == nil else{
      print("上传失败具体错误：\(error!)")
      completion(.failure(StorageErrors.failedToUpload))
      return
  }
  

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