如何将Cloud Firestore（Datastore模式）的实体Key转为urlsafe字符串

嘿，我刚好处理过这个问题！旧版ndb里的entity.key.urlsafe()确实在新版Datastore模式的客户端里用不了，但官方提供了几乎一样的替代方案，操作起来很顺手。

核心方法：使用key.to_urlsafe() #

新版的google-cloud-datastore客户端库中，Key类自带了to_urlsafe()方法，专门用来生成URL安全的字符串表示，用法和旧版的urlsafe()几乎一致。

步骤1：确保安装了正确的客户端库

如果你还没装，先执行：

pip install google-cloud-datastore

步骤2：生成URL安全字符串

不管是直接创建的Key，还是从实体中获取的Key，都可以调用这个方法：

示例1：创建Key并转换

from google.cloud import datastore

# 初始化Datastore客户端
client = datastore.Client()

# 创建一个Kind为"User"、ID为123的Key
user_key = client.key("User", 123)

# 转换为URL安全字符串
urlsafe_str = user_key.to_urlsafe()
print(urlsafe_str)  # 输出类似 "ag5kZXZ-Y29tbW9uLWRhdGFzdG9yZXIiCxIGVXNlchgDDA" 的字符串

示例2：从现有实体中获取Key并转换

# 假设你已经通过查询或get方法拿到了实体对象entity
urlsafe_str = entity.key.to_urlsafe()

额外：解析URL安全字符串回Key对象 #

如果需要把生成的字符串转回Key对象，可以用客户端的key_from_urlsafe()方法：

parsed_key = client.key_from_urlsafe(urlsafe_str)
print(parsed_key.kind)  # 输出 "User"
print(parsed_key.id)    # 输出 123

兼容性说明 #

这个方法生成的字符串和旧版ndb的urlsafe()完全兼容，之前用旧方法生成的URL安全字符串，用新版的key_from_urlsafe()也能正常解析，不用担心迁移问题。

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