open_file_cache_min_uses 的核心作用是设置文件路径进入缓存的访问次数门槛，防止低频路径挤占缓存；默认值1导致爬虫、调试路径等单次访问即入缓存又快速淘汰，引发句柄抖动和系统开销；设为2配合inactive=60s可过滤冷数据、提升缓存健康度。
open_file_cache_min_uses 的核心作用，是给文件句柄缓存加一道“热度门槛”——它不阻止 Nginx 处理请求，而是让低频、试探性或一次性的文件路径根本进不了缓存，从而从源头防止冷数据挤占内存和引发句柄抖动。
为什么冷数据会破坏缓存健康？
当 min_uses 设为默认值 1 时，以下路径只要被访问一次，就会立刻进入缓存：
- 爬虫扫描的随机路径（如
/test.php?r=abc123） - 前端构建预览页（如
/dist/app.js?v=build-001） - 调试时拼错的 URL（如
/sttic/style.css） - 带时间戳的日志上报（如
/log?t=1746216840） - 临时上传预览地址（如
/upload/temp_xyz.jpg）
这些文件往往只被访问 1 次，但因满足 min_uses=1 而强行入缓存；又因 inactive 时间一到无人再访，立即被淘汰。结果就是：缓存频繁“进—等淘汰—再进”，造成 lsof 中 fd 数量剧烈波动、stat() 和 open() 系统调用激增、CPU 和磁盘 I/O 白耗。
设为 2 是最实用的平衡点
将 open_file_cache_min_uses 2 配合 inactive=60s 使用，意味着：同一路径必须在连续 60 秒内被成功访问 ≥2 次，才允许缓存其句柄与元数据。
- 单次探测、误输路径、CI 预览等行为自动被过滤
- 真实高频资源（如
/index.html、/favicon.ico、/static/main.abc123.js）自然满足条件并稳定驻留 - 实测可降低无效缓存条目 50% 以上，显著减少句柄重建开销
必须搭配 inactive 才能生效
min_uses 单独设置毫无意义，它完全依赖 inactive 定义的时间窗口来计数。常见匹配建议：
- 健康检查路径（如
/healthz每 5 秒一次）→inactive=15s; min_uses=2 - 首屏静态资源集中加载（JS/CSS/字体）→
inactive=60s; min_uses=2 - 灰度发布频繁的前端产物 →
inactive=120s; min_uses=3，避免新旧 hash 文件交替污染 - 小内存容器或边缘节点 → 可设
min_uses=3，宁可少缓存，也不让冷数据抢资源
注意几个关键细节
该参数只对**完整路径字符串**计数，不解析 query 参数：
-
/a.js?v=1和/a.js?v=2视为两个不同路径，各自独立计数 - 若开启
open_file_cache_errors on，404/403 错误也参与计数 —— 连续两次请求不存在的/debug/test.html，也会被缓存“文件不存在”结果 - 即使未达阈值，Nginx 仍会执行
stat()和open()，只是不把结果存进缓存 - 它只缓存句柄和元数据（大小、修改时间、权限等），不缓存文件内容
