O_DIRECT打开文件返回EINVAL的根本原因是未满足对齐约束：文件偏移、内存缓冲区地址、读写长度三者都必须是512字节（或文件系统逻辑块大小）的整数倍。
Linux 下用 O_DIRECT 标记打开文件时为什么总返回 EINVAL
根本原因是没满足对齐约束：文件偏移、内存缓冲区地址、读写长度三者都必须是 512 字节（或文件系统逻辑块大小）的整数倍。常见错误是直接用 new uint8_t[buf_size] 分配内存——这无法保证地址对齐。
实操建议：
- 用
posix_memalign(&buf, 4096, size)分配缓冲区，4096 是安全的最小对齐值（多数文件系统支持） - 检查文件系统块大小：
stat -f /path/to/file | grep "I/O Block"，优先按它对齐 - 打开文件时必须同时指定
O_DIRECT | O_RDWR（只读/只写也需对应），且不能和O_APPEND共存 - 若用
openat()或通过/proc/self/fd/复制 fd，新 fd 不继承O_DIRECT，需重新设置
read() 和 pread() 在 Direct IO 下的行为差异
read() 依赖文件当前 offset，而 Direct IO 模式下该 offset 本身也必须对齐；一旦上次读写未对齐，下次 read() 就会失败。实际大文件顺序读写中，pread() 更可靠——它显式传入 offset，便于做对齐校验和跳过坏扇区。
关键点：
-
pread(fd, buf, count, offset)的offset必须是 512 的倍数，否则返回EINVAL -
read()的内部 offset 更新后，若未对齐，后续调用直接失败，不会自动修正 - 用
lseek(fd, pos, SEEK_SET)设置 offset 后再read()，同样要确保pos对齐，否则read()仍报错
为什么 write() 成功但数据没落盘，且 fsync() 无效
O_DIRECT 本身绕过 page cache，但不绕过设备层缓存（如硬盘/SSD 自身的 write-back cache）。fsync() 只保证内核提交请求到设备驱动，并不强制设备刷写自身缓存。尤其在断电场景下，极易丢数据。
解决方案分两层：
- 写完后调用
ioctl(fd, BLKFLSBUF)（需 root 权限）清块设备缓存——仅对块设备有效，对普通文件无效 - 更通用做法：打开文件时加
O_SYNC（但会严重拖慢性能），或用ioctl(fd, HDIO_DRIVE_CMD, ...)发送 FLUSH CACHE 命令（需设备支持 ATA/SATA） - 生产环境强烈建议关闭磁盘 write-cache：
hdparm -W0 /dev/sdX，否则任何用户态同步调用都不可靠
C++ RAII 封装 O_DIRECT 文件句柄时最容易漏掉的清理动作
除了 close()，必须显式释放对齐内存——free()，不是 delete[]。用智能指针时不能直接绑定 delete[]，得自定义 deleter。
示例片段：
struct direct_deleter {
void operator()(void* p) { free(p); }
};
using direct_buf = std::unique_ptr<uint8_t direct_deleter>;
direct_buf buf;
posix_memalign(buf.reset(), 4096, size);
</uint8_t>
另一个常被忽略的是：Direct IO 文件描述符不能用于 mmap()，否则 mmap() 失败并设 errno=ENODEV。如果封装类里偷偷做了 mmap 尝试（比如日志模块自动 fallback），就会静默出错。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
