如何解决Node+Express调用CosmosDB时循环结构转JSON报错

• 该报错的核心是你返回的docResponse对象存在循环引用结构，无法被JSON.stringify序列化。
• Azure Cosmos DB JavaScript SDK 调用read()方法返回的docResponse不是纯业务数据对象，除了目标文档内容外，还挂载了SDK内部的客户端上下文引用：docResponse链路上包含CosmosClient实例引用，CosmosClient.databases指向数据库实例，数据库实例又通过client属性指回CosmosClient，刚好形成闭环引用，和你收到的报错提示完全对应。
• Express的res.send()和res.json()在处理对象类型的返回值时，都会内部自动调用JSON.stringify对数据做序列化，碰到循环结构就会抛出当前错误，所以替换两个方法都无法解决问题。

核心逻辑是只返回需要的纯业务数据，不要把SDK内部上下文对象一起返回：

1. 常规场景下直接使用SDK返回对象中的resource属性即可，这个属性存储的就是你查询到的纯文档业务数据，没有内部引用，不会触发循环序列化问题。
2. 如果需要额外的响应元数据（比如请求消耗的RU、响应状态码等），可以手动摘取需要的字段，规避包含SDK上下文的属性即可。

修改后的业务代码示例：

app.get('/:id', async (req, res) => {
    try {
        var id = req.params.id;

        const dbResponse = await cosmosClient.databases.createIfNotExists({
            id: databaseId
        });
        let database = dbResponse.database;
            
        const { container } = await database.containers.createIfNotExists({id: containerId});

        const docResponse = await container.item(id, 1).read();

        // 仅返回实际业务文档，不要返回整个SDK响应对象
        res.json(docResponse.resource);
    } catch (error) {
        console.log(error);
        res.status(500).send("Error with database query: " + error.body);
    }
})

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