SpdLog多日志接收器级别设置问题解析

概述

在使用SpdLog日志库时，开发者经常需要配置多个日志接收器(sink)，并为每个接收器设置不同的日志级别。本文将通过一个典型场景分析常见的配置问题及其解决方案。

问题场景

假设我们需要实现以下日志配置：

1. 控制台接收器：仅显示警告和错误信息
2. 文件接收器：显示除跟踪信息外的所有日志

常见错误配置

开发者通常会这样配置：

// 创建控制台接收器(仅显示警告及以上)
auto console_sink = std::make_shared<spdlog::sinks::stdout_color_sink_mt>();
console_sink->set_level(spdlog::level::warn);

// 创建文件接收器(显示除trace外的所有日志)
auto file_sink = std::make_shared<spdlog::sinks::rotating_file_sink_mt>(...);
file_sink->set_level(spdlog::level::debug);

// 创建主日志器并添加接收器
auto main_logger = std::make_shared<spdlog::logger>("main");
main_logger->sinks().push_back(console_sink);
main_logger->sinks().push_back(file_sink);

// 设置为默认日志器
spdlog::set_default_logger(main_logger);

这种配置会导致两个接收器都只显示警告及以上级别的日志，与预期不符。

问题原因分析

问题出在忽略了日志器本身的级别过滤机制。SpdLog的工作流程分为两个阶段：

1. 日志器级别过滤：首先检查日志消息级别是否达到日志器设置的级别阈值
2. 接收器级别过滤：然后检查消息是否达到各个接收器的级别阈值

在上述配置中，没有显式设置日志器的级别，默认使用spdlog::level::info。因此，任何低于info级别的消息(如debug)在第一阶段就被过滤掉了，根本不会到达接收器。

正确配置方法

要实现预期的多接收器不同级别过滤，需要：

1. 将日志器级别设置为最宽松的级别(通常为trace)
2. 为每个接收器设置各自的过滤级别

// 创建接收器(同上)...

// 创建主日志器
auto main_logger = std::make_shared<spdlog::logger>("main");
main_logger->set_level(spdlog::level::trace);  // 关键设置

// 添加接收器(同上)...

// 设置为默认日志器
spdlog::set_default_logger(main_logger);

工作原理详解

1. 当日志器级别设置为trace时，所有日志消息都会通过第一级过滤
2. 控制台接收器级别为warn，因此只有warn及以上级别的消息会被输出到控制台
3. 文件接收器级别为debug，因此debug及以上级别的消息会被写入文件
4. 如果要完全过滤trace消息，可以额外为文件接收器设置模式：

file_sink->set_pattern("%^%l%$ %v");  // 设置格式
file_sink->set_level(spdlog::level::debug);  // 过滤trace

最佳实践建议

1. 明确区分日志器级别和接收器级别的不同作用
2. 日志器级别应设置为所有接收器中最宽松的级别
3. 使用接收器级别实现细粒度的输出控制
4. 对于复杂过滤需求，可以考虑自定义接收器实现更灵活的过滤逻辑

通过正确理解SpdLog的两级过滤机制，开发者可以灵活配置各种复杂的日志输出需求。