C++如何实现一个高效的日志翻滚(Log Rotation)

秋强小哥_2716

秋强小哥_2716

2026-07-18

687人浏览

原创

核心是每次写日志前检查文件大小是否超限,超限时先关闭当前文件、倒序重命名旧文件(如.log→.1、.1→.2)、再新建空白日志文件,全程需互斥锁保障多线程安全。

c++如何实现一个高效的日志翻滚(log rotation)

日志文件达到大小阈值后如何自动切分

核心是判断当前日志文件是否超过设定上限,再重命名旧文件、新建空白日志。关键不在“写”,而在“切”——fopen 用 "a" 模式打开时,不能直接 rename 当前正在写入的文件(Windows 下会失败,Linux 虽允许但有风险)。正确做法是:先 close 当前 FILE*,再 rename,最后用 fopen(..., "w") 新建。

常见错误是边写边 rename,导致部分日志丢失或 EBUSY 错误。建议封装一个 rotate_if_needed() 函数,在每次写日志前检查:

if (current_size > max_size) {
    fclose(log_fp);
    rename("app.log", "app.log.1");
    log_fp = fopen("app.log", "w");
    current_size = 0;
}

注意:rename() 不是原子操作,若进程崩溃在 rename 后、fopen 前,下次启动会丢失日志;生产环境建议加临时标记文件或使用 link()+unlink() 组合提升可靠性。

如何限制保留最多 N 个历史日志文件

翻滚时要清理过期备份,否则磁盘迟早打满。典型策略是:把 app.log.N 逐级递增,从最大编号开始删,再整体 +1,最后生成新 .1。比如保留 3 个备份,现有 app.log.1、app.log.2,则先删 app.log.3(如果存在),再把 .2 → .3,.1 → .2,最后 app.log → .1。

容易踩的坑:

  • 用 std::filesystem::remove_all() 删除 app.log.* 通配 —— C++20 前不支持 glob,必须手动枚举
  • 按字符串排序 app.log.10 会排在 app.log.2 前面 —— 要提取数字后按整数比较
  • 并发多进程写同一日志时,清理逻辑可能冲突 —— 单进程日志才适用此方案

简单实现可用 std::filesystem::directory_iterator 遍历当前目录,匹配 app.log.\d+ 正则(C++11 起支持),收集编号后排序处理。

时间驱动的翻滚(如每天零点新建日志)怎么安全触发

靠定时检查系统时间最稳妥,不要依赖 cron 或外部信号——C++ 进程自己得掌握节奏。每写一条日志都调用 time(nullptr) 开销小,但更高效的是记录上次翻滚时间戳,只在秒级变化时检查是否跨天。

C++14
C++14

C++14 对 C++11 的修正与增强版本,适合旧系统维护和较老工具链兼容。

下载

关键点:

  • 用 localtime_r()(POSIX)或 localtime_s()(Windows)避免 localtime() 的线程不安全
  • 比较 tm.tm_mday 是否变化,而不是直接格式化字符串再 strcmp —— 避免时区切换导致误判
  • 时间翻滚和大小翻滚可能同时发生,需确保二者互斥:比如先检查时间,再检查大小,且翻滚后重置两个状态

示例逻辑:

auto now = time(nullptr);
tm t;
#ifdef _WIN32
    localtime_s(&t, &now);
#else
    localtime_r(&now, &t);
#endif
if (t.tm_mday != last_rotate_day) {
    // 执行翻滚...
    last_rotate_day = t.tm_mday;
}

多线程环境下写日志时如何避免 rotate 冲突

rotate 操作涉及 close/rename/fopen 三步,必须原子化;而日志写入是高频操作。最轻量的解法是用一个 std::mutex 护住整个日志写入路径(包括 rotate 判断和实际 write),但会成为性能瓶颈。

更实用的做法是分离关注点:

  • 写日志只操作内存 buffer(std::string 或 lock-free ring buffer)
  • 单独一个日志 flush 线程,定期(或 buffer 满时)持有 mutex 将 buffer 写入文件,并在此时做 rotate 判断
  • rotate 完成后更新全局 FILE* 指针,flush 线程后续写入新文件

注意:FILE* 是线程安全的(C 标准保证 fwrite 等函数内部加锁),但你不能假设它对 rename/fopen 这类操作也安全——所以 FILE* 的替换必须在临界区内完成,且所有写线程必须重新读取该指针(声明为 std::atomic<file></file> 或加 memory barrier)。

别忽略 SIGPIPE 或磁盘满时 fwrite 返回值为 0 的情况——此时应立即触发 rotate 并重试,否则日志静默丢失。

C++免费学习笔记(深入):立即使用
在学习笔记中,你将探索 C++ 的入门与实战技巧!

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

c++

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
c++和c语言的区别有哪些
c++和c语言的区别有哪些

c++和c语言的区别:1、面向对象编程(OOP)支持不同;2、新增特性不同;3、标准库不同;4、编译方式不同;5、命名空间不同等等。想了解更多c++的相关内容,可以阅读本专题下面的文章。

2024.03.14

2248

9

c++和python学习顺序推荐
c++和python学习顺序推荐

一般建议先学习C++,再学习Python,因为这样可以逐步从较为底层的编程语言向更高级的语言过渡。想了解更多python的相关内容,可以阅读本专题下面的文章。

2024.03.14

1019

6

python和c++学习性价比分析
python和c++学习性价比分析

Python易于学习,广泛应用于Web开发、数据科学和人工智能等领域,但性能较低。C语言性能高,适用于对性能要求较高的场景,如游戏开发和系统编程,但学习曲线陡峭,错误处理复杂。想了解更多python的相关内容,可以阅读本专题下面的文章。

2024.03.14

447

5

c语言和c++一样吗
c语言和c++一样吗

c语言和c++是两种不同的编程语言,虽然有相似之处,但存在显著差异。c语言专注于过程式编程和系统级开发,以简洁、高效著称。c++作为c语言的超集,引入了面向对象编程,增强了代码组织和管理能力,但学习曲线也更陡峭。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.03.14

327

5

c语言和c++先学哪个好
c语言和c++先学哪个好

初学者选择学习c语言还是c++语言,需要根据个人学习目标、背景以及编程兴趣和预期应用方向来决定。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.03.14

426

5

c语言和c++的区别和联系
c语言和c++的区别和联系

c语言和c++是计算机科学领域应用广泛的编程语言。虽然它们有着相似的基础,但它们在语言类型、语法功能和内存管理方面存在着显著差异。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.03.14

580

5

c++软件中文更改教程
c++软件中文更改教程

对于 ide,可通过打开设置,找到语言设置,选择中文,并保存更改。对于非 ide 应用程序,可查找设置或选项,选择语言设置,更改为中文,并保存更改。想了解更多c++的相关内容,可以阅读本专题下面的文章。

2024.03.21

1409

9

python和java和c++学习性价比分析
python和java和c++学习性价比分析

Python以其易学性、丰富的库和活跃的社区而著称,适合数据科学、人工智能和Web开发。Java以其跨平台性、企业级应用开发和Android应用开发而闻名。C++以其底层控制能力、高效性能和游戏开发而著称。选择哪种语言取决于个人兴趣、职业方向和特定需求。想了解更多python和java和c++的相关内容,可以阅读本专题下面的文章。

2024.03.22

1217

7

c++和c语言学习顺序推荐
c++和c语言学习顺序推荐

对于初学者,建议先学习C语言,掌握编程基础后再转入C++,便于理解面向对象编程概念。有编程经验者可直接学习C++,快速接触高级编程技术。想了解更多c++和c语言的相关内容,可以阅读本专题下面的文章。

2024.03.25

1325

9

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
C++ Core Guidelines
C++ Core Guidelines

共0课时 | 0人学习

C++ Reference
C++ Reference

共0课时 | 0人学习

C++ 官方标准说明
C++ 官方标准说明

共0课时 | 0人学习