proxy_cache_min_uses是控制请求达指定次数后才写入缓存的关键指令，默认1次，设为2及以上可过滤低频请求、提升缓存热度；它不影响缓存查找，仅控制写入，需结合proxy_cache_lock等使用。
要让 Nginx 缓存真正“热”起来，光靠 proxy_cache 和 proxy_cache_valid 不够——proxy_cache_min_uses 是关键开关。它控制一个请求需被重复访问多少次后，才被正式写入缓存，避免低频请求污染缓存空间。
什么是 proxy_cache_min_uses？
该指令定义：同一个 URI（不区分查询参数，除非开启 proxy_cache_key 自定义）在单位时间内被请求的最小次数，达到后才会触发缓存存储。默认值是 1，即首次请求就缓存；设为 2 或更高，则需至少被命中指定次数，Nginx 才会把响应体写入共享内存和磁盘缓存区。
注意：它只影响“缓存写入”，不影响“缓存查找”。即使未达阈值，Nginx 仍会检查缓存是否存在（若存在且未过期，依然可直接返回），只是不会把这次响应存进去。
如何配置才能提升缓存热度？
合理设置 proxy_cache_min_uses 能显著提升缓存命中率和资源利用率。常见有效做法：
- 静态资源或高复用接口设为 2～3：比如图片、CSS、JS 或用户资料页（/api/user/123），这类请求有明显访问聚集性，设为 2 可过滤掉偶然爬虫或单次调试请求
-
搭配 proxy_cache_lock 使用：防止多请求同时回源造成雪崩。当首个请求正在回源时，后续同 URI 请求会等待，等缓存写入完成后再统一读取，此时
min_uses=2也能自然满足 - 避免全局设过高值：如全站设为 5，可能导致大量中频请求永远无法进缓存，反而降低整体命中率；建议按 location 分层配置
实际配置示例
以下是一个典型场景配置（缓存静态资源，要求至少被访问 2 次才缓存）：
proxy_cache_path /var/cache/nginx/static levels=1:2 keys_zone=static:10m inactive=1h max_size=500m;
<p>server {
location ~* .(jpg|jpeg|png|gif|css|js)$ {
proxy_cache static;
proxy_cache_valid 200 1d;
proxy_cache_min_uses 2; # 关键：两次访问才缓存
proxy_cache_lock on; # 防止重复回源
proxy_cache_lock_timeout 5s;
proxy_cache_use_stale error timeout updating http_500 http_502 http_503 http_504;
proxy_pass <a href="https://www.php.cn/link/65b5b8d1f89bf53a5713bc3afdd83e9e">https://www.php.cn/link/65b5b8d1f89bf53a5713bc3afdd83e9e</a>;
}
}</p>验证是否生效？
可通过 Nginx 内置变量 $upstream_cache_status 观察行为：
- MISS：未命中缓存，且本次响应未写入缓存（可能因未达 min_uses）
- MISS (first)：首次请求，未命中，但已满足 min_uses 条件 → 下次再访问同一 URI 就会 HIT
- HIT：命中缓存，说明该响应已被成功写入并复用
- EXPIRED / STALE：缓存存在但已过期或正在更新，也说明它曾被成功缓存
建议在日志中加入该字段：log_format main '$remote_addr - $remote_user [$time_local] "$request" $status $body_bytes_sent "$http_referer" "$http_user_agent" "$upstream_cache_status"';
