open_file_cache_min_uses 是缓存准入门槛，仅当文件在 inactive 时间窗口内被访问≥指定次数才允许进入长期缓存；它与 inactive 配合实现频次筛选，防止临时请求污染缓存，不参与已缓存条目的生命周期管理。
open_file_cache_min_uses 不是“访问次数越多越容易缓存”，而是设一道准入门槛：只有在 inactive 时间窗口内被至少访问指定次数 的文件，才允许进入长期缓存。它本质是过滤机制，防止临时请求污染缓存空间。
作用原理：用频次筛选真实热点
该指令配合 inactive 参数共同工作。例如配置 inactive=60s 和 min_uses=2，意味着：Nginx 会记录每个文件在最近 60 秒内的访问次数；只有当该计数 ≥2，且文件仍处于活跃状态，才会将其纳入缓存并开始受 valid 周期校验；否则即使打开过，也会在 inactive 期满后直接丢弃。
- 避免缓存“一次性文件”（如临时生成的调试页、随机路径的 404 请求）
- 降低因冷文件堆积导致的缓存淘汰压力，提升整体命中率
- 不参与缓存条目生命周期管理，只影响“是否准入”，不影响已入缓存条目的存活时长
典型取值与业务适配
数值并非越大越好，需结合静态资源访问模式调整：
- min_uses=1：等同于取消筛选，所有打开过的文件都可能进缓存——适合极低更新频率、路径高度稳定的文档站或内部系统
- min_uses=2（推荐默认值）：平衡灵敏度与稳定性，能有效捕获真实复用资源（如首页、通用 JS/CSS）
- min_uses=3 或更高：适用于强热点集中场景（如单页应用中仅少数几个 bundle 被高频加载），但可能漏掉部分中频资源
与其他参数的协同逻辑
单独设置 min_uses 无效，必须与 open_file_cache 和 open_file_cache_valid 同时存在才能生效：
-
max决定容量上限，inactive定义观察窗口，min_uses在此窗口内做计数判断 -
valid不校验访问频次，只检查文件是否存在、mtime 是否变化——它保障的是缓存一致性，而非准入资格 -
errors on可让 404/403 错误也参与min_uses计数，避免恶意扫描反复触发系统调用
验证是否真正起效
不能只看配置加载成功，需观察运行态行为：
- 对同一静态资源（如
/app.js）发起两次间隔 strace -e trace=open,stat 观察第二次是否跳过open()和stat() - 对比开启前后
lsof -p $(cat /var/run/nginx.pid) | wc -l的稳定句柄数，下降说明 fd 复用提升 - 通过
nginx_stub_status或 Prometheus 指标查看ngx_http_open_file_cache_misses是否随 min_uses 提高而明显减少
