本地AWS Lambda日志仅显示对象片段，如何输出完整对象？

问题说明 #

在本地测试AWS Lambda函数时，打印短字符串日志正常，但打印Axios返回的大响应对象时，日志仅显示类似--- 属性 '_httpMessage' 存在循环引用的截断内容，无法查看完整对象。

问题根源 #

1. 循环引用导致序列化失败：Axios的response对象包含循环引用属性（如_httpMessage），直接使用JSON.stringify()会触发循环引用错误，导致日志无法完整输出。
2. 日志输出长度限制：Node.js或SAM本地工具默认对过长的日志内容会进行截断。

解决方案 #

1. 处理循环引用并完整序列化对象 #

通过JSON.stringify()的replacer参数跳过循环引用属性，或使用专门处理循环引用的库：

• 自定义replacer跳过循环引用：

const response = await axios.get(url);
console.log('test');
console.log(JSON.stringify(response, (key, value) => {
  // 跳过已知的循环引用属性，可根据实际情况调整
  if (['_httpMessage', 'request'].includes(key)) {
    return undefined;
  }
  return value;
}, 2)); // 第三个参数2用于格式化缩进，提升可读性

• 使用flatted库（需先执行npm install flatted安装）：

const flatted = require('flatted');
const response = await axios.get(url);
console.log('test');
console.log(flatted.stringify(response));

2. 使用console.dir替代console.log #

console.dir支持递归打印对象，可通过配置参数避免截断：

const response = await axios.get(url);
console.log('test');
// depth设为null表示无限递归，完整打印对象结构
console.dir(response, { depth: null, colors: true });

3. 调整SAM本地日志配置 #

如果是SAM本地工具导致的日志截断，可通过两种方式优化：

• 在template.yml的函数环境变量中添加配置：

Resources:
  Function:
    Type: AWS::Serverless::Function
    Properties:
      # 原有配置保留
      Environment:
        Variables:
          NODE_DEBUG: 'console' # 启用Node.js控制台调试，减少截断

• 运行SAM本地时将日志输出到文件（文件中不会截断）：

sam local invoke Function --log-file lambda-logs.txt

额外优化建议 #

如果仅需要响应的核心数据，可直接打印指定字段，避免序列化整个大对象：

const response = await axios.get(url);
console.log('响应数据:', response.data);
console.log('响应头:', response.headers);

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