Azure CosmosDB存储过程调试：优化日志可读性与避免堆叠

我之前调试Cosmos DB存储过程时也踩过这些日志的坑，给你整理几个靠谱的解决办法：

1. 搞定日志换行与空格编码问题 #

Cosmos DB的日志查看器会对console.log()输出的特殊字符做URL编码，导致\n/\r\n不生效、空格变成%20。你可以换用以下两种方式：

• 用context.log()替代console.log()：
  context.log()输出的内容会被正确解析，空格和换行符（\n）都能正常显示。示例代码：

  function sampleStoredProcedure() {
      context.log("这是第一行日志\n");
      context.log("这是第二行日志，包含正常空格");
  }
  

• 用HTML标签强制换行（适配门户查看器）：
  如果必须用console.log()，可以在消息中插入<br>标签，Cosmos DB门户的日志面板会渲染HTML换行：

  console.log("第一行日志内容<br>第二行日志内容<br>带空格的文本");
  

2. 避免日志堆叠，清空历史日志 #

每次执行存储过程后，之前的日志会默认保留，你可以在存储过程开头调用context.clearScriptLog()来清空历史日志，确保每次执行的日志都是独立的：

function sampleStoredProcedure() {
    // 先清空之前的历史日志
    context.clearScriptLog();
    
    // 开始输出本次执行的日志
    context.log("本次存储过程执行的日志内容");
    // ... 后续业务逻辑代码
}

如果context.clearScriptLog()在你的环境中不可用（比如旧版本SDK），可以手动添加分隔线来区分每次执行：

function sampleStoredProcedure() {
    // 添加醒目分隔线，区分本次与历史日志
    context.log("==================================");
    context.log("=== 新一次存储过程执行开始 ===");
    context.log("==================================");
    
    // 后续日志内容
    context.log("业务逻辑步骤1：初始化数据");
}

额外调试小提示 #

• 输出复杂对象时，用JSON.stringify(yourObject, null, 2)格式化后再打印，结构会更清晰：

  const testObj = {name: "test", data: [1,2,3]};
  context.log(JSON.stringify(testObj, null, 2));
  

• 尽量避免输出过大的日志内容，否则可能影响存储过程的执行性能。

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