Firebase与Swift环境下用户名大小写敏感的注册问题解决需求

这个问题我之前帮不少开发者解决过——Firebase默认对字符串查询是区分大小写的，所以才会出现"Tony"和"tony"被当成两个不同用户名的情况。核心思路是统一用户名的大小写格式，不管用户输入的是大写还是小写，都转换成同一个标准格式去查询和存储，这样就能避免重复注册的问题。

具体实现步骤如下：

1. 标准化用户名格式 #

在处理用户输入的用户名时，先把它转换成全小写（或者全大写，只要全程保持一致就行）。比如用户输入"Tony"、"TONY"或者"tony"，最终都转换成"tony"来处理。

2. 修改注册逻辑（Swift代码示例） #

先查询标准化后的用户名是否存在，再决定是否创建账号：

// 获取用户输入的原始用户名、邮箱、密码
let inputUsername = "tony" // 替换为用户实际输入内容
let email = "user@example.com"
let password = "yourPassword123"

// 标准化用户名为全小写
let normalizedUsername = inputUsername.lowercased()

// 指向Firebase数据库的用户节点
let usersRef = Database.database().reference().child("users")

// 查询标准化后的用户名是否存在
usersRef.child(normalizedUsername).observeSingleEvent(of: .value) { snapshot in
    if snapshot.exists() {
        // 用户名已被占用，提示用户
        print("用户名已存在，请更换其他用户名")
        // 这里可替换为UI弹窗提示，比如AlertController
    } else {
        // 用户名可用，执行Firebase Auth注册流程
        Auth.auth().createUser(withEmail: email, password: password) { authResult, error in
            guard let user = authResult?.user, error == nil else {
                // 处理注册错误，比如邮箱格式不对、密码太短等
                print("注册失败：\(error?.localizedDescription ?? "未知错误")")
                return
            }
            
            // 存储用户信息到数据库：标准化后的用户名用于唯一标识，原始用户名用于显示
            let userData: [String: Any] = [
                "username": normalizedUsername,
                "displayName": inputUsername, // 保留用户输入的原始格式用于展示
                "email": email,
                "uid": user.uid
            ]
            
            usersRef.child(normalizedUsername).setValue(userData) { error, _ in
                if let error = error {
                    print("存储用户信息失败：\(error.localizedDescription)")
                } else {
                    print("注册成功！")
                    // 这里可跳转到首页或执行其他逻辑
                }
            }
        }
    }
}

额外注意事项 #

• 后续登录或者查询用户信息时，也要使用标准化后的用户名进行查询，比如用户登录输入"Tony"，先转成小写再去数据库查找，确保匹配正确。
• 如果你的项目中用了Firebase Auth的自定义Claims来存储用户名，同样要存储标准化后的格式，避免后续权限验证时出现问题。

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