Azure Cosmos DB Gremlin添加顶点报错：分区键值为null

数据老陈

2026-6-18

问题分析与解决方案

核心问题

你混淆了Cosmos DB图容器的分区键路径和分区键的值，同时需要确保实体类的分区键属性被正确传递到Gremlin查询中。

1. 修正Azure Cosmos DB图容器的分区键设置

在Azure门户创建/配置图容器时，分区键路径应该设置为**/PartitionKey**（对应你的Vertex类中的PartitionKey属性名称），而不是/AzheirGraph（这是你要给分区键赋的值）。

之前你把分区键路径设为/AzheirGraph，导致Cosmos DB会去寻找名为AzheirGraph的属性，但你的实体类里只有PartitionKey属性，自然找不到，所以判定分区键为null。

2. 确保分区键属性被正确赋值

虽然Vertex类给PartitionKey设置了默认值"/AzheirGraph"，但建议在创建Account实例时显式赋值，避免序列化或继承相关的潜在问题：

AzheirAPI.Elements.Account newAccount = new()
{
    Id = Guid.NewGuid().ToString(),
    Email = requestEmail,
    Password = Argon2.Hash(requestPassword),
    PartitionKey = "/AzheirGraph" // 显式设置分区键值
};

3. 验证Gremlinq配置

你的Gremlinq配置中.WithPartitionKey(x => x.PartitionKey!)是正确的，它指定了使用Vertex类的PartitionKey属性作为分区键。确保配置没有其他问题，比如序列化器是否正确处理该属性：

IGremlinQuerySource gremlinQuerySource = GremlinQuerySource.g
   .UseCosmosDb<Vertex, Edge>(configurator => configurator
        .At(new Uri(fullUri))
        .OnDatabase(database)
        .OnGraph(graph)
        .WithPartitionKey(x => x.PartitionKey!)
        .AuthenticateBy(authentication)
        .UseNewtonsoftJson());