c++oding="utf-8" ?>
std::flush 不保证数据落盘,仅清空流缓冲区至内核 page cache;关键日志需调用 fsync(linux/macos)或 flushfilebuffers(windows)才能持久化。

std::flush 不等于 fsync,别以为调用它就安全了
直接说结论:std::flush 只把缓冲区数据推到操作系统内核的 page cache,**不触发磁盘写入**。关键日志(比如崩溃前最后一行、支付成功标记)可能还在内存里,断电或进程被杀就丢了。
真正落盘需要 fsync(Linux/macOS)或 FlushFileBuffers(Windows),而 C++ 标准库没提供跨平台封装——你得自己桥接。
-
std::ofstream的.flush()或操作符仅清空 streambuf 缓冲,和底层文件系统无关 - 频繁
fsync会显著拖慢性能(尤其机械盘/远程文件系统),不是所有日志都值得 - 如果用
std::ios_base::out | std::ios_base::app模式打开文件,std::flush后 append 位置仍由内核维护,但 fsync 才保证该次 write 的数据持久化
怎么在 C++ 日志流中插入 fsync(Linux/macOS)
最简方案:拿到 std::ofstream 底层文件描述符,再调用 fsync。注意必须确保流已刷新(否则内核缓存里还没那批数据)。
#include <fstream>
#include <unistd.h>
#include <sys>
std::ofstream log_file("app.log", std::ios::out | std::ios::app);
void safe_log(const std::string& msg) {
log_file
<ul>
<li>
<code>fileno()</code> 是 POSIX 扩展,<code>std::ofstream</code> 本身不暴露 fd,需依赖具体 STL 实现(libstdc++/libc++ 支持,MSVC 不支持)</li>
<li>如果编译报错 <code>'fileno' is not a member of 'std::basic_ofstream'</code>,说明当前 STL 不提供该接口,得换方案</li>
<li>不要在每次日志后都 <code>fsync</code>——只对 <code>CRITICAL</code> / <code>ERROR</code> 级别或事务边界日志做</li>
</ul>
<h3>Windows 下等效替代:FlushFileBuffers + _get_osfhandle</h3>
<p>Windows 没有 <code>fileno</code>,但可以用 <code>_get_osfhandle</code> 把 C 运行时文件句柄转为 Windows HANDLE,再调 <code>FlushFileBuffers</code>。</p>
<pre class="brush:php;toolbar:false;">#ifdef _WIN32
#include <io.h>
#include <windows.h>
void win_safe_flush(std::ofstream& ofs) {
ofs.flush();
auto c_fd = _fileno(ofs.rdbuf()->pubsync()); // 先同步流缓冲
auto h = reinterpret_cast<handle>(_get_osfhandle(c_fd));
if (h != INVALID_HANDLE_VALUE) FlushFileBuffers(h);
}
#endif</handle></windows.h></io.h>
-
_fileno和_get_osfhandle是 MSVC 特有,GCC/Clang on Windows(如 MinGW)可能不支持 - 必须检查
INVALID_HANDLE_VALUE,否则FlushFileBuffers会失败并污染 GetLastError - 如果项目要跨平台,建议封装一层抽象:Linux 走
fsync,Windows 走FlushFileBuffers,其他平台降级为std::flush
更稳妥的做法:绕过 iostream,用低级 I/O 控制 flush 粒度
如果你真需要每条关键日志 100% 落盘,不如放弃 std::ofstream,改用 write() + fsync() 组合。好处是控制明确、无中间缓冲干扰、可设 O_SYNC 标志。
#include <fcntl.h>
#include <unistd.h>
#include <string>
int log_fd = open("app.log", O_WRONLY | O_APPEND | O_CREAT | O_SYNC, 0644);
// O_SYNC 表示每次 write 自动 fsync(性能差但语义强)
void critical_log(const std::string& msg) {
write(log_fd, msg.c_str(), msg.size());
write(log_fd, "\n", 1);
// 不用额外 fsync —— O_SYNC 已保证
}</string></unistd.h></fcntl.h>
-
O_SYNC会让每次write阻塞直到磁盘确认,吞吐量可能降到 1/10,只适合低频关键日志 - 记得
close(log_fd),且多线程写需自行加锁(std::ofstream内部锁不覆盖write) - 如果日志量大又要求可靠性,考虑用成熟的日志库(如 spdlog 的
file_sink_mt配flush_on+ 手动fsync回调)
真正难的不是调哪个函数,而是判断哪条日志值得付出 fsync 的代价——写错地方,既丢数据又拖慢整个服务。
C++免费学习笔记(深入):立即使用
在学习笔记中,你将探索 C++ 的入门与实战技巧!











