sendfile与directio互斥,因前者依赖page cache实现零拷贝,后者通过o_direct绕过缓存直接读盘;nginx自0.7.15起强制禁用共存,启用directio时sendfile自动失效。

sendfile 和 directio 不能同时启用,它们是互斥机制,不是协同关系。理解这一点是配置不翻车的关键。
为什么不能共存
directio 的本质是绕过内核页缓存(page cache),用 O_DIRECT 标志直接读盘;而 sendfile 依赖页缓存——它从 page cache 中把数据零拷贝送入 socket 缓冲区。两者目标相反:一个要缓存,一个要跳过缓存。Nginx 在检测到 directio 启用时,会自动禁用 sendfile(从 0.7.15 版起强制如此)。
- 启 directio 4m 后,Nginx 日志中会出现 “sendfile is disabled when directio is used”
- 若手动写 sendfile on; 与 directio 4m; 共存,后者生效,前者被忽略
- 强行“共存”不会加速,反而可能因逻辑冲突导致大文件传输失败或退化为阻塞读
怎么选:按文件大小和访问模式分治
核心原则是“小文件走缓存,大文件绕缓存”,不是一刀切。
- ≤ 4MB 的静态资源(HTML/CSS/JS/图片等):启用 sendfile on;,配合 open_file_cache,让高频小文件命中 page cache + 零拷贝,CPU 和延迟双降
- ≥ 4MB 的顺序读大文件(视频、安装包、ISO):关闭 sendfile,启用 directio 4m; aio on; output_buffers 1 128k;,避免把几 GB 内容塞进 page cache 污染内存
- 混合场景建议用 location 分离:/static/ 下走 sendfile,/dl/ 或 /video/ 下走 directio
大文件场景下真正有效的组合
当必须服务大文件且需规避 I/O 阻塞时,正确路径是:
- 关 sendfile(显式写 sendfile off; 更清晰)
- 开 directio 4m;(对齐 XFS 建议设 directio_alignment 4k;)
- 配 aio on;(Linux 下需确保内核支持,且 nginx 编译含 --with-file-aio)
- 加 thread_pool(如主线程仍需同步读 gzip_static 或 proxy_cache 未命中)
- 验证方式:error_log 设为 debug 级,grep “aio thread”;同时 top -H 观察 worker 进程 S 态占比是否稳定低于 5%
常见误配与后果
这些配置看似“加强性能”,实则自废武功:
- location / { sendfile on; directio 4m; } → sendfile 被静默关闭,但未配 aio,大文件退化为阻塞 read()
- 对小文件启 directio → 每次都落盘,完全失去缓存收益,QPS 断崖下跌
- 只开 aio on; 却没关 sendfile → aio 不生效(Nginx 文档明确:aio 与 sendfile 互斥)
- directio 后没调 output_buffers → 默认 32k 缓冲太小,频繁系统调用,吞吐上不去











