遵循谷歌文档操作GCP DataStore：插入成功但无法获取记录

核心原因：获取操作使用了不完整的Key #

当执行datastore.key('Task')时，生成的是没有ID/名称的不完整Key：

• Upsert操作允许使用不完整Key，此时Datastore会自动生成唯一ID作为实体标识符
• Get操作必须使用完整Key（包含实体类型+ID/名称），否则会触发INVALID_ARGUMENT错误

谷歌文档并未过时 #

官方文档的示例会区分两种场景：

1. Upsert用不完整Key（自动生成ID）：需保存返回的完整Key，或后续通过查询获取实体
2. Get用完整Key：必须明确指定实体的ID或名称

修复方案 #

方案1：Upsert后保存自动生成的完整Key #

修改Upsert代码，提取返回的完整Key用于后续Get操作：

import { Datastore } from '@google-cloud/datastore'

const datastore = new Datastore()

const taskKey = datastore.key('Task');
const task = {
  category: 'Personal',
  done: false,
  priority: 4,
  description: 'Learn Cloud Datastore',
};

const entity = {
  key: taskKey,
  data: task,
};

// 执行upsert并获取响应
const [response] = await datastore.upsert(entity);
// 提取包含自动生成ID的完整Key
const savedTaskKey = response[0].mutationResults[0].key;

// 使用完整Key执行Get
const [entity] = await datastore.get(savedTaskKey);
console.log(entity);

方案2：Upsert时使用自定义ID/名称的完整Key #

提前指定实体的ID或名称，后续直接复用该Key：

// Upsert代码（使用自定义数字ID）
const taskKey = datastore.key(['Task', 123]);
// 也可使用字符串名称：datastore.key(['Task', 'my-personal-task'])

const entity = {
  key: taskKey,
  data: task,
};

await datastore.upsert(entity);

// Get代码直接使用相同的完整Key
const taskKey = datastore.key(['Task', 123]);
const [entity] = await datastore.get(taskKey);
console.log(entity);

方案3：通过查询获取实体（未保存Key时） #

如果无法获取完整Key，可通过属性查询定位实体：

import { Datastore } from '@google-cloud/datastore'

const datastore = new Datastore()

// 创建查询筛选目标实体
const query = datastore.createQuery('Task')
  .filter('description', '=', 'Learn Cloud Datastore')
  .limit(1);

const [entities] = await datastore.runQuery(query);
if (entities.length > 0) {
  console.log(entities[0]);
} else {
  console.log('未找到匹配实体');
}

其他可能的问题原因 #

• Key构造格式错误：正确的完整Key格式应为['实体类型', ID/名称]，避免单参数构造不完整Key
• 客户端配置异常：Datastore客户端未正确配置项目ID，可能导致Key解析失败
• 库版本兼容问题：@google-cloud/datastore旧版本对Key的处理逻辑存在差异，建议使用最新稳定版

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