启用 sendfile 可提升 React 静态资源传输性能，需确保配置为 on、搭配 tcp_nopush、避免与 gzip 或 proxy_buffering 冲突，并验证其实际生效。
在 Nginx 上托管 React 应用时，启用 sendfile 是提升静态资源（如 JS、CSS、HTML）传输性能的底层优化手段。它让内核直接在磁盘和网络套接字之间传递文件数据，绕过用户态内存拷贝，显著降低 CPU 和内存开销。
确认 sendfile 已启用且配置合理
Nginx 默认开启 sendfile on，但需检查实际配置是否被覆盖或禁用：
- 在
http、server或location块中搜索sendfile，确保未设为off - 推荐搭配
tcp_nopush on（在server或http块中），使 Nginx 在发送完整响应时才推送 TCP 包，提升大文件传输效率 - 避免与
proxy_buffering off或gzip on在同一 location 中混用 ——sendfile不支持压缩流或代理缓冲关闭场景下的直接传输
React 构建产物需正确匹配 Nginx 静态服务路径
sendfile 只对真实存在的磁盘文件生效。若 React 应用使用 create-react-app 构建，需确保：
-
build目录被 Nginx 的root指向（例如root /var/www/my-react-app;） -
index.html能被直接访问，且所有静态资源路径（如/static/js/main.xxxx.js）在文件系统中存在对应物理路径 - 使用
react-router的 BrowserRouter 时，需配置try_files $uri $uri/ /index.html;，该指令本身不干扰sendfile，因最终命中/index.html仍走文件读取
验证 sendfile 是否实际生效
仅靠配置开启不能保证运行时生效。可通过以下方式确认：
- 用
curl -I http://your-domain/static/js/main.xxxx.js查看响应头，若含X-Accel-Buffering: no（部分发行版添加）或无明显代理转发痕迹，说明可能启用了零拷贝 - 更可靠的方式是使用
strace跟踪 Nginx worker 进程：strace -e trace=sendfile64 -p $(pgrep nginx)，请求静态资源后观察是否出现sendfile64(系统调用 - 对比开启/关闭
sendfile后的 CPU 使用率（如top中%CPU）和 QPS 变化，尤其在高并发小文件场景下差异明显
注意 sendfile 的边界情况
某些常见操作会自动禁用 sendfile，即使配置为 on：
- 启用
gzip on且请求头含Accept-Encoding: gzip：Nginx 必须解压再压缩，无法直传 - 使用
add_header添加动态响应头（如Set-Cookie）且作用于静态文件 location：部分版本会回退到常规 read/write 流程 - 文件位于 NFS 或其他非本地 ext4/xfs 文件系统：某些内核版本不支持跨文件系统 sendfile，Nginx 会静默降级
- React 的
public目录中包含符号链接：默认情况下sendfile不处理 symlink，需配合disable_symlinks off;（慎用，有安全风险）
不复杂但容易忽略：真正发挥 sendfile 效能的前提，是让请求精准落在真实静态文件上，而不是被重写、代理或动态处理截断。React 托管场景下，保持构建路径清晰、Nginx 路由简洁、避免在静态资源 location 中混入动态逻辑，才能让这个内核级优化稳定起效。
