如何从Node.js版AWS Lambda向CloudWatch记录原始JSON日志？

我之前也遇到过完全一样的问题！在Node.js Lambda里用默认的console.log输出对象时，CloudWatch根本没法按JSON规则过滤查询，太头疼了。后来试了几个方法，亲测有效，分享给你：

这是最快的解决方案，直接把要记录的对象转成严格的JSON字符串再输出：

console.log(JSON.stringify({a:1,b:2,x:"xxx"}));

这样CloudWatch里的日志就会是标准JSON格式：

2020-04-29T14:46:45.722Z 3f64c499-fbae-4a84-996c-5e5f0cb5302c INFO {"a":1,"b":2,"x":"xxx"}

之后你就能用CloudWatch的JSON过滤规则（比如$.a = 1）或者CloudWatch Insights的解析语法来查询了。

如果你的对象存在循环引用（比如嵌套引用自身），可以加一个replacer函数处理：

const safeStringify = (obj) => JSON.stringify(obj, (key, value) => {
  if (typeof value === 'object' && value !== null && value[key]) {
    return '[Circular Reference]';
  }
  return value;
});

console.log(safeStringify(yourCircularObj));

如果需要更规范的日志格式（比如带日志级别、请求ID等），可以封装一个简单的日志工具，自动处理JSON序列化，还能捕获序列化失败的情况：

// 自定义日志工具
const createLogger = (requestId) => ({
  info: (data) => log('INFO', data, requestId),
  error: (data) => log('ERROR', data, requestId)
});

const log = (level, data, requestId) => {
  try {
    const logObj = {
      timestamp: new Date().toISOString(),
      level,
      requestId,
      ...data
    };
    console.log(JSON.stringify(logObj));
  } catch (err) {
    // 序列化失败时降级输出，避免日志丢失
    console.error(`[${level}] Serialization failed:`, err);
    console.log(`[${level}] Raw data:`, data);
  }
};

// 在Lambda handler中使用
exports.handler = async (event, context) => {
  const logger = createLogger(context.awsRequestId);
  
  logger.info({a:1,b:2,x:"xxx"});
  logger.error({message: 'Something went wrong', error: new Error('Oops').stack});
  
  // ...其他业务逻辑
};

这样输出的日志结构统一，方便后续的日志分析和过滤，还能避免因序列化失败导致日志丢失的问题。

你提到的直接调用CloudWatchLogs API的方法其实不太推荐，因为Lambda是无状态的，每次调用都是全新的执行环境，没办法在调用间维持nextToken这类状态值。如果要存token就得用DynamoDB之类的外部存储，这会增加复杂度和额外成本——上面的两种方法已经能完美满足「记录纯JSON日志并让CloudWatch可查询」的需求了。

当日志是标准JSON后，用CloudWatch Insights可以这样快速查询：

fields @timestamp, @message
| parse @message as json log
| filter log.level = "INFO" and log.a = 1
| sort @timestamp desc
| limit 20

内容的提问来源于stack exchange，提问作者Esben von Buchwald