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()或操作符<< std::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/stat.h>
std::ofstream log_file("app.log", std::ios::out | std::ios::app);
void safe_log(const std::string& msg) {
log_file << msg << "\n";
log_file.flush(); // 先刷到内核 page cache
auto fd = log_file.fileno(); // 非标准,但 GCC/Clang 支持;MSVC 不可用
if (fd != -1) fsync(fd); // 真正落盘
}
-
fileno()是 POSIX 扩展,std::ofstream本身不暴露 fd,需依赖具体 STL 实现(libstdc++/libc++ 支持,MSVC 不支持) - 如果编译报错
'fileno' is not a member of 'std::basic_ofstream',说明当前 STL 不提供该接口,得换方案 - 不要在每次日志后都
fsync——只对CRITICAL/ERROR级别或事务边界日志做
Windows 下等效替代:FlushFileBuffers + _get_osfhandle
Windows 没有 fileno,但可以用 _get_osfhandle 把 C 运行时文件句柄转为 Windows HANDLE,再调 FlushFileBuffers。
立即学习“C++免费学习笔记(深入)”;
#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
-
_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 已保证
}
-
O_SYNC会让每次write阻塞直到磁盘确认,吞吐量可能降到 1/10,只适合低频关键日志 - 记得
close(log_fd),且多线程写需自行加锁(std::ofstream内部锁不覆盖write) - 如果日志量大又要求可靠性,考虑用成熟的日志库(如 spdlog 的
file_sink_mt配flush_on+ 手动fsync回调)
真正难的不是调哪个函数,而是判断哪条日志值得付出 fsync 的代价——写错地方,既丢数据又拖慢整个服务。



















