Kotlin操作Firestore文档子集合：创建与增删改查技术问询

以下是针对Firestore子集合的创建、查询、更新、删除操作的Kotlin实现方案，以及解决你遇到的「存入数据但拉取不到」问题的常见排查点：

一、创建子集合并添加文档 #

首先初始化Firestore实例，再通过父文档路径指定子集合，完成数据写入：

val db = Firebase.firestore

// 构造要存入子集合的数据
val subDocData = hashMapOf(
    "title" to "测试子文档",
    "content" to "子集合数据内容",
    "createTime" to FieldValue.serverTimestamp()
)

// 写入到「父集合/父文档ID/子集合」路径下
db.collection("parentCollection").document("parentDocId")
    .collection("subCollection") // 指定子集合名称
    .add(subDocData)
    .addOnSuccessListener { docRef ->
        Log.d("Firestore", "子文档创建成功，ID: ${docRef.id}")
    }
    .addOnFailureListener { e ->
        Log.w("Firestore", "子文档创建失败", e)
    }

二、查询子集合数据 #

1. 查询子集合所有文档 #

db.collection("parentCollection").document("parentDocId")
    .collection("subCollection")
    .get()
    .addOnSuccessListener { querySnapshot ->
        for (doc in querySnapshot) {
            Log.d("Firestore", "${doc.id} => ${doc.data}")
        }
    }
    .addOnFailureListener { e ->
        Log.w("Firestore", "子集合查询失败", e)
    }

2. 条件查询子集合 #

比如筛选createTime在指定时间之后的文档：

val targetTime = Timestamp(Date().time - 86400000) // 一天前的时间

db.collection("parentCollection").document("parentDocId")
    .collection("subCollection")
    .whereGreaterThan("createTime", targetTime)
    .get()
    .addOnSuccessListener { querySnapshot ->
        for (doc in querySnapshot) {
            Log.d("Firestore", "符合条件的文档: ${doc.id} => ${doc.data}")
        }
    }

三、更新子集合文档 #

1. 更新指定字段 #

仅修改需要更新的字段，保留其他原有数据：

val updateData = hashMapOf(
    "content" to "更新后的子文档内容",
    "updateTime" to FieldValue.serverTimestamp()
)

db.collection("parentCollection").document("parentDocId")
    .collection("subCollection").document("subDocId") // 指定要更新的子文档ID
    .update(updateData)
    .addOnSuccessListener {
        Log.d("Firestore", "子文档更新成功")
    }
    .addOnFailureListener { e ->
        Log.w("Firestore", "子文档更新失败", e)
    }

2. 合并覆盖文档 #

如果需要替换整个文档但保留未指定的字段，使用SetOptions.merge()：

val newDocData = hashMapOf(
    "title" to "全新标题",
    "content" to "全新内容"
)

db.collection("parentCollection").document("parentDocId")
    .collection("subCollection").document("subDocId")
    .set(newDocData, SetOptions.merge())
    .addOnSuccessListener {
        Log.d("Firestore", "子文档合并更新成功")
    }

四、删除子集合文档 #

1. 删除单个子文档 #

db.collection("parentCollection").document("parentDocId")
    .collection("subCollection").document("subDocId")
    .delete()
    .addOnSuccessListener {
        Log.d("Firestore", "子文档删除成功")
    }
    .addOnFailureListener { e ->
        Log.w("Firestore", "子文档删除失败", e)
    }

2. 删除整个子集合 #

Firestore没有直接删除子集合的API，需要批量删除所有子文档：

db.collection("parentCollection").document("parentDocId")
    .collection("subCollection")
    .get()
    .addOnSuccessListener { docs ->
        val batch = db.batch()
        docs.forEach { batch.delete(it.reference) }
        batch.commit().addOnSuccessListener {
            Log.d("Firestore", "子集合所有文档删除完成")
        }
    }

五、「存入数据但拉取不到」问题排查 #

1. 路径匹配检查：确认父文档ID、子集合名称完全匹配（Firestore路径区分大小写），比如SubCollection和subCollection是两个不同集合。
2. 安全规则权限：如果Firestore安全规则限制了读取权限，会导致拉取失败。测试阶段可临时设置宽松规则（上线前务必修改）：

rules_version = '2';
service cloud.firestore {
  match /databases/{database}/documents {
    match /{document=**} {
      allow read, write: if true;
    }
  }
}

3. 异步逻辑处理：Firestore操作是异步的，数据处理逻辑必须写在addOnSuccessListener内部，不要在回调外直接获取数据。
4. 数据类型匹配：确保读取时的数据类型与存入时一致，比如存入Long类型的数值，不能用Int接收，否则会解析失败。

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