为何Google Cloud Console查询构建器可用，C++代码查询Datastore却异常？

我有个Datastore查询在Google Cloud Console里能正常运行，但用C程序执行时基本失效，偶尔才成功一两次。使用的服务账号权限没问题，无过滤条件的通用查询能返回正确结果，但用displayName.username做过滤条件、按createdAt降序排序的查询就是不生效。我的C程序里的Query代码如下：

Query: kind {
  name: "db-wahalao-users"
}
filter {
  composite_filter {
    op: AND
    filters {
      property_filter {
        property {
          name: "displayName.username"
        }
        op: EQUAL
        value {
          string_value: "Obasi"
        }
      }
    }
  }
}
order {
  property {
    name: "createdAt"
  }
  direction: DESCENDING
}

解决建议 #

• 检查复合索引配置：Datastore的过滤+排序复合查询必须依赖预创建的持久索引。Console可能会临时生成索引，但代码执行必须用已部署的正式索引。去Datastore索引管理页面，确认是否存在包含displayName.username（EQUAL操作）和createdAt（DESCENDING排序）的复合索引，没有的话手动创建或通过index.yaml部署。
• 修正嵌套属性的写法：C++客户端中嵌套属性不能直接用.拼接名称，需要用property_path的结构化写法，改成如下结构：

  property_filter {
    property {
      path {
        elements { name: "displayName" }
        elements { name: "username" }
      }
    }
    op: EQUAL
    value { string_value: "Obasi" }
  }
  

• 排查重试与超时逻辑：偶尔成功可能是网络波动或服务端延迟导致，检查C++代码是否启用了客户端内置的重试策略，确保请求失败时会自动重试。
• 验证字段类型一致性：确认Datastore中createdAt字段的类型和查询预期一致（比如都是时间戳类型），避免因类型不匹配导致排序或过滤失效。

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