如何将Salesforce日志文件解析为结构化JSON对象？Node.js有哪些可用库？

现成开箱即用的Node.js库 #

直接用Node生态中专门针对Salesforce日志设计的解析库salesforce-log-parser即可，完全不需要用到antlr4这类高复杂度的语法解析工具。
该库原生支持识别你提到的所有标识段落：EXECUTION_STARTED、EXECUTION_FINISHED、CODE_UNIT_STARTED、CODE_UNIT_FINISHED等所有标准Salesforce日志事件，会自动提取每行日志的时间戳、事件参数、嵌套层级信息，直接输出结构化JSON对象，完全匹配你的需求。
使用示例：

// 安装命令：npm install salesforce-log-parser
const { SalesforceLogParser } = require('salesforce-log-parser');
const fs = require('node:fs');

// 读取本地Salesforce日志文件内容
const rawLog = fs.readFileSync('./sfdc-debug.log', 'utf8');
const parser = new SalesforceLogParser();
const structuredJson = parser.parse(rawLog);

// 输出格式化后的结果
console.log(JSON.stringify(structuredJson, null, 2));

输出的JSON结构默认包含以下核心字段：

• 全局执行信息：执行开始/结束时间、总执行时长
• 事件列表：每个事件的时间戳、事件类型、对应参数（比如CODE_UNIT对应的类名、方法名）
• 嵌套层级关系：自动识别CODE_UNIT的嵌套调用结构

轻量自定义实现方案 #

如果你有特殊的自定义日志字段需要解析，也可以用正则匹配的方案快速实现，开发成本极低：

1. 先定义需要匹配的所有日志事件类型
2. 编写正则匹配每行日志的时间、事件类型、附加信息
3. 维护一个调用栈处理CODE_UNIT这类嵌套事件的层级关系

极简实现示例：

const fs = require('node:fs');
const EVENT_TYPES = new Set(['EXECUTION_STARTED', 'EXECUTION_FINISHED', 'CODE_UNIT_STARTED', 'CODE_UNIT_FINISHED']);
// 匹配标准Salesforce日志行格式：[时间戳] | [事件类型] | [附加信息]
const lineReg = /^(\d{2}:\d{2}:\d{2}\.\d{3})\s*\|\s*([A-Z_]+)\s*\|\s*(.*)$/;

function parseSfdcLog(logContent) {
  const result = {
    executionStartTime: null,
    executionEndTime: null,
    events: [],
    callStack: []
  };
  const lines = logContent.split('\n');
  for (const line of lines) {
    const match = line.match(lineReg);
    if (!match) continue;
    const [, timestamp, eventType, extra] = match;
    if (!EVENT_TYPES.has(eventType)) continue;
    
    const event = { timestamp, eventType, extra };
    if (eventType === 'EXECUTION_STARTED') result.executionStartTime = timestamp;
    if (eventType === 'EXECUTION_FINISHED') result.executionEndTime = timestamp;
    if (eventType.endsWith('_STARTED')) result.callStack.push(event);
    if (eventType.endsWith('_FINISHED')) {
      const startEvent = result.callStack.pop();
      event.duration = calculateDuration(startEvent.timestamp, timestamp);
    }
    result.events.push(event);
  }
  return result;
}

// 辅助函数：计算两个时间戳的毫秒差
function calculateDuration(startTime, endTime) {
  const start = new Date(`1970-01-01T${startTime}Z`).getTime();
  const end = new Date(`1970-01-01T${endTime}Z`).getTime();
  return end - start;
}

// 使用
const rawLog = fs.readFileSync('./sfdc-debug.log', 'utf8');
const parsed = parseSfdcLog(rawLog);
console.log(JSON.stringify(parsed, null, 2));

选型建议 #

• 通用解析需求直接用salesforce-log-parser，开箱即用，不需要处理各类日志格式兼容问题，上手成本极低
• 有自定义解析需求可以基于正则方案二次开发，不需要学习antlr4的复杂语法规则，开发量通常在百行代码以内

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