在Firestore数据库的实际使用中，嵌套Map结构常被用来存储关联性较强的层级数据，比如用户资料中的地址信息、商品属性中的规格参数等。当需要筛选出嵌套Map中特定键值对完全匹配的文档时，不能直接使用顶层字段的查询方式，需要遵循Firestore的嵌套字段查询规则。
Firestore嵌套Map的存储结构
Firestore中的Map类型字段可以包含多个键值对，也支持嵌套其他Map结构。比如一个存储用户信息的文档，其address字段是一个嵌套Map，结构如下：
{
"name": "张三",
"age": 28,
"address": {
"province": "广东",
"city": "深圳",
"district": "南山区"
}
}
这里的address字段就是一个嵌套Map，包含province、city、district三个子字段。
嵌套Map字段精确查询的实现方式
Firestore查询嵌套Map字段时，需要使用点号连接外层字段名和嵌套字段名，格式为外层字段名.嵌套字段名，然后指定对应的值进行匹配。
Web端JavaScript查询示例
使用Firebase JavaScript SDK查询address.city为深圳的所有用户文档：
// 引入Firebase SDK
import { getFirestore, collection, query, where, getDocs } from "firebase/firestore";
// 初始化Firestore实例
const db = getFirestore();
// 构建查询条件，address.city为嵌套字段，使用点号拼接
const q = query(
collection(db, "users"),
where("address.city", "==", "深圳")
);
// 执行查询
const querySnapshot = await getDocs(q);
querySnapshot.forEach((doc) => {
// 输出匹配的文档数据
console.log(doc.id, doc.data());
});
Android端Kotlin查询示例
使用Firebase Android SDK实现相同的查询逻辑：
// 获取Firestore实例
val db = FirebaseFirestore.getInstance()
// 构建查询，指定嵌套字段address.city的值为深圳
db.collection("users")
.whereEqualTo("address.city", "深圳")
.get()
.addOnSuccessListener { documents ->
for (document in documents) {
// 打印匹配的文档ID和数据
println("${document.id} => ${document.data}")
}
}
.addOnFailureListener { exception ->
println("查询失败：${exception.message}")
}
iOS端Swift查询示例
使用Firebase Swift SDK实现查询：
import FirebaseFirestore
// 获取Firestore实例
let db = Firestore.firestore()
// 构建查询条件
db.collection("users")
.whereField("address.city", isEqualTo: "深圳")
.getDocuments { snapshot, error in
if let error = error {
print("查询失败：(error.localizedDescription)")
return
}
// 遍历匹配的文档
snapshot?.documents.forEach { document in
print("(document.documentID) => (document.data())")
}
}
多层嵌套Map的查询方式
如果嵌套层级更深，比如address下有detail嵌套Map，需要继续用点号拼接字段名，例如查询address.detail.street为科技南一路的文档，字段名写作address.detail.street即可，查询逻辑和单层嵌套一致。
查询注意事项
- 嵌套字段的键名必须完全匹配，包括大小写，Firestore的字段名是大小写敏感的。
- 如果需要查询嵌套Map中存在某个键的文档，不能使用值匹配的方式，需要结合
array-contains或者特殊字段标记实现，仅通过值匹配无法判断键是否存在。 - 精确查询仅支持等值匹配，不支持对嵌套Map的子字段进行范围查询，比如不能查询address.city大于某个值的结果。
- 如果要查询嵌套Map中多个字段的组合条件，可以添加多个where条件，Firestore会自动组合这些条件。
常见误区说明
很多开发者会尝试直接传入整个嵌套Map作为查询值，比如where("address", "==", {city: "深圳"})，这种方式要求文档中的address字段完全和传入的Map一致，包括所有子字段和对应的值，只要有一个子字段不同就会匹配失败，无法实现仅匹配单个嵌套子字段的需求。
如果需要实现更复杂的嵌套结构查询，比如匹配嵌套Map中某个子字段的模糊值，或者匹配嵌套数组中的对象，需要结合Firestore的其他查询特性或者调整数据结构设计。合理设计嵌套层级和查询条件，能够有效提升Firestore的查询效率，减少不必要的查询开销。