proxy_cache_min_uses控制同一缓存键响应被命中次数后才缓存，与文件大小无关；真正限制小文件缓存的是proxy_cache_min_bytes（Nginx 1.19.3+），默认0表示不限制，设为1024则仅缓存≥1KB响应体。

在 macOS 下使用 Nginx 时，proxy_cache_min_uses 并不用于限制“缓存的最小文件尺寸”，而是控制一个请求响应**被缓存前需被相同请求命中多少次**。它和文件大小无关，真正影响小文件是否被缓存的是 proxy_cache_min_bytes（Nginx 1.19.3+ 引入）。

proxy_cache_min_uses 的作用与常见误解

该指令定义：同一个缓存键（cache key）对应的响应，在被真正写入磁盘缓存前，必须被客户端重复请求达到指定次数（默认为 1）。它用于避免“一次性请求”污染缓存，提升缓存命中率和有效性。

• 设为 1：首次响应即可能缓存（取决于其他条件，如状态码、头信息等）
• 设为 3：同一 URL/Key 需被请求 3 次，第 3 次响应才写入缓存
• 它对所有响应一视同仁，不区分 1KB 还是 10MB —— 文件大小不是它的判断依据

真正限制小文件缓存的指令：proxy_cache_min_bytes

从 Nginx 1.19.3 起，支持 proxy_cache_min_bytes，这才是你想要的“最小文件尺寸”开关：

• 默认值为 0，表示不限制大小
• 设为 1024：仅缓存响应体 ≥ 1KB 的内容（如 HTML、JS、CSS），跳过小图标（favicon.ico）、空响应、tiny JSON 等
• 需配合 proxy_cache 和 proxy_cache_valid 使用，且要求 Nginx 版本 ≥ 1.19.3

macOS 上若用 Homebrew 安装，检查版本：
nginx -v — 若低于 1.19.3，需升级：
brew upgrade nginx（确保 tap 支持最新版，必要时 brew tap-new homebrew/nginx && brew tap-pin homebrew/nginx）

实际配置示例（含缓存策略协同）

以下片段放在 location 或 server 块中：

proxy_cache my_cache;
proxy_cache_valid 200 302 10m;
proxy_cache_valid 404 1m;
proxy_cache_min_uses 2;          # 同一资源需访问 2 次才缓存
proxy_cache_min_bytes 1024;      # 仅缓存 ≥1KB 的响应体
proxy_cache_use_stale error timeout updating http_500 http_502 http_503 http_504;

注意：proxy_cache_min_bytes 检查的是响应体（body）原始字节数，不含响应头；gzip 压缩后大小不影响该判断（Nginx 在压缩前做此检查）。

验证小文件是否被跳过缓存

可通过日志或响应头确认：

• 开启 log_format 记录 $upstream_cache_status，查看是否出现 BYPASS（因未达 min_uses）或仍为 MISSED（因小于 min_bytes）
• 用 curl -I http://localhost/path/to/small.png 观察是否返回 X-Cache: MISS 且无 Age 头，再对比大文件是否出现 HIT
• 检查缓存目录（如 /usr/local/var/nginx/cache）下是否有对应小文件 hash 目录生成 — 通常不会