如何在Boost Log 1.81中实现线程安全以解决日志损坏问题

问题场景与配置 #

使用Boost 1.81版本开发多线程应用，通过BOOST_LOG_TRIVIAL宏记录日志，初始化代码如下：

logging::register_simple_formatter_factory<logging::trivial::severity_level, char>("Severity");
logging::register_simple_filter_factory<logging::trivial::severity_level, char>("Severity");

std::ifstream file("log.config");
logging::init_from_stream(file);
logging::add_common_attributes();

日志配置文件log.config内容：

[Core]
DisableLogging=false
#Filter="%Severity% > info"

# Sink settings sections
[Sinks.File]
# Sink destination type
Destination=TextFile

# Sink-specific filter. Optional, by default no filter is applied.
Filter="%Severity% > trace"

# Formatter string. Optional, by default only log record message text is written.
Format="[%TimeStamp%] %Message%"

FileName="Log_%d%m%y_%3N.log"
Target="logs"

RotationSize= 5242880 # 5MB

# The flag shows whether the sink should be asynchronous
Asynchronous=false

# Enables automatic stream flush after each log record.
AutoFlush=true

当前遇到的问题：多线程运行时，日志文件出现行损坏、截断或内容重叠的情况，需要确认如何启用Boost Log的并发处理能力以生成完整日志。

核心原因与解决方案 #

Boost Log的同步Sink（Asynchronous=false）默认不提供线程安全的写入保障，多线程同时向同一个Sink写入日志时，会因竞争导致文件内容损坏。解决方式有两种：

1. 启用异步Sink（推荐方案） #

直接修改配置文件中的Asynchronous参数为true，Boost Log会自动创建后台线程池和日志队列，所有线程的日志记录会先进入队列，再由后台线程串行写入文件，彻底避免多线程写入冲突。

修改后的[Sinks.File]段关键配置：

# 启用异步Sink，自动处理并发写入
Asynchronous=true

说明：启用异步后，AutoFlush的作用变为刷新日志队列，不影响最终日志的完整性。

2. 为同步Sink添加线程安全包装（备选方案） #

如果无法使用异步Sink（例如对日志实时性要求极高），可以通过代码为已创建的同步Sink添加线程安全锁包装。这种方式需要修改日志初始化代码，无法仅通过配置文件实现：

// 获取已初始化的文件Sink
auto sink = logging::core::get()->find_sink_by_name("File");
if (sink) {
    // 为Sink的后端添加线程安全同步装饰器
    auto sync_backend = logging::make_shared<logging::sinks::synchronized_sink<logging::sinks::text_file_backend>>(
        sink->locked_backend()
    );
    // 替换原有的非线程安全Sink
    logging::core::get()->remove_sink(sink);
    logging::core::get()->add_sink(sync_backend);
    // 保持原有配置（自动刷新）
    sync_backend->locked_backend()->set_auto_flush(true);
}

注意：该方案的性能低于异步Sink，仅适合特殊场景使用。

额外注意事项 #

• 确保RotationSize配置合理，避免频繁滚动日志带来的额外并发压力；
• add_common_attributes()已正确添加TimeStamp等属性，无需额外调整；
• BOOST_LOG_TRIVIAL宏本身是线程安全的，问题仅出在Sink的写入环节，需重点保障Sink的线程安全。

内容的提问来源于stack exchange，提问作者Lorenzo Isidori