Firebase邮箱认证用户头像设置及数据库设计咨询（Swift3/iOS10）

我来帮你梳理下在Firebase里实现员工头像关联存储，以及给邮箱认证用户设置头像的具体步骤和Swift 3代码，刚好适配你的Xcode 8.3.2和iOS 10环境：

一、核心思路：头像存Storage，关联信息存数据库 #

首先得明确：Firebase数据库（不管是Firestore还是Realtime Database）不适合直接存图片文件，所以我们的方案是：

• 头像文件存在Firebase Storage（专门存大文件的服务）
• 数据库里存员工的唯一标识（ID/邮箱）+ 头像的Storage下载URL，通过员工ID把两者关联起来

推荐的数据库结构（Firestore版，更灵活） #

创建一个employees集合，每个文档用员工的唯一ID（可以是你们内部的员工ID，或者Firebase Auth的uid）作为文档ID，文档里包含这些字段：

• employeeId: String（内部员工编号，可选，如果你用Auth uid当文档ID的话可以省略）
• email: String（员工邮箱，用于关联）
• avatarUrl: String（头像在Storage的下载链接）
• 其他你需要的员工信息（比如姓名、部门、职位等）

如果用Realtime Database，结构大概是这样的：

{
  "employees": {
    "EMP001": {
      "email": "zhangsan@company.com",
      "avatarUrl": "gs://your-project-bucket/avatars/EMP001.jpg",
      "name": "张三"
    },
    "EMP002": { ... }
  }
}

二、Swift 3 代码实现（适配你的开发环境） #

首先确保你已经通过CocoaPods集成了必要的Firebase组件，Podfile里的依赖应该包含这些：

pod 'Firebase/Core'
pod 'Firebase/Firestore'
pod 'Firebase/Storage'
pod 'Firebase/Auth'

1. 上传头像到Storage并关联到数据库 #

假设你已经获取到了员工ID和要上传的头像图片（比如用户从相册选择的），代码如下：

import Firebase
import UIKit

// 替换成实际的员工ID和头像图片
let targetEmployeeId = "EMP001"
let selectedAvatarImage = UIImage(named: "user-avatar")!
// 把图片转成JPEG数据（压缩质量0.8，平衡清晰度和大小）
guard let imageData = UIImageJPEGRepresentation(selectedAvatarImage, 0.8) else {
    print("图片转数据失败")
    return
}

// 1. 配置Storage的存储路径（用员工ID命名，避免冲突）
let storageRef = Storage.storage().reference().child("avatars/\(targetEmployeeId).jpg")

// 2. 开始上传图片
let uploadTask = storageRef.putData(imageData, metadata: nil) { metadata, error in
    guard let metadata = metadata else {
        print("头像上传失败：\(error?.localizedDescription ?? "未知错误")")
        return
    }
    // 3. 获取上传后的下载URL
    storageRef.downloadURL { url, error in
        guard let avatarDownloadUrl = url else {
            print("获取头像链接失败：\(error?.localizedDescription ?? "未知错误")")
            return
        }
        // 4. 把URL存到Firestore的员工文档里
        let db = Firestore.firestore()
        db.collection("employees").document(targetEmployeeId).setData([
            "employeeId": targetEmployeeId,
            "email": "zhangsan@company.com", // 替换成实际邮箱
            "avatarUrl": avatarDownloadUrl.absoluteString
        ], merge: true) { error in
            if let error = error {
                print("更新数据库失败：\(error.localizedDescription)")
            } else {
                print("头像关联存储成功！")
            }
        }
    }
}

// 可选：监听上传进度，显示给用户
uploadTask.observe(.progress) { snapshot in
    let progressPercent = 100.0 * Double(snapshot.progress!.completedUnitCount) / Double(snapshot.progress!.totalUnitCount)
    print("上传进度：\(String(format: "%.1f", progressPercent))%")
}

2. 从数据库读取并加载头像 #

要显示员工头像时，从数据库拿到URL再加载图片：

// 传入员工ID和要显示的UIImageView，自动加载头像
func loadEmployeeAvatar(for employeeId: String, into imageView: UIImageView) {
    let db = Firestore.firestore()
    db.collection("employees").document(employeeId).getDocument { document, error in
        if let document = document, document.exists {
            guard let avatarUrlString = document.data()?["avatarUrl"] as? String,
                  let avatarUrl = URL(string: avatarUrlString) else {
                print("头像链接无效")
                imageView.image = UIImage(named: "default-avatar") // 设置默认头像
                return
            }
            // 用URLSession加载图片（也可以用SDWebImage等第三方库简化缓存逻辑）
            URLSession.shared.dataTask(with: avatarUrl) { data, _, error in
                if let data = data, let avatarImage = UIImage(data: data) {
                    DispatchQueue.main.async {
                        imageView.image = avatarImage
                    }
                } else {
                    DispatchQueue.main.async {
                        imageView.image = UIImage(named: "default-avatar")
                    }
                }
            }.resume()
        } else {
            print("找不到该员工的信息")
            imageView.image = UIImage(named: "default-avatar")
        }
    }
}

三、给Firebase邮箱认证用户设置头像 #

邮箱认证的用户默认只有邮箱和uid，要给他们设置头像，步骤和上面类似，只是用用户的uid作为关联标识，同时可以把头像URL同步到Firebase Auth的用户资料里：

Swift 3 代码示例 #

// 上传头像后更新Auth用户资料和数据库
func updateAuthenticatedUserAvatar(with avatarImage: UIImage) {
    guard let currentUser = Auth.auth().currentUser else {
        print("当前没有登录用户")
        return
    }
    guard let imageData = UIImageJPEGRepresentation(avatarImage, 0.8) else {
        print("图片转数据失败")
        return
    }
    
    // 1. 上传头像到Storage（用用户uid命名）
    let storageRef = Storage.storage().reference().child("avatars/\(currentUser.uid).jpg")
    storageRef.putData(imageData, metadata: nil) { metadata, error in
        guard let metadata = metadata else {
            print("头像上传失败：\(error?.localizedDescription ?? "未知错误")")
            return
        }
        // 2. 获取下载URL
        storageRef.downloadURL { url, error in
            guard let avatarUrl = url else {
                print("获取头像链接失败：\(error?.localizedDescription ?? "未知错误")")
                return
            }
            // 3. 更新Firebase Auth的用户资料
            let profileChangeRequest = currentUser.createProfileChangeRequest()
            profileChangeRequest.photoURL = avatarUrl
            profileChangeRequest.commitChanges { error in
                if let error = error {
                    print("更新用户头像失败：\(error.localizedDescription)")
                } else {
                    print("Auth用户头像更新成功")
                    // 4. 同步更新到员工数据库（可选，如果你需要在数据库里也存一份）
                    let db = Firestore.firestore()
                    db.collection("employees").document(currentUser.uid).updateData([
                        "avatarUrl": avatarUrl.absoluteString
                    ]) { error in
                        if let error = error {
                            print("同步数据库失败：\(error.localizedDescription)")
                        }
                    }
                }
            }
        }
    }
}

重要的安全规则配置 #

别忘给Storage和数据库设置安全规则，防止非法访问：

• Storage规则（只允许认证用户上传自己的头像）：

  rules_version = '2';
  service firebase.storage {
    match /b/{bucket}/o {
      match /avatars/{userId}.jpg {
        allow read: if request.auth != null;
        allow write: if request.auth != null && request.auth.uid == userId;
      }
    }
  }
  

• Firestore规则（只允许员工自己修改自己的信息，认证用户可读取）：

  rules_version = '2';
  service cloud.firestore {
    match /databases/{database}/documents {
      match /employees/{userId} {
        allow read: if request.auth != null;
        allow write: if request.auth != null && request.auth.uid == userId;
      }
    }
  }
  

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