解决spdlog日志文件中断后追加内容不换行的问题

在使用spdlog日志库时，我们可能会遇到这样一个场景：当应用程序意外崩溃后重新启动时，新的日志内容会直接追加在上次未完整写入的行后面，导致日志格式混乱。本文将深入分析这个问题并提供几种解决方案。

问题现象分析

当应用程序突然崩溃时，可能出现以下情况：

1. 最后一次日志写入操作未完整完成
2. 文件指针停留在某行中间位置
3. 重启应用后，新日志直接从此位置开始写入

这会导致日志文件中出现格式混乱的情况，例如：

[时间戳] [logger名] [级别] 部分日志内容[新的时间戳] [logger名] [级别] 新日志内容

核心解决方案

spdlog提供了file_event_handlers机制，允许我们在文件操作的不同阶段插入自定义处理逻辑。针对这个问题，我们可以使用after_open处理器来确保每次打开日志文件时都以新行开始。

使用file_event_handlers的解决方案

spdlog::file_event_handlers handlers;
handlers.after_open = [](spdlog::filename_t filename, std::FILE* f) {
    // 检查文件是否以换行符结尾
    if (std::fseek(f, -1, SEEK_END) == 0) {
        int last_char = std::fgetc(f);
        if (last_char != '\n') {
            std::fputc('\n', f);
        }
    }
    std::rewind(f);  // 重置文件指针
};

// 创建带有事件处理器的文件sink
auto sink = std::make_shared<spdlog::sinks::basic_file_sink_mt>("logfile.log", true, handlers);
auto logger = std::make_shared<spdlog::logger>("logger_name", sink);

其他备选方案

1. 每次启动时添加分隔行

可以在应用程序启动时，先记录一条特殊的分隔线，如：

logger->info("\n========== 应用程序重启 ==========");

2. 使用rotating logger

配置rotating logger在每次启动时创建新文件：

auto sink = std::make_shared<spdlog::sinks::rotating_file_sink_mt>("logfile.log", 1024*1024, 5);

3. 自定义sink实现

继承spdlog的sink类，重写打开文件时的行为：

class custom_file_sink : public spdlog::sinks::base_sink<std::mutex> {
    // 实现确保新行开始的逻辑
};

最佳实践建议

1. 对于关键生产环境，建议结合使用file_event_handlers和rotating logger
2. 在日志中添加明确的应用程序启动/关闭标记
3. 考虑日志文件大小限制和自动归档策略
4. 对于分布式系统，建议添加实例标识信息

通过以上方法，可以确保即使在应用程序异常重启的情况下，日志文件也能保持良好的可读性和完整性，便于后续的问题排查和分析。