App Engine上Spring Boot服务连接Google Datastore异常排查与解决

现有运行在App Engine Standard环境的Java应用，通过datanucleus访问Datastore，依托Standard环境原生支持可稳定正常连接Datastore。
新开发的Spring Boot应用使用spring-cloud-gcp-data-datastore库操作Datastore，已配置服务账号连接用的.json密钥文件，本地配合gcloud beta模拟器运行一切正常。
部署到生产环境后，应用尝试连接Datastore时报错，错误日志如下：

com.google.cloud.datastore.DatastoreException: I/O error
...
Caused by: com.google.datastore.v1.client.DatastoreException: I/O error
...
Caused by: java.net.ConnectException: Connection refused (Connection refused)

需要明确该连接异常的排查思路，以及Spring Boot应用与Datastore连接流程日志的打印方法。

• 首先核对生产环境配置是否残留本地模拟器相关配置，重点检查spring.cloud.gcp.datastore.host、spring.cloud.gcp.emulator.enabled这类仅本地调试生效的配置项，生产环境需要删除或关闭此类配置。
• 检查服务账号权限是否正确，若部署在App Engine Standard环境，默认使用平台提供的内置服务账号，无需额外配置密钥文件，确保对应账号拥有Datastore的读写操作权限。
• 检查网络连通性，若应用部署在自定义VPC环境下，确认是否有网络ACL、安全组规则禁止访问Datastore服务地址，可通过调整VPC出口规则或配置Private Google Access保障网络连通。

如需打印Datastore连接全流程的详细日志，可在Spring Boot配置文件中添加如下日志级别配置：

logging:
  level:
    com.google.cloud.datastore: DEBUG
    org.springframework.cloud.gcp.datastore: DEBUG

开启后即可在日志中看到连接地址解析、请求发起、鉴权校验等全流程的详细信息，可快速定位连接类问题的根因。

本次问题根因为部署生产环境时未关闭本地模拟器相关配置，导致应用尝试连接本地不存在的模拟器地址，触发连接拒绝报错。
处理方式：注释或删除配置文件中的spring.cloud.gcp.datastore.host配置项后，应用即可正常连接生产环境Datastore服务。

内容的提问来源于stack exchange，提问作者Jorge Merino Llamera