启用 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 中混入动态逻辑，才能让这个内核级优化稳定起效。