Datastore查询报错TypeError: Cannot pass project的原因排查

报错原因 #

Google Cloud Datastore Python客户端的query()方法不支持直接传入project参数。

客户端实例（client）在初始化时已经绑定了对应的GCP项目（通过构造参数、环境变量或默认凭据自动关联），query()方法会直接复用该客户端绑定的项目上下文，不需要重复指定项目。传入project参数会触发客户端内部的参数校验逻辑，从而抛出TypeError: Cannot pass project错误。

解决方法 #

移除query()方法中的project参数即可正常运行：

错误代码 #

from_cases_query = client.query(kind="Case",project="staging").add_filter("createdDate", ">=", start_date) 

修正后代码 #

from_cases_query = client.query(kind="Case").add_filter("createdDate", ">=", start_date) 

多项目查询的正确方式 #

如果需要查询多个不同GCP项目的Datastore，需为每个项目单独初始化对应的Client实例：

from google.cloud import datastore

# 初始化预发布环境项目的客户端
staging_client = datastore.Client(project="staging")
staging_cases_query = staging_client.query(kind="Case").add_filter("createdDate", ">=", start_date)

# 初始化其他项目的客户端（示例）
prod_client = datastore.Client(project="production")
prod_cases_query = prod_client.query(kind="Case").add_filter("createdDate", ">=", start_date)

内容的提问来源于stack exchange，提问作者Francisco José Ibáñez Martínez