LLRT项目中JSON日志格式化问题的分析与解决

在LLRT项目（AWS Lambda轻量级运行时）中，开发者发现了一个关于JSON日志格式化的问题。当使用console.log()输出对象时，日志系统没有按照预期将对象结构化为JSON键值对，而是将其转换为字符串形式输出。

问题现象

开发者尝试按照AWS官方文档中的JSON日志功能进行测试，使用如下代码：

console.log({ data: 12.3, flag: false });

期望的输出应该是结构化的JSON格式，但实际得到的却是：

{
    "time": "2024-03-01T19:55:28.045Z",
    "requestId": "bf340645-6ed9-40a3-ae15-2a82dc83ec5d",
    "level": "INFO",
    "message": "{ data: 12.3, flag: false }"
}

可以看到，原本应该被解析为JSON的对象被直接转换为了字符串形式，失去了结构化数据的优势。

问题分析

经过技术团队调查，发现这是Node.js在Lambda环境中处理JSON日志格式时的一个不一致行为。具体表现为：

1. 当console.log()只接收一个参数（且为对象）时，该对象会被展开并转换为JSON格式
2. 当接收多个参数时，则保持与LLRT一致的行为（即转换为字符串）

这种不一致性可能导致开发者在调试和日志分析时遇到困难，特别是当需要从日志中提取结构化数据时。

解决方案

技术团队迅速响应，通过提交的代码变更修复了这个问题。主要修改包括：

1. 统一了单参数和多参数情况下的日志处理逻辑
2. 确保所有传递给console.log()的对象都能被正确序列化为JSON格式
3. 保持了与其他AWS服务日志格式的兼容性

最佳实践建议

对于日志输出，特别是在Serverless环境中，建议开发者：

1. 尽量输出结构化数据，便于后续分析和查询
2. 对于复杂对象，考虑使用JSON.stringify()明确转换
3. 避免在日志中混合输出字符串和对象，保持格式一致性
4. 在需要输出多个信息时，考虑将它们合并到一个对象中

总结

这个问题的解决体现了LLRT项目团队对开发者体验的重视。通过保持日志格式的一致性，使得开发者能够更轻松地从Lambda函数中获取有价值的调试信息，同时也为日志分析工具提供了更好的支持。对于使用AWS Lambda的开发者来说，理解日志格式化行为的变化有助于编写更健壮和易于维护的Serverless应用。