Kotlin中使用Firebase whereArrayContains查询返回空列表问题

问题场景 #

• 已通过嵌套集合结构将TaskModel数据保存至Firestore，路径为：Users/{currentUser}/construcitonName/{constructionArea}/task/{day}/taskId/{taskId}
• 控制台可见数据，其他查询逻辑正常，但调用whereArrayContains查询workerList字段时返回空列表
• 按照提示添加索引后，索引报错消失，但查询结果仍为空，同时抛出异常：Method threw 'java.lang.NullPointerException' exception. Cannot evaluate com.google.firebase.firestore.FirebaseFirestoreSettings.toString()

核心问题分析 #

1. 查询路径完全错误：
   保存数据时用的是嵌套在Users下的多层子集合，但查询代码直接调用database.collection("task")，这指向的是Firestore根目录下的task集合，和实际存储数据的嵌套task集合不是同一个位置，自然查不到数据。
2. 空指针异常关联原因：
   无效的查询路径触发了Firestore内部的配置解析异常，或者DI注入的Firestore实例在异常场景下出现空值引用。

解决方案 #

1. 修正查询路径（二选一） #

方案A：使用集合组查询跨所有嵌套的taskId集合

如果需要查询所有用户/工地中包含指定工人的任务，需使用集合组查询，并配置对应的集合组索引：

override suspend fun getTasksWithWorker(worker: String): Result<List<TaskModel>> {
    return kotlin.runCatching {
        val tasks = mutableListOf<TaskModel>()
        // 集合组查询所有名为taskId的子集合
        val querySnapshot = database.collectionGroup("taskId")
            .whereArrayContains("workerList", worker)
            .get()
            .await()
        querySnapshot.documents.forEach { doc ->
            doc.toObject(TaskModel::class.java)?.let { tasks.add(it) }
        }
        tasks
    }
}

注意：需在Firebase控制台配置集合组索引，索引字段选择workerList，排序规则按需设置。

方案B：调整数据结构为平级存储（更适合全局查询）

如果频繁需要跨用户查询任务，建议将TaskModel直接存储到根目录的tasks集合，同时保留currentUser、constructionArea等字段作为查询条件：

// 保存数据时调整路径
val taskRef = database.collection("tasks").document(taskModel.taskId.toString())
taskRef.set(post).await()

// 查询代码简化为
val querySnapshot = database.collection("tasks")
    .whereArrayContains("workerList", worker)
    .get()
    .await()

2. 排查空指针异常 #

• 检查provideFireStoreInstance的DI注入逻辑，确保FirebaseFirestore实例初始化完成后再注入，避免空实例被使用
• 查询前验证worker参数非空，避免传入空值触发无效查询

3. 额外验证点 #

• 确认workerList字段在Firestore中是数组类型，而非字符串或其他类型
• 检查查询值与数组元素的大小写、空格完全匹配（Firestore字符串查询大小写敏感）
• 确认索引配置完成后等待5-10分钟生效（Firestore索引生效需要一定时间）

内容的提问来源于stack exchange，提问作者Muhammed Ali ERKOÇ