迁移至Python3后Google Datastore的Entity.put调用出现内部错误

你遇到的AssertionError: No api proxy found for service "search"，本质是Python 3.x版本的Google App Engine（GAE）标准环境不再支持旧版App Engine Search API（即google.appengine.api.search模块）。这个API是Python 2时代的遗留服务，Python 3运行时中没有对应的API代理实现，所以在调用时会触发找不到服务的断言错误。

需要替换旧的Search API调用，以下是两种可行方案：

方案1：改用Cloud Search API（官方推荐） #

这是GCP官方提供的替代方案，属于独立的云服务，完全支持Python 3.12：

1. 前置准备：
   • 在GCP控制台启用Cloud Search API。
   • 创建服务账号密钥，将密钥文件路径配置到环境变量GOOGLE_APPLICATION_CREDENTIALS（本地开发直接设置，GAE部署可通过app.yaml的env_variables配置）。
2. 安装依赖：

   pip install google-cloud-search
   

3. 重构索引更新代码：

   from google.cloud import search_v1
   
   def search_update_index(collection):
       client = search_v1.SearchServiceClient()
       # 替换为你的GCP项目ID和索引ID
       index_name = client.index_path("your-gcp-project-id", "your-index-id")
       
       # 构造要索引的文档
       document = search_v1.Document(
           fields={
               "name": search_v1.Field(string_value=collection.name),
               # 添加其他需要索引的字段，按实际业务调整
           }
       )
       
       # 执行文档更新（不存在则创建）
       request = search_v1.UpdateDocumentRequest(
           index=index_name,
           document=document,
           document_id=str(collection.key.id())
       )
       client.update_document(request=request)
   

方案2：使用Datastore/Firestore轻量检索（适合简单需求） #

如果你的检索需求不复杂，可以直接利用Datastore或Firestore的检索能力：

• 若使用Firestore in Datastore模式，原生支持全文检索查询，只需将实体数据同步到Firestore即可：

  from google.cloud import firestore
  
  def search_update_index(collection):
      db = firestore.Client()
      doc_ref = db.collection("collections").document(str(collection.key.id()))
      # 同步需要检索的字段
      doc_ref.set({
          "name": collection.name,
          # 其他业务字段
      }, merge=True)
  

• 若坚持使用原生Datastore，可手动实现分词+多字段模糊匹配（适合简单场景，性能有限）。

• 移除sync.yaml中与旧Search API相关的配置（Python 3环境无需这类配置）。
• 本地开发时，Datastore可使用gcloud beta emulators datastore start模拟；Cloud Search无本地模拟器，需直接调用线上服务。
• 部署前确认GAE服务账号拥有对应权限：比如Cloud Search需要roles/cloudsearch.editor，Datastore/Firestore需要roles/datastore.user。

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