Azure Cosmos DB存储过程无法返回文档问题排查求助

我帮你梳理下几个关键问题，这些应该就是导致你查不到文档的核心原因：

1. SQL查询语句的语法错误 #

你当前直接拼接id变量生成查询语句，但没有给字符串类型的id添加单引号。这会导致Cosmos DB把id当成列名而非具体的字符串值，自然匹配不到任何文档。

推荐两种修改方式：

// 方式1：给id添加单引号（注意：如果id本身包含单引号会有问题，适合临时测试）
var query = `select * from groups c where c.id = '${id}'`;

// 方式2：参数化查询（更安全，避免SQL注入风险，推荐使用）
var query = {
    query: "select * from groups c where c.id = @id",
    parameters: [{name: "@id", value: id}]
};

2. 分区键的正确传递与查询优化 #

既然你的集合分区键设为id，执行查询时必须指定分区键值，让Cosmos DB直接定位到目标分区——如果没指定，要么触发低效的跨分区查询（若未开启跨分区查询则直接失败），要么无法命中正确分区。

修改queryDocuments的选项参数，添加分区键指定：

var isAccepted = collection.queryDocuments(
    collectionLink, 
    query, 
    { partitionKey: id }, // 明确指定分区键值
    function (err, documents, responseOptions) {
        // 回调逻辑...
    }
);

另外要注意：在Azure门户执行存储过程时，输入的分区键值必须是你要查询的具体文档id值，而不是输入"ID"这个字符串，这点你可以再确认下之前的操作是否正确。

3. 处理请求未被接受的情况 #

collection.queryDocuments返回的isAccepted表示请求是否被Cosmos DB成功接受，如果返回false，说明当前资源不足，需要简单重试：

if (!isAccepted) {
    setTimeout(executeQuery, 100); // 延迟100ms后重试查询
}

4. 给客户端返回可见结果 #

你当前代码里的console.log是在Cosmos DB服务器端输出的，客户端（包括Azure门户）看不到。需要用response.setBody()把查询结果返回，这样执行存储过程时就能直接看到结果了。

完整修改后的代码 #

function sample(id) { 
    var context = getContext(); 
    var collection = context.getCollection(); 
    var collectionLink = collection.getSelfLink(); 
    var response = context.getResponse(); 

    executeQuery(); 

    function executeQuery() { 
        // 使用参数化查询避免语法错误和注入风险
        var query = {
            query: "select * from groups c where c.id = @id",
            parameters: [{name: "@id", value: id}]
        };

        var isAccepted = collection.queryDocuments(
            collectionLink, 
            query, 
            { partitionKey: id },
            function (err, documents, responseOptions) { 
                if (err) throw new Error("Error: " + err.message); 
                if (documents.length > 0) { 
                    console.log("found");
                    response.setBody(documents); // 将查询结果返回给客户端
                } else { 
                    console.log("nothing");
                    response.setBody([]); // 返回空数组告知无结果
                } 
            } 
        );

        // 处理请求未被接受的重试逻辑
        if (!isAccepted) {
            setTimeout(executeQuery, 100);
        }
    } 
}

最后再确认两个细节：

• 你输入的分区键值和目标文档的id是否完全一致（Cosmos DB的字符串比较是大小写敏感的）
• 集合的分区键确实设置为/id，没有拼写错误

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