nginx 的 open_file_cache 通过缓存文件描述符和元数据减少系统调用开销，需配合 open_file_cache_valid、min_uses 和 errors 等指令使用，配置示例为 max=2000 inactive=30s、valid 60s、min_uses 2、errors on，须置于 http 或 server 块中。
在 Nginx 中启用 open_file_cache 可以显著减少重复打开文件的系统调用开销，尤其在静态资源（如 CSS、JS、图片）频繁访问的场景下，能降低磁盘 I/O 和 CPU 使用率。它缓存的是文件描述符（fd）、文件元数据（大小、修改时间、是否存在等），而非文件内容本身。
核心配置项与作用
open_file_cache 是一个复合指令，需配合多个子指令协同工作，单独使用无效：
-
open_file_cache：启用缓存并设置最大条目数和非活动超时时间，例如
open_file_cache max=1000 inactive=20s; - open_file_cache_valid：定义缓存项的校验周期，比如每 60 秒检查一次文件是否仍存在、是否被修改
-
open_file_cache_min_uses：仅当文件在
inactive时间内被访问至少指定次数，才保留在缓存中（避免临时热点污染缓存） - open_file_cache_errors：是否缓存文件不存在或权限拒绝等错误结果（默认关闭，开启后可减轻对缺失资源的重复系统调用）
典型安全且高效的配置示例
以下配置适用于大多数静态服务场景，兼顾性能与内存占用：
open_file_cache max=2000 inactive=30s; open_file_cache_valid 60s; open_file_cache_min_uses 2; open_file_cache_errors on;
说明：
– 最多缓存 2000 个文件描述符；
– 若某文件 30 秒内无任何访问，则标记为非活跃，等待下次校验时清理；
– 每 60 秒主动验证缓存中文件的状态（存在性、mtime）；
– 只有被访问 ≥2 次的文件才进入长期缓存；
– 缓存 ENOENT 或 EACCES 错误，避免反复尝试读取缺失或无权访问的路径。
生效位置与注意事项
open_file_cache 必须放在 http 或 server 块中，不能在 location 内设置。它影响所有匹配到的静态文件响应（包括 try_files、alias、root 等路径解析后的实际文件）。
注意点：
– 修改后需 nginx -t && nginx -s reload 生效，缓存不会立即清空；
– 缓存不跟踪符号链接目标变化，若源文件被替换（如 ln -sf 新版本），需依赖 open_file_cache_valid 的校验机制发现变更；
– 高并发小文件场景下，过大的 max 值可能增加内存占用（每个条目约 100–200 字节），建议按 lsof -p $(pgrep nginx) | wc -l 观察实际 fd 使用量来调整。
验证缓存是否起效
可通过 Nginx 内置状态模块（需编译含 --with-http_stub_status_module）或系统级观测判断：
- 启用
stub_status后访问/nginx_status，观察Active connections与Reading/Writing/Waiting变化趋势，间接反映 I/O 压力下降 - 用
strace -p $(pgrep nginx) -e trace=openat,stat,fstat对比启停缓存前的系统调用频次 - 检查
nginx -V 2>&1 | grep -o with-http-stub-status-module确认模块可用
