Cosmos DB字符串范围索引查询报错：单字段索引下不等查询失败

首先，你的索引策略配置是正确的，问题出在Cosmos DB对不同查询类型的索引利用规则上，以及查询请求的参数设置。

为什么相等查询能正常工作，而!=查询报错？ #

• 相等查询（x.Id = "xxx"）属于精确匹配，可以直接命中你配置的/Id/?路径上的RangeIndex，所以不需要扫描就能返回结果。
• 而!=这类范围类查询，Cosmos DB默认会拒绝执行（除非显式允许），因为这类查询无法仅通过索引完成，需要验证每个文档的Id字段是否符合条件——这在默认情况下会被索引策略的限制拦截，即使你已经索引了Id字段。

两种解决方案 #

方案1：修改查询请求，允许扫描 #

最直接的解决方式是在FeedOptions中添加AllowScan = true，明确告知Cosmos DB允许执行扫描操作来完成这个查询：

CosmosClient.CreateDocumentQuery<Entity>(
    CollectionUri(docCollection), 
    "SELECT x from x where x.Id != \"\" ", 
    new FeedOptions { 
        MaxItemCount = 100, 
        RequestContinuation = null, 
        EnableCrossPartitionQuery = false, 
        PartitionKey = new PartitionKey("entities"),
        AllowScan = true // 添加这一行开启扫描
    }).AsDocumentQuery();

方案2：确认索引策略的细节（可选） #

你的索引策略本身没有问题，但可以再确认RangeIndex的配置是否符合预期：

new IndexingPolicy { 
    Automatic = true, 
    IndexingMode = IndexingMode.Consistent, 
    ExcludedPaths = new Collection<ExcludedPath>(new[] { new ExcludedPath { Path = "/*" } }), 
    IncludedPaths = new Collection<IncludedPath>(new[] { 
        new IncludedPath { 
            Path = "/Id/?", 
            Indexes = new Collection<Index>(new Index[] { 
                new RangeIndex(DataType.String) { Precision = -1 } 
            }) 
        } 
    }) 
};

这里/Id/?的路径是正确的（?表示精确匹配单个字段），RangeIndex设置精度-1表示对整个字符串做索引，完全支持相等和范围类查询——但前提是查询允许扫描。

总结 #

你不需要修改索引策略，只需要在查询的FeedOptions中开启AllowScan = true，就能让!=查询正常执行。当然要注意：扫描操作会比纯索引查询消耗更多的RU，所以如果这类查询很频繁，需要评估RU的消耗情况。

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