open_file_cache需在http或server块中成组配置四条指令才生效,仅缓存文件描述符和元数据以跳过stat()和open()调用;缺一不可,且须配合系统级优化如ulimit和noatime。

直接在 http 块 或 server 块 中配齐四条指令,open_file_cache 才真正生效;它不缓存文件内容,只缓存文件描述符(fd)和元数据(如大小、修改时间、存在性、权限),从而跳过每次请求都要执行的 stat() 和 open() 系统调用。
必须成组配置的四条核心指令
缺一不可,单独写任何一条(比如只写 open_file_cache max=5000 inactive=60s;)都无效:
- open_file_cache max=5000 inactive=60s;:启用缓存,最多存 5000 个条目;60 秒内未被访问的条目标记为非活跃,等待清理
- open_file_cache_valid 30s;:每 30 秒主动校验一次缓存项,检查文件是否被删、改名或权限变化
- open_file_cache_min_uses 2;:同一路径在 60 秒内至少被访问 2 次,才允许进入长效缓存,防爬虫或误扫占位
- open_file_cache_errors on;:把 404、403 等错误结果也缓存,避免反复试探无效路径
推荐放的位置和生效范围
放在 http { ... } 块中,全局生效;也可放在某个 server { ... } 块内,仅对该虚拟主机生效。它对所有通过 root、alias、try_files 等方式映射到真实磁盘文件的静态响应起作用,例如:
-
location /static/ { root /var/www; }→ 缓存/var/www/static/logo.png -
location = /health { alias /opt/conf/health.html; }→ 缓存该 HTML 文件
不适用于 proxy_pass、fastcgi_pass 等动态转发场景。
按需关闭的灵活控制
某些目录不适合缓存,可在对应 location 块中显式关闭:
- 上传临时目录:
location /upload/tmp/ { open_file_cache off; } - 频繁热更新资源:
location ~ \.js$ { open_file_cache off; }(依赖浏览器缓存或 CDN 更合适) - 敏感配置文件(如证书):
location /ssl/ { open_file_cache_valid 10s; },缩短校验周期以便快速感知变更
配套系统级设置不能少
光靠 Nginx 配置不够,还需同步优化底层支撑:
- 确认系统文件描述符上限足够:
ulimit -n建议 ≥ 65535,并在http块中加worker_rlimit_nofile 65535; - 挂载磁盘时添加
noatime参数,避免读取时更新访问时间(atime)引发额外 I/O - 用日志变量监控效果:
$open_file_cache_hits和$open_file_cache_misses可统计命中率,持续调优











