Firebase Firestore中survey_questions集合查询返回空结果问题

问题情况 #

• Python查询Firebase Firestore的survey_questions集合时返回空列表，但Firebase控制台确认该集合已存在并包含文档
• 同一Firestore客户端配置可正常查询users集合，查询过程无报错，集合名称拼写正确
• 日志显示查询对象无异常，但调用stream()方法后得到空文档列表

排查与解决思路 #

1. 安全规则限制（最常见原因） #

Firestore默认安全规则会拒绝未授权的读取请求，这种情况下查询不会报错，但会返回空结果（这是Firestore的设计）。

• 临时测试验证：将Firestore安全规则暂时改为开放（仅用于测试，上线前务必改回严格规则）：

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

• 正式权限配置：根据业务需求设置规则，比如允许已认证用户读取：

match /survey_questions/{doc} {
  allow read: if request.auth != null;
}

2. 确认集合层级是否正确 #

检查控制台中的survey_questions是否为子集合（属于某个文档的下级集合），而非顶层集合。如果是子集合，需要先定位到父文档再查询：

# 示例：如果是users集合下某文档的子集合
db.collection('users').document('目标用户ID').collection('survey_questions').stream()

3. 验证服务账号权限 #

即使和users集合用相同配置，也要确认服务账号是否有访问survey_questions集合的权限：

• 登录Google Cloud控制台，找到对应项目的IAM页面
• 检查服务账号是否拥有Cloud Datastore User或Firestore Viewer角色

4. 代码简化（非核心问题，但可优化） #

原代码中if doc:的判断多余，stream()返回的迭代器只会包含存在的文档，可简化代码：

from app.configs.firebase_config import db

class SurveyRepository:
    def __init__(self):
        self.survey_questions_collection = db.collection('survey_questions')
        
    def get_survey_questions(self):
        try:
            docs_list = [doc.to_dict() for doc in self.survey_questions_collection.stream()]
            print("Documents List:", docs_list)
            return docs_list
        except Exception as e:
            print(f"An error occurred: {e}")

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