Azure Function CosmosDBInput绑定无法返回指定值问题排查

我编写了如下Azure Function代码：

private const string PartitionKey = "/westus2";

public class League
{
    public string id { get; set; }

    public string Description { get; set; }

    public List<string> GameIds { get; set; }
}

[Function("AddGame")]
public async Task<AddGameMultiResponse> AddGame(
    [HttpTrigger(AuthorizationLevel.Anonymous, "get", "post", Route = "addgame/{leagueId}")] HttpRequestData req,
    [CosmosDBInput(databaseName: "MyDB",
        collectionName: "Leagues",
        PartitionKey = PartitionKey,
        ConnectionStringSetting = "CosmosDbConnectionString")] IEnumerable<League> leagues,
    [CosmosDBInput(databaseName: "MyDB",
        collectionName: "Leagues",
        Id = "{leagueId}",
        PartitionKey = PartitionKey,
        ConnectionStringSetting = "CosmosDbConnectionString")] League league)
{
}

通过Postman调用URI：

http://localhost:7071/api/addgame/5fa8c927-15ad-4fd2-8b9d-4d7b11723021

时，发现leagues中存在id为"5fa8c927-15ad-4fd2-8b9d-4d7b11723021"的项，但league变量却为null，数据资源管理器中可查看到该数据。使用SqlQuery方式：

[CosmosDBInput(databaseName: "MyDB",
    collectionName: "Leagues",
    PartitionKey = PartitionKey,
    ConnectionStringSetting = "CosmosDbConnectionString",
    SqlQuery = "SELECT * from c WHERE c.id = {leagueId}")] IEnumerable<League> matchingLeagues

则可正常获取数据，怀疑CosmosDBInput绑定存在问题，请问我哪里操作错误？

问题出在分区键的格式错误：

• 你定义的PartitionKey = "/westus2"多了前缀斜杠/，Cosmos DB的分区键值不需要这个斜杠，直接写实际的分区键值即可（比如westus2）。
• 用Id+PartitionKey组合查询时，分区键格式错误会导致无法精准匹配到文档，所以league变量为null；而SqlQuery是集合范围的扫描，只要id匹配就能找到文档，因此可以正常返回数据。

修正步骤：

1. 修改分区键常量定义：

private const string PartitionKey = "westus2";

2. 确认Cosmos DB中目标文档的分区键值确实为westus2（可在数据资源管理器中查看文档的_partitionkey字段）。
3. 重新运行Function后调用接口，即可正常获取league实例。

额外注意：如果容器的分区键路径不是/westus2（比如是/region），需要确保文档中对应字段的值为westus2，同时绑定中的PartitionKey设为westus2，才能匹配成功。

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