Pino日志库多流输出配置中的日志级别问题解析

多流输出配置的常见误区

在使用Pino日志库进行多流输出配置时，开发者经常会遇到日志级别不生效的问题。特别是在同时配置生产环境错误日志流(如Sentry)和开发环境控制台输出流时，debug级别的日志经常无法正常显示。

问题现象分析

典型的配置场景是：

1. 生产环境使用Sentry等错误监控服务，只记录error级别日志
2. 开发环境额外添加控制台输出，希望显示debug级别日志

但实际运行时发现，即使设置了logger的level为"debug"，debug级别的日志仍然不会输出到控制台。

根本原因

问题出在multistream的配置方式上。Pino的多流输出机制中，每个流都需要单独指定其处理的日志级别。仅仅在logger实例上设置level参数是不够的，还需要为每个输出流明确指定其处理的日志级别范围。

正确配置方案

正确的配置方式应该是：

const streams = [
  { level: 'error', stream: sentryStream }, // Sentry只处理error
  { level: 'debug', stream: prettyStream }  // 控制台处理debug及以上
];

const logger = pino({ level: 'debug' }, pino.multistream(streams));

这种配置明确指定了：

1. Sentry流只接收error级别日志
2. 美化控制台输出流接收debug及以上级别日志
3. logger实例本身的level设置为debug，确保不会在源头过滤掉debug日志

配置建议

对于多环境日志配置，推荐采用以下模式：

1. 基础流配置：包含必要的错误监控流
2. 开发环境增强：添加控制台输出流
3. 明确指定每个流的处理级别
4. 确保logger实例的level足够低，不会过早过滤日志

总结

Pino的多流输出功能非常强大，但需要理解其日志级别处理机制。关键是要记住：logger实例的level控制日志生成，而每个流的level控制日志输出。只有两者配合得当，才能实现精确的日志控制。