Firestore runQuery接口调用未返回预期查询结果求助

问题分析 #

调用Firestore runQuery API后仅返回readTime，无预期文档数据，核心原因大概率是请求体格式不规范或无匹配的文档。

修复步骤 #

1. 修正请求体JSON格式 #

你的请求体存在不符合JSON规范的问题：

• 所有键和字符串使用了单引号，JSON要求必须用双引号
• from数组内的对象缺少闭合括号
• 单个过滤条件无需嵌套compositeFilter（语法上允许但简化后更清晰）

修正后的请求体如下：

{
  "structuredQuery": {
    "from": [
      {
        "collectionId": "questions"
      }
    ],
    "orderBy": [
      {
        "field": {
          "fieldPath": "created"
        },
        "direction": "DESCENDING"
      }
    ],
    "select": {
      "fields": [
        { "fieldPath": "id" },
        { "fieldPath": "details" },
        { "fieldPath": "question" },
        { "fieldPath": "votes" }
      ]
    },
    "where": {
      "fieldFilter": {
        "field": {
          "fieldPath": "author"
        },
        "op": "EQUAL",
        "value": {
          "stringValue": "henry"
        }
      }
    },
    "limit": 4
  }
}

2. 验证数据匹配性 #

• 确认questions集合中存在**author字段值为小写"henry"**的文档，Firestore字符串匹配大小写敏感（"Henry"和"henry"视为不同值）
• 检查文档中的字段名是否与请求完全一致（如created、id等字段是否存在，拼写无错误）

3. 注意：文档ID与自定义id字段的区别 #

如果你的id指的是Firestore自动生成的文档ID（而非自定义存储的id字段），需要将select中的fieldPath改为__name__，示例：

"select": {
  "fields": [
    { "fieldPath": "__name__" },
    { "fieldPath": "details" },
    { "fieldPath": "question" },
    { "fieldPath": "votes" }
  ]
}

返回结果中的name字段格式为projects/{项目ID}/databases/(default)/documents/questions/{文档ID}，可从中提取最后的文档ID部分。

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