使用Google Cloud Datastore Java API连接默认数据库失败求助

一、优先解决认证问题 #

• 配置GCP服务账号凭据：
  • 下载服务账号密钥JSON文件，设置环境变量：
    • Linux/Mac：export GOOGLE_APPLICATION_CREDENTIALS="/path/to/your-service-account-key.json"
    • Windows：set GOOGLE_APPLICATION_CREDENTIALS=C:\path\to\key.json
  • 验证凭据：执行gcloud auth application-default print-access-token，能输出有效token则认证正常
• 托管环境（GCE/Cloud Run等）需确认服务账号已绑定Cloud Datastore User或更高权限角色

二、修正数据库ID配置 #

Firestore Datastore模式的默认数据库ID固定为(default)，既不是空字符串也不是default，代码需显式指定：

import com.google.cloud.datastore.Datastore;
import com.google.cloud.datastore.DatastoreOptions;
import com.google.cloud.datastore.Query;
import com.google.cloud.datastore.Entity;
import com.google.cloud.datastore.StructuredQuery;

public class CountriesQuery {
    public static void main(String[] args) {
        Datastore datastore = DatastoreOptions.newBuilder()
                .setProjectId("你的GCP项目ID")
                .setDatabaseId("(default)") // 关键：必须带括号
                .build()
                .getService();

        // 查询Countries kind所有记录
        Query<Entity> query = StructuredQuery.newEntityQueryBuilder()
                .setKind("Countries")
                .build();

        datastore.run(query).forEach(entity -> 
            System.out.println(entity.getKey().getName() + ": " + entity)
        );
    }
}

• 空字符串会指向旧版非Firestore模式的Datastore，导致"默认数据库不存在"错误；直接用default会被判定为无效ID

三、检查依赖版本兼容性 #

确保google-cloud-datastore依赖支持Java11，推荐使用2.20.0以上稳定版，Maven配置示例：

<dependency>
    <groupId>com.google.cloud</groupId>
    <artifactId>google-cloud-datastore</artifactId>
    <version>2.20.1</version>
</dependency>

• 旧版本对Firestore Datastore模式的数据库ID适配存在问题

四、新建数据库的验证步骤 #

若新建clinixdemods数据库仍提示不存在：

• 确认创建时选择的是Datastore模式，而非Firestore原生模式
• 代码中指定数据库ID为clinixdemods（无需括号），同时核对项目ID是否正确
• 在GCP控制台Datastore页面确认该数据库下Countries kind存在数据

五、对比DataNucleus配置差异 #

DataNucleus能正常访问说明项目权限和数据库本身无问题，重点排查：

• DataNucleus配置中是否隐式使用了(default)作为数据库ID，新API需显式配置
• 确认两者使用同一服务账号凭据，避免权限不一致

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