注册时头像无法上传至Firebase Storage 代码编译无报错

代码可编译不代表逻辑、配置无问题，按出现概率从高到低逐一排查：

• 先排查静默返回问题：你当前写的两个前置guard判断没有任何日志输出，很可能代码执行到guard就直接退出了，根本没走到上传逻辑，这是最容易被忽略的点：
  1. 获取uid的guard逻辑：注册流程刚完成的瞬间，Auth.auth().currentUser存在短暂空值窗口期，如果注册成功后立刻同步调用上传方法，大概率拿不到uid直接return。在guard的else块加打印确认：

     guard let uid = Auth.auth().currentUser?.uid else {
         print("DEBUG: 未获取到已认证用户uid，上传终止")
         return
     }
     

  2. 图片转Data的guard逻辑：如果头像选择器的回调没有切到主线程给self.image赋值，或者选中的图片是HEIC等特殊格式、转JPEG失败，也会直接静默退出。同样加打印定位：

     guard let imageData = self.image?.jpegData(compressionQuality: 0.5) else {
         print("DEBUG: 图片转JPEG失败，当前self.image是否为空：\(self.image == nil)")
         return
     }
     

• 排查Storage安全规则配置：这是上传失败最高发的服务端原因。Firebase Storage默认规则只允许测试期30天内无权限访问，到期后会自动拦截所有未带有效认证令牌的请求；如果你写的规则路径匹配和实际上传路径不对应，也会被拒绝。先把上传、下载URL回调里的错误完整打印出来，如果报权限拒绝类错误，直接去Firebase控制台调整Storage规则，测试阶段可以先用以下规则验证逻辑（正式上线前必须按最小权限原则收紧）：

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

• 修正存储路径和元配置：你当前直接用uid作为根目录下的文件名，没有文件后缀，也没有指定文件content-type，部分SDK版本下服务端会因无法识别文件类型拒绝上传。建议调整为明确的层级路径，上传时带上文件元数据，同时回调里用弱引用避免循环引用：

  // 调整存储路径：统一放到头像目录下，文件名带.jpg后缀
  let ref = Storage.storage().reference(withPath: "profile_avatars/\(uid).jpg")
  guard let imageData = self.image?.jpegData(compressionQuality: 0.5) else {
      // 加上述的日志逻辑
      return
  }
  // 指定文件元数据，明确类型为JPEG图片
  let metadata = StorageMetadata()
  metadata.contentType = "image/jpeg"
  ref.putData(imageData, metadata: metadata) { [weak self] metadata, err in
      guard let self = self else { return }
      if let err = err {
          print("DEBUG: 上传失败完整信息：\(err.localizedDescription)，错误码：\(err._code)")
          self.loginStatusMessage = "Couldn't upload your photo \(err)"
          return
      }
      
      ref.downloadURL { url, err in
          if let err = err {
              self.loginStatusMessage = "Error uploading your photo \(err)"
              return
          }
          
          self.loginStatusMessage = "Photo successfully uploaded!"
          print(url?.absoluteString)
          // 拿到url后需要将地址存入Firestore/Realtime Database对应用户节点，否则后续无法读取头像地址
      }
  }
  

• 排查存储桶匹配问题：如果你在Firebase控制台创建了非默认的存储桶专门存静态资源，直接调用Storage.storage()拿到的是默认存储桶实例，需要传入自定义存储桶地址初始化Storage实例，否则会向不存在的桶上传数据导致失败。

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