如何在Firestore的字符串数组字段中插入数据并同步更新RecyclerView？

1. 房间数据结构设计 #

直接用生成的随机数作为room集合下的文档ID，这样用户输入编码后可以直接查询对应文档，匹配效率最高，文档结构如下：

room (集合)
└── 随机房间号（文档ID）
    ├── randomCode: 字符串，和文档ID一致
    ├── users: 字符串数组，存储已加入房间的用户名
    └── createTime: 时间戳，房间创建时间

2. 宿主端（Start Activity）实现逻辑 #

• 生成6位随机数作为房间号，初始化房间数据写入Firestore
• 创建成功后开启对该房间文档的实时监听
  代码示例：

// 生成6位随机房间号
val randomRoomCode = (100000..999999).random().toString()
val firestore = FirebaseFirestore.getInstance()
val roomRef = firestore.collection("room").document(randomRoomCode)

// 初始化房间数据
val initData = hashMapOf(
    "randomCode" to randomRoomCode,
    "users" to arrayListOf<String>(),
    "createTime" to FieldValue.serverTimestamp()
)

roomRef.set(initData)
    .addOnSuccessListener {
        // 房间创建成功，开启用户列表监听
        observeRoomUsers(randomRoomCode)
    }
    .addOnFailureListener {
        Toast.makeText(this, "房间创建失败，请重试", Toast.LENGTH_SHORT).show()
    }

3. 加入端（Join Activity）实现逻辑 #

• 校验用户输入的房间号格式，查询对应房间是否存在
• 房间存在的话，将当前登录用户的用户名追加到users数组中
  代码示例：

val inputCode = binding.etRoomInput.text.toString().trim()
val currentUser = FirebaseAuth.getInstance().currentUser

// 基础校验
if (inputCode.length != 6 || currentUser == null) {
    Toast.makeText(this, "请输入有效的6位房间号并完成登录", Toast.LENGTH_SHORT).show()
    return
}

val userName = currentUser.displayName ?: "匿名用户"
val roomRef = FirebaseFirestore.getInstance().collection("room").document(inputCode)

roomRef.get().addOnSuccessListener { doc ->
    if (doc.exists()) {
        // 原子追加用户名到数组，避免并发冲突
        roomRef.update("users", FieldValue.arrayUnion(userName))
            .addOnSuccessListener {
                Toast.makeText(this, "加入房间成功", Toast.LENGTH_SHORT).show()
            }
    } else {
        Toast.makeText(this, "房间号不存在，请检查后重试", Toast.LENGTH_SHORT).show()
    }
}

4. 实时更新RecyclerView逻辑 #

通过Firestore的快照监听实时获取users数组变化，直接更新适配器即可，因为我们只监听对应随机号的房间，所以天然满足只有编码匹配才更新的要求：

private fun observeRoomUsers(roomCode: String) {
    val roomRef = FirebaseFirestore.getInstance().collection("room").document(roomCode)
    // 注册实时快照监听，页面销毁时要记得移除避免内存泄漏
    roomRef.addSnapshotListener { snapshot, error ->
        if (error != null || snapshot == null || !snapshot.exists()) {
            return@addSnapshotListener
        }
        // 提取用户列表
        val userList = snapshot.get("users") as? List<String> ?: emptyList()
        // 更新RecyclerView数据
        userAdapter.submitList(userList)
    }
}

注意事项 #

• 页面销毁时需要调用ListenerRegistration.remove()移除快照监听，避免内存泄漏
• 可以给room集合配置Firebase安全规则，避免未授权的用户修改房间数据
• 如果需要支持重复用户去重，可以在写入前先判断users数组中是否已经存在当前用户名

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