迁移App Engine项目至Cloud NDB：本地dev_appserver访问云端而非本地数据存储

方案一：不用Datastore模拟器，直接用dev_appserver内置本地存储 #

• 先安装适配Python2.7的Cloud NDB版本，Python2.7仅兼容到1.10.0版本：

  pip install google-cloud-ndb==1.10.0
  

• 修改项目代码强制绑定本地存储，在appengine_config.py或项目入口文件中添加：

  from google.cloud import ndb
  from google.cloud.ndb import context
  
  def get_local_context():
      client = ndb.Client()
      # 强制使用dev_appserver的本地存储桩
      return context.Context(client, namespace=None, project=None, stub=client._stub)
  
  # 替换默认上下文
  ndb.context.get_context = get_local_context
  

• 启动dev_appserver时不要加--support_datastore_emulator true参数，直接执行：

  dev_appserver.py app.yaml
  

方案二：使用Datastore模拟器（解决依赖冲突问题） #

• 创建虚拟环境隔离依赖，避免全局包冲突：

  virtualenv venv
  source venv/bin/activate  # Windows系统执行 venv\Scripts\activate
  pip install google-cloud-ndb==1.10.0 googledatastore==7.0.0
  

• 启动Datastore模拟器：

  gcloud beta emulators datastore start --project=你的项目ID --no-store-on-disk
  

• 新开终端加载模拟器自动生成的环境变量（不要手动写入app.yaml）：

  $(gcloud beta emulators datastore env-init)
  

• 启动dev_appserver：

  dev_appserver.py app.yaml --support_datastore_emulator true
  

关键注意事项 #

• Python2.7的Cloud NDB最高兼容版本为1.10.0，新版本仅支持Python3，请勿盲目升级
• 不要手动在app.yaml中配置DATASTORE_*系列环境变量，会与模拟器自动注入的变量冲突
• 若之前安装过冲突依赖，先清理再重装：

  pip uninstall -y google-cloud-datastore googledatastore
  

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