Python NDB查询Datastore时内嵌实体values返回None的问题排查

这个问题的核心原因是你用Google Cloud Datastore原生Python客户端写入内嵌实体时，没有为它设置正确的kind值，导致App Engine的ndb无法将其映射到你定义的DataValues模型实例，最终values字段被解析为None。

为什么会这样？ #

ndb的StructuredProperty有个隐含规则：它会期望对应的内嵌实体在Datastore中的kind与关联的模型类名完全一致（这里就是DataValues）。但当你用原生Datastore客户端创建内嵌实体时，如果没有显式指定kind，这个内嵌实体的kind会是空值，ndb无法识别它属于DataValues模型，自然就无法填充values属性——但因为你的复合索引是基于内嵌实体的属性创建的，所以过滤查询能正常执行（索引只关心属性路径，不关心实体kind）。

解决方法 #

你需要修改写入数据的代码，确保内嵌实体的kind被设置为DataValues。举个正确的写入示例：

from google.cloud import datastore

client = datastore.Client()

# 创建内嵌实体时，显式指定kind为DataValues
values_entity = datastore.Entity(kind="DataValues")
values_entity["param1"] = True
values_entity["param2"] = 100
values_entity["param3"] = 200

# 创建主实体并关联内嵌实体
my_entity_key = client.key("MyEntity")
my_entity = datastore.Entity(key=my_entity_key)
my_entity["data_type"] = 1
my_entity["raw_bytes"] = b"your_unindexed_blob"
my_entity["values"] = values_entity

client.put(my_entity)

如果因为某些限制无法修改写入代码，你也可以在ndb模型的StructuredProperty中显式指定内嵌实体的实际kind（比如你写入时用了其他kind名称）：

class MyEntity(ndb.Expando):
    data_type = ndb.IntegerProperty(required=True)
    raw_bytes = ndb.BlobProperty()
    # 这里的kind参数设置为你写入内嵌实体时用的kind名称
    values = ndb.StructuredProperty(DataValues, kind="你的内嵌实体kind")

验证方式 #

你可以登录Datastore控制台，查看已写入的实体：找到values字段对应的内嵌实体，检查它的kind是否为DataValues。如果之前是空值或者其他名称，修改后就能正常映射了。

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