fstream::flush()与fstream::sync()能否保证数据写入磁盘？

我明白你在开发迷你数据库日志模块时遇到的这个关键痛点：用fstream追加日志内容后，调用flush()只能把数据从C++标准库的用户态缓冲区刷到操作系统的文件系统缓冲区，没法保证数据真正写入物理磁盘——这对于需要强持久性的数据库日志来说确实是个大问题。

为什么flush()不够？ #

当缓冲区被刷新时，其中包含的所有数据都会被写入物理介质

其实这句话的表述容易产生误解：flush()只负责清空C++标准库维护的用户空间缓冲区，把数据传递给操作系统。但操作系统为了提升IO性能，会把这些数据暂存在内核的页缓存（page cache）里，等到合适的时机（比如缓存满了、系统空闲时）再批量写入磁盘，这就是所谓的“延迟写”策略。

如何强制数据写入磁盘？ #

要真正让数据落到物理磁盘，需要调用操作系统提供的同步API，在这之前别忘了先调用flush()把C++层的数据递交给内核。下面是不同平台的实现方案：

Linux/Unix 平台

使用fsync()系统调用，它会强制将指定文件的内核缓冲区数据写入磁盘：

#include <fstream>
#include <unistd.h> // 包含fsync的头文件

void write_log_and_sync(const std::string& message) {
    std::ofstream log_file("db.log", std::ios::app | std::ios::out);
    if (!log_file.is_open()) {
        // 处理文件打开失败的情况
        return;
    }
    log_file << message << std::endl;
    log_file.flush(); // 先刷到内核缓冲区
    // 获取文件描述符（GCC/Clang支持，不同编译器可能有差异）
    int fd = log_file.rdbuf()->fd();
    fsync(fd); // 强制内核写入物理磁盘
}

Windows 平台

使用FlushFileBuffers()API，功能和fsync()类似：

#include <fstream>
#include <windows.h>
#include <io.h> // 包含_get_osfhandle的头文件

void write_log_and_sync(const std::string& message) {
    std::ofstream log_file("db.log", std::ios::app | std::ios::out);
    if (!log_file.is_open()) {
        // 处理文件打开失败的情况
        return;
    }
    log_file << message << std::endl;
    log_file.flush(); // 先刷到内核缓冲区
    // 获取Windows文件句柄
    HANDLE file_handle = reinterpret_cast<HANDLE>(_get_osfhandle(log_file.rdbuf()->fd()));
    FlushFileBuffers(file_handle); // 强制写入物理磁盘
}

跨平台封装思路

如果你的数据库需要跨平台运行，可以通过预编译指令封装统一的同步函数：

#include <fstream>

#ifdef _WIN32
#include <windows.h>
#include <io.h>
#else
#include <unistd.h>
#endif

void sync_file_to_disk(std::ofstream& file) {
    file.flush();
#ifdef _WIN32
    HANDLE handle = reinterpret_cast<HANDLE>(_get_osfhandle(file.rdbuf()->fd()));
    FlushFileBuffers(handle);
#else
    fsync(file.rdbuf()->fd());
#endif
}

注意事项 #

• 频繁调用磁盘同步API会严重降低程序性能，因为磁盘IO的速度远慢于内存操作。数据库通常会采用批量刷盘（比如积累N条日志再同步）或者仅在关键操作（如事务提交）时强制同步的策略，平衡数据安全性和性能。
• 部分文件系统支持O_DIRECT标志，可以绕过内核页缓存直接写入磁盘，但使用起来需要注意对齐等细节，复杂度较高，一般不推荐在日志模块中直接使用。

内容的提问来源于stack exchange，提问作者梁宇坤