proxy_cache_min_uses 是缓存热度准入门槛，只控制响应是否写入缓存，不影响请求转发、缓存查找或key计算；需配合 proxy_cache_lock 和合理 cache_key 设计才能降低 SSD 无效写入。
proxy_cache_min_uses 不是“过滤器”，它不拦截请求、不跳过回源、也不减少 SSD 读写次数；但它能显著降低低频响应对 SSD 的无效写入压力——前提是配合 proxy_cache_lock 和合理的 proxy_cache_key 设计。
为什么设成 2 比设成 1 更省 SSD 写入带宽
默认 proxy_cache_min_uses 1 会让每个可缓存响应（哪怕只被访问一次）都落盘：Nginx 先写共享内存元数据，再同步刷到磁盘文件。对长尾 URL（如带随机 r= 参数的埋点、单次调试页、爬虫试探路径），这等于把大量“一次性内容”反复写进 SSD，徒增磨损和写放大。
- 设为
proxy_cache_min_uses 2：前一次请求仍回源、仍查缓存（若已有未过期副本仍可能HIT），但响应体不落盘；第二次请求时，若proxy_cache_lock on生效，则等待首次响应完成并写入缓存，此时才真正触发一次写入 - 实际效果：同一 URI 的两次访问 → 仅 1 次 SSD 写入（而非默认的 2 次），且后续命中全部走读缓存（
HIT），不触 SSD - 注意：
inactive参数决定缓存项多久不被访问就自动清理，它和min_uses协同控制“冷数据不留”——但inactive管的是读后的淘汰，min_uses管的是写的准入
不加 proxy_cache_lock，min_uses=2 就是假节省
单独提高 proxy_cache_min_uses 值而不启用锁机制，会导致并发请求在未达阈值期间重复回源，反而加重后端和网络压力，SSD 写入虽少，但整体负载更高。
- 现象：
proxy_cache_min_uses 2+proxy_cache_lock off→ 两个并发请求都回源，各自生成临时响应，但都不写缓存；第 3 次请求才开始缓存 —— 白白多压后端两次 - 正确做法：必须配
proxy_cache_lock on，并设合理超时（如proxy_cache_lock_timeout 5s），让第 2 次请求等待第 1 次回源完成，共享同一个写入动作 - 验证方式：观察响应头
X-Cache-Status，连续两次请求应依次出现MISS（未达阈值）、MISS（等待锁释放后写入），第三次起才是HIT
哪些路径适合设 min_uses=2，哪些必须跳过缓存模块
不是所有 URL 都适合用 min_uses 控制热度——它只对“URI 相同、key 可复用”的请求有效。一旦 proxy_cache_key 包含不可控变量（如时间戳、用户 ID、随机串），min_uses 就完全失效，每个请求都算“新 key”，永远达不到阈值。
- 适合设
min_uses 2的路径：location ~* \.(js|css|png|jpg|gif)$、location /api/user/\d+（用户页有访问聚集性） - 必须跳过缓存的路径：
location /log（含ts=、r=）、location /search（带q=动态参数）——直接用proxy_no_cache 1或map显式绕过，别指望min_uses过滤 - 关键检查点：用
log_format打印$cache_key，确认真实缓存键是否稳定；若含$args，优先用proxy_cache_bypass $arg_nocache或剔除无关参数重写proxy_cache_key
监控与调优的真实信号在哪
$upstream_cache_status 是唯一可信指标，但要注意它的语义：它不反映“是否被过滤”，而反映“本次是否写入缓存”。MISS 分两种——一种是真没缓存（首次请求），一种是“有缓存但未达 min_uses，所以不写”。后者容易被误判为配置失败。
- 看日志里
MISS是否集中出现在特定 URI 上，且持续多次不转HIT→ 很可能是cache_key不稳定或proxy_cache_lock未生效 - 用
nginx -T | grep -A5 'proxy_cache_min_uses'确认配置已加载，避免 location 嵌套覆盖 - SSD 写入量下降 ≠ 缓存效率提升：需同步看
cache hit ratio（通过stub_status或 Prometheus exporter）——如果min_uses调太高，HIT率反而跌，说明中频请求被误伤
最常被忽略的一点：proxy_cache_min_uses 的计数是单机、无状态、按 key 独立维护的。它无法识别全局低频（比如一个 URL 在 A 机器上访问 1 次、B 机器上访问 1 次，合计 2 次，但每台都卡在 MISS）。想做跨节点热度聚合，得靠 CDN 或应用层统计，Nginx 本身做不到。
