如何用Python在Firebase中查询数组内特定键值对的嵌套对象？

我是Firebase新手，文档结构如下：

{
    "title": "Tera Hone Laga Hoon",
    "album": "Ajab Prem Ki Ghazab Kahani",
    "artists": [
        {"name": "Atif Aslam", "thumbnail": "https://download.org/At98yvnsh-oid"},
        {"name": "Joi Barua", "thumbnail": "https://download.org/Joi-0osmaa"}
    ]
}

我想筛选出所有包含名为Atif Aslam的艺人的文档，但用array_contains匹配完整对象时，部分场景下thumbnail URL不匹配导致查询失败，请问有没有办法仅通过{name: "Atif Aslam"}来查询？

核心结论 #

Firebase Firestore的array_contains查询要求匹配完整的数组元素对象，无法直接仅通过嵌套对象的单个键值对筛选。推荐通过调整数据结构解决，以下是具体方案：

方案1：新增单独的名字数组（推荐） #

在文档中添加一个artist_names数组，专门存储所有艺人的名字，同步维护这个数组与artists数组的一致性：

{
    "title": "Tera Hone Laga Hoon",
    "album": "Ajab Prem Ki Ghazab Kahani",
    "artists": [
        {"name": "Atif Aslam", "thumbnail": "https://download.org/At98yvnsh-oid"},
        {"name": "Joi Barua", "thumbnail": "https://download.org/Joi-0osmaa"}
    ],
    "artist_names": ["Atif Aslam", "Joi Barua"]
}

然后直接使用array_contains查询名字数组：

db.collection("songs").where(u"artist_names", u"array_contains", "Atif Aslam")

• 优点：查询效率高，符合Firestore的查询规则，维护成本低。
• 注意：新增/修改艺人时，要同步更新artist_names数组。

方案2：查询后客户端过滤（适合无法修改结构的场景） #

先拉取所有歌曲文档，再在本地过滤出包含目标艺人的文档：

songs_ref = db.collection("songs")
filtered_songs = []

# 遍历所有文档并过滤
for song_doc in songs_ref.stream():
    song_data = song_doc.to_dict()
    # 检查artists数组中是否存在目标名字
    for artist in song_data.get("artists", []):
        if artist.get("name") == "Atif Aslam":
            filtered_songs.append(song_doc)
            break

• 缺点：如果集合中文档数量大，会拉取全部数据，消耗大量带宽，仅适合小数据集场景。

方案3：改用子集合存储艺人数据 #

将每个艺人作为歌曲文档的子集合文档存储，路径示例：songs/{song_id}/artists/{artist_id}
艺人文档结构：

{
    "name": "Atif Aslam",
    "thumbnail": "https://download.org/At98yvnsh-oid"
}

通过集合组查询找到所有包含目标艺人的歌曲：

from firebase_admin import firestore

db = firestore.client()
# 查询所有名为Atif Aslam的艺人文档
artist_docs = db.collection_group("artists").where(u"name", u"==", "Atif Aslam").stream()

# 获取对应的歌曲文档
target_songs = []
for artist_doc in artist_docs:
    # 从艺人文档路径回溯到父级歌曲文档
    song_doc = artist_doc.reference.parent.parent.get()
    target_songs.append(song_doc)

• 适用场景：需要对艺人数据进行单独增删改查操作，或艺人数据结构复杂的情况。
• 注意：使用集合组查询需要提前在Firebase控制台配置对应的索引。

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