如何配置Boost.Log的text_file_backend实现追加与滚动？

看起来你现在的问题是每次启动程序都会生成新的日志文件（App.log、App.log00000等），而不是追加到现有文件并按规则滚动。我来帮你调整配置，实现你想要的效果。

核心问题分析 #

你当前的配置缺少了追加模式的显式设置和滚动策略的完整配置，同时可能没有让日志库正确识别已有的归档文件序号，导致每次启动都重新生成序号文件。

修改后的完整配置示例 #

下面是调整后的代码，我会逐个解释关键参数的作用：

#include <boost/log/sinks/text_file_backend.hpp>
#include <boost/log/utility/setup/file.hpp>
#include <boost/log/sinks/file/scan_method.hpp>

// ... 其他必要的头文件

void init_logging() {
    boost::log::add_file_log(
        boost::log::keywords::auto_flush = true,
        // 归档文件的存储目录（滚动后的旧文件会放到这里）
        boost::log::keywords::target = "Log",
        // 当前正在写入的主日志文件路径
        boost::log::keywords::file_name = "App.log",
        // 单个日志文件达到10MB时触发滚动（可根据需求调整）
        boost::log::keywords::rotation_size = 10 * 1024 * 1024,
        // 最多保留5个归档文件，超过会自动删除最旧的
        boost::log::keywords::max_files = 5,
        // 归档文件的命名格式：%5N表示5位递增序号（00000、00001...）
        boost::log::keywords::rotation_file_name = "Log/App.log%5N",
        // 打开模式：追加到现有文件，而不是截断或新建
        boost::log::keywords::open_mode = std::ios::out | std::ios::app,
        // 启动时扫描target目录的归档文件，获取正确的下一个序号
        boost::log::keywords::scan_method = boost::log::sinks::file::scan_matching
    );
}

关键参数详解 #

• open_mode = std::ios::out | std::ios::app：这是实现追加的核心，告诉日志库打开主文件时直接追加到末尾，而不是默认的截断或创建新文件。
• rotation_size：设置单个日志文件的最大容量，达到这个值就会触发滚动——将当前主文件重命名为归档文件，然后创建新的主文件继续写入。
• max_files：限制归档文件的数量，避免磁盘被日志占满，超过数量后会自动删除最旧的归档文件。
• rotation_file_name：定义归档文件的命名规则，%5N会生成5位数字的序号，保证归档文件不会重名。
• scan_method = scan_matching：启动时自动扫描target目录下的归档文件，找到最大的序号，后续滚动时从这个序号继续递增，避免每次启动都从0开始生成重复的序号文件。

可选：按时间滚动的配置 #

如果你想按时间（比如每天）滚动日志，而不是按文件大小，可以替换rotation_size为时间滚动参数：

// 每天午夜0点触发滚动
boost::log::keywords::time_based_rotation = boost::log::sinks::file::rotation_at_time_point(0, 0, 0),
// 归档文件按日期命名（例如：App_20240520.log）
boost::log::keywords::rotation_file_name = "Log/App_%Y%m%d.log"

这样每天午夜会自动将当前的App.log归档为带日期的文件，然后创建新的App.log继续追加写入。

注意事项 #

• 确保Log目录存在，否则日志库会尝试创建它，如果创建失败可能会导致日志无法写入。
• 如果之前已经生成了很多无序的归档文件，建议先清理Log目录，让新的配置从正确的序号开始。

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