SST项目中console.error的正确使用方式解析

在SST框架开发过程中，日志记录和错误处理是开发者需要特别注意的关键环节。近期有开发者反馈在SST项目中使用console.error时遇到了日志显示问题，这实际上涉及到了SST框架对错误处理的特殊设计理念。

问题现象

开发者在使用SST框架时发现，直接使用console.error输出错误信息时，这些错误不会被SST控制台识别为"问题"(Issues)。例如以下代码：

export const handler = ApiHub.handlerREST(async () => {
  const admin = await useAdminUser();
  const payload = useValidatedPayloadOptions(Payload);
  
  console.error('Test Error Payload:', payload);
  // ...
});

虽然代码中明确使用了console.error，但这些错误信息在SST控制台中仅显示为INFO级别的日志，而不会被归类到专门的"问题"区域。

根本原因

这个问题并非SST框架的缺陷，而是框架设计上的有意为之。SST框架对"问题"有明确的定义标准：

1. 只有抛出Error对象才会被识别为真正的"问题"
2. 单纯的console.error输出被视为普通日志信息
3. 这种设计有助于区分真正的程序错误和调试信息

正确使用方法

根据SST官方文档的建议，正确的错误记录方式应该是：

console.error(new Error("my-error"));

这种方式会创建一个真正的Error对象，SST控制台会将其识别为需要关注的"问题"，而不仅仅是日志信息。

日志与错误的区别

理解SST框架的这种设计需要区分几个概念：

1. 日志信息：用于记录程序运行状态，包括info、warn、error等级别
2. 程序错误：表示程序执行过程中出现的异常情况
3. SST问题：框架特别关注的、需要开发者注意的错误情况

在SST框架中，只有符合特定条件的错误才会被提升为"问题"，这种设计可以帮助开发者聚焦真正需要关注的问题。

最佳实践建议

基于SST框架的这种特性，建议开发者：

1. 对于需要特别关注的错误，总是创建Error对象
2. 保留console.error用于记录非关键性错误信息
3. 重要的业务逻辑错误应该使用throw抛出
4. 调试信息可以使用console.log或console.info

这种分层处理的方式可以使日志系统更加清晰，也便于在SST控制台中快速定位真正需要解决的问题。

总结

SST框架对错误处理有着明确的设计哲学，理解并遵循这些规范可以帮助开发者更有效地利用框架提供的调试工具。记住，在SST生态中，创建Error对象而不仅仅是输出错误日志，是确保问题被正确识别和跟踪的关键。