Android Kotlin Firebase用户名登录认证实现问题求助

一、核心逻辑说明 #

Firebase Auth默认仅支持邮箱/密码、手机号等认证方式，没有原生的用户名登录机制。要实现你的需求，需要结合Firebase Auth（处理身份认证）和Firebase Firestore（存储用户关联信息），流程如下：

1. 注册时先校验邮箱、用户名的唯一性
2. 用createUserWithEmailAndPassword创建邮箱密码用户
3. 将用户名与用户ID、邮箱绑定存入Firestore
4. 登录时通过用户名查询对应邮箱，再调用邮箱密码登录接口

二、注册流程实现 #

1. 提前配置Firestore #

• 在Firebase控制台创建users集合，用于存储用户信息，文档ID建议使用Firebase Auth生成的uid（方便关联）
• 为users集合的username和email字段创建唯一索引，避免并发场景下的重复注册（在Firestore索引管理页配置）

2. 完善注册函数（含唯一性校验与信息存储） #

private val auth = FirebaseAuth.getInstance()
private val firestore = FirebaseFirestore.getInstance()
private val usersCollection = firestore.collection("users")

suspend fun registerUser(email: String, username: String, password: String): String {
    return try {
        // 校验邮箱是否已被注册
        val emailExists = auth.fetchSignInMethodsForEmail(email).await().signInMethods?.isNotEmpty() == true
        if (emailExists) return "邮箱已被注册"

        // 校验用户名是否已存在
        val usernameQuery = usersCollection.whereEqualTo("username", username).get().await()
        if (!usernameQuery.isEmpty) return "用户名已被使用"

        // 创建邮箱密码用户
        val userCredential = auth.createUserWithEmailAndPassword(email, password).await()
        val user = userCredential.user ?: return "用户创建失败"

        // 存储用户关联信息到Firestore
        val userData = hashMapOf(
            "uid" to user.uid,
            "email" to email,
            "username" to username,
            "createdAt" to FieldValue.serverTimestamp()
        )
        usersCollection.document(user.uid).set(userData).await()

        "注册成功"
    } catch (e: Exception) {
        e.message ?: "注册失败"
    }
}

三、登录流程实现（用户名+密码） #

登录时需先通过用户名查询对应邮箱，再调用Firebase Auth的登录接口：

suspend fun loginWithUsername(username: String, password: String): String {
    return try {
        // 通过用户名查询绑定的邮箱
        val usernameQuery = usersCollection.whereEqualTo("username", username).get().await()
        if (usernameQuery.isEmpty) return "用户名不存在"
        
        val userDoc = usernameQuery.documents.first()
        val email = userDoc.getString("email") ?: return "用户信息异常"

        // 执行邮箱密码登录
        auth.signInWithEmailAndPassword(email, password).await()

        "登录成功"
    } catch (e: Exception) {
        when (e) {
            is FirebaseAuthInvalidUserException, is FirebaseAuthInvalidCredentialsException -> "用户名或密码错误"
            else -> e.message ?: "登录失败"
        }
    }
}

四、获取当前登录用户的用户名 #

登录成功后，可通过当前用户的uid从Firestore中查询用户名：

suspend fun getCurrentUsername(): String? {
    val currentUser = auth.currentUser ?: return null
    val userDoc = usersCollection.document(currentUser.uid).get().await()
    return userDoc.getString("username")
}

五、优化建议 #

• 可将用户名等常用信息缓存到本地（如SharedPreferences），减少Firestore查询次数
• 若需修改用户名，需重新校验唯一性并更新Firestore中的数据
• 注册时可扩展添加用户头像、昵称等字段，丰富用户信息

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