Swift集成Firebase开发时无法获取展示用户名，应如何排查解决？

可能的故障原因 #

• 未在项目启动时初始化Firebase：缺少FirebaseApp.configure()调用，所有Firebase接口不会响应
• Realtime Database安全规则限制：默认规则禁止未授权读写，你需要配置规则允许登录用户读取自己的用户数据，测试阶段可以临时开全读写规则验证
• 数据结构不匹配：数据库路径和实际存储结构不一致，比如节点名拼写错误（比如把users写成user、username拼写错误）、对应uid下没有username字段、字段不是String类型
• UI更新未在主线程执行：Firebase数据回调如果在后台线程触发，直接操作UI会导致不渲染
• 当前账号未登录：Auth.auth().currentUser为nil，guard判断直接返回，不会执行后续读数据逻辑
• 标签文字颜色和背景色一致，导致视觉上看不到内容

修正后的代码 #

//  ViewController.swift
import UIKit
import Firebase
import FirebaseAuth
import FirebaseDatabase
import SwiftUI

class HomeViewController: UIViewController {

  override func viewDidLoad() {
    super.viewDidLoad()
    // 去掉冗余的重复uid判断
    guard let uid = Auth.auth().currentUser?.uid else {
      print("当前用户未登录")
      return
    }
    let ref = Database.database().reference().child("users").child(uid).child("username")
    ref.observeSingleEvent(of: .value) { [weak self] snapshot in
      // 先判断快照是否存在
      guard snapshot.exists(), let username = snapshot.value as? String else {
        print("数据读取失败，快照内容：\(snapshot.value ?? "空")")
        return
      }
      // 强制主线程更新UI
      DispatchQueue.main.async {
        guard let self = self else { return }
        let label = UILabel(frame: CGRect(origin: .zero, size: CGSize(width: 100, height: 100)))
        label.center = CGPoint(x: self.view.bounds.midX, y: self.view.bounds.midY)
        label.textAlignment = .center
        // 显式指定文字颜色避免和背景同色
        label.textColor = .black
        label.text = username
        self.view.addSubview(label)
      }
    }
  }
}

额外验证步骤 #

• 打开Firebase控制台Realtime Database页面，手动核对对应uid路径下是否存在username字符串字段
• 测试阶段可以临时把数据库规则修改为以下内容验证逻辑，验证通过后再改成符合业务安全要求的规则：

{
  "rules": {
    "users": {
      "$uid": {
        ".read": "$uid === auth.uid",
        ".write": "$uid === auth.uid"
      }
    }
  }
}

• 确认App启动时已经调用FirebaseApp.configure()，一般放在AppDelegate的didFinishLaunchingWithOptions方法中

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