Firestore中chats集合无法通过stream()/get()获取文档求助

问题描述 #

我使用基础的Firestore数据库，chats集合下的每个chat文档都包含messages子集合。我可以正常访问特定消息：

msg_ref = self.db.collection('chats').document(chat_id).collection('messages').document(msg_id)

也能获取指定chat下的所有消息：

msgs_ref = db.collection('chats').document(chat_id).collection('messages')
for doc in msgs_ref.stream():
    print(doc.id)

但执行chat_ref = db.collection('chats').get()会返回空列表，导致下面的代码无法进入循环：

chat_ref = db.collection('chats')
for doc in chat_ref.stream():
   print(doc.id)

参考官方文档示例：

docs = db.collection(u'cities').stream()

for doc in docs:
    print(f'{doc.id} => {doc.to_dict()}')

完全不清楚问题出在哪里，恳请解释该代码为何无法工作，以及如何修复。

可能的原因与修复方案 #

1. chats集合下无实际文档，仅存在子集合 #

Firestore的特性是：仅创建子集合而未创建对应的父文档时，父集合的查询会返回空结果。你能访问chat_id下的子集合，不代表chats集合中存在chat_id这个文档——Firestore允许直接创建子集合，无需预先创建父文档。

修复方法：

• 登录Firestore控制台，检查chats集合内是否存在实际文档（哪怕是空文档）；
• 若通过代码创建子集合，需同时创建对应的父文档，示例代码：

  # 先创建chat父文档（可设为空）
  db.collection('chats').document(chat_id).set({})
  # 再创建子集合中的消息
  db.collection('chats').document(chat_id).collection('messages').add({"content": "测试消息"})
  

2. 安全规则限制了chats集合的读取权限 #

你能读取messages子集合，但Firestore安全规则可能仅开放了chats/{chatId}/messages的读取权限，未对chats集合本身开放读取权限。

修复方法：

• 检查Firestore安全规则，确保添加允许读取chats集合的规则，示例：

  rules_version = '2';
  service cloud.firestore {
    match /databases/{database}/documents {
      match /chats/{chatId} {
        // 根据实际业务需求调整权限逻辑，请勿直接使用true
        allow read: if request.auth != null;
        match /messages/{messageId} {
          allow read: if request.auth != null;
        }
      }
    }
  }
  

3. db实例初始化存在异常 #

虽然你能访问子集合，但仍需确认db实例的初始化配置是否正确指向目标数据库：

• 确保查询chats集合时使用的db实例，和访问messages子集合时的实例初始化参数（项目ID、认证信息等）完全一致；
• 可在查询前打印db的配置信息，验证是否指向正确的Firestore数据库。

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