从零构建现代C++ Web服务器(七):生产级日志系统

从零构建现代C++ Web服务器(七):生产级日志系统 系列导航:第一篇:设计理念 | 第二篇:协程与内存池 | 第三篇:路由与中间件 | 第四篇:实战与调优 | 第五篇:Cookie 与 Session | 第六篇:数据库中间件 | 第七篇:日志系统(本篇) 前置知识 阅读过第三篇的中间件洋葱模型 了解 C++20 std::format、std::jthread 了解日志系统的基本概念(级别、格式化、输出目标) 目录 1. 为什么需要自研日志系统? 2. Phase 1:基础增强——从 fprintf 到 std::format 3. Phase 2:异步后端——从同步到生产级 4. Phase 3:结构化日志与可观测性 5. 性能深度分析 6. 线程安全设计 7. 实战:5 分钟搭建完整日志体系 8. 总结与设计决策表 9. 核心要点 10. 知识图谱 1. 为什么需要自研日志系统? 前六篇把 hical 的核心骨架搭完了:协程 I/O、内存池、路由、中间件、SSL、会话、数据库。唯一的短板是日志——每次排查问题只能翻 stderr,没有文件、没有结构、没有追踪 ID。真正的生产环境里,日志比功能代码重要得多:功能代码决定程序的行为,日志决定你能不能在凌晨三点用最短时间还原那行让服务崩掉的数据路径。 1.1 现有轮子的取舍 先看市面上的主流方案: 库 优点 对 hical 的问题 spdlog 成熟、快(每秒数百万条)、格式丰富 外部依赖;fmt 与 std::format 语义略有差异 glog Google 出品,稳定 C++03 风格 API;宏冗余;不支持 std::format Trantor drogon 自带,协程时代设计 与 drogon 强耦合,无法独立引入 log4cxx 功能完备、配置文件驱动 重量级;Java 移植风格与现代 C++ 格格不入 自研 零依赖、API 与框架深度融合 需要投入设计成本 hical 的核心约束是零外部依赖——整个框架只依赖 Boost 和 OpenSSL,任何新模块都不能打破这条线。spdlog 引入 fmt 库就已经违规,glog 的 API 风格与现代 C++ 割裂,Trantor 无法解耦。 ...

May 1, 2026 · 25 min · 5197 words