Pino日志库中自定义日志级别格式化导致trace/debug日志丢失问题解析

问题背景

在使用Pino 9.5.0版本时，开发者遇到了一个关于日志级别处理的特殊问题。当配置了自定义的formatters.level格式化器来将数字日志级别转换为大写字符串表示时（如将数字10转换为"TRACE"），发现trace和debug级别的日志不再输出，而其他级别的日志（如info、error）则工作正常。

问题复现

典型的配置场景如下：

1. 基础配置工作正常：初始配置中未使用formatters.level，所有日志级别（包括trace和debug）都能正常输出

2. 添加格式化器后出现问题：当添加了将数字级别转换为大写字符串的自定义格式化器后，trace(10)和debug(20)级别的日志停止输出

技术原理分析

Pino日志库内部对日志级别的处理机制：

1. 日志级别数值映射：Pino内部使用数字表示日志级别，trace=10，debug=20，info=30等

2. 级别过滤机制：当日志级别数值低于配置的最小级别时，日志会被过滤掉

3. 格式化器影响：自定义的formatters.level会改变日志级别的表示形式，但需要确保不影响内部级别比较逻辑

问题根源

经过深入分析，发现问题出在日志级别比较逻辑上：

1. 当使用自定义格式化器将数字级别转换为字符串后，Pino内部可能无法正确比较字符串形式的级别与配置的阈值级别

2. 特别是对于trace和debug这两个最低级别，字符串比较可能导致它们被错误地过滤

3. 基础日志实例的级别配置如果没有显式设置，可能会继承默认值（info），导致低级别日志被过滤

解决方案

1. 显式设置基础日志级别：在创建基础logger时，明确设置level: 'trace'，确保所有级别都能通过

2. 检查格式化器实现：确保自定义格式化器不会破坏Pino内部的级别比较逻辑

3. 统一父子logger级别：如果使用child logger，确保父logger和子logger的级别配置一致

最佳实践建议

1. 在复杂配置中，始终显式设置基础logger的级别

2. 测试自定义格式化器对各级别日志的影响

3. 考虑使用Pino的预设格式化选项而非完全自定义

4. 升级到最新版本并检查变更日志，了解级别处理机制的改进

总结

这个问题揭示了日志库中级别处理机制的复杂性。通过理解Pino内部的工作原理，开发者可以更好地配置和使用这个高性能日志库，确保所有级别的日志都能按预期输出，同时保持所需的格式化效果。