通过配置 proxy_cache_path 的 levels 参数,将缓存文件分散到多级子目录中,从而解决单目录下文件过多导致的性能瓶颈。例如设置 levels=1:2 会在缓存根目录下生成两级子目录结构,使哈希值均匀分布在不同文件夹中,提升文件系统遍历和 i/o 效率。

如何确定 levels 的具体层级数
层级数取决于预期的缓存对象总量。一级目录(如 levels=1)最多支持 16 个或 256 个子目录(取决于基数),二级目录(如 levels=1:2)可支持约 4096 个或 65536 个分支。通常建议根据预计存储的文件数量选择,若文件量在百万级以下,levels=1:2 是常见且稳妥的选择;若文件量极大,可考虑 levels=1:2:2 但会增加路径深度。

server {
listen 80;
server_name example.com;
location / {
proxy_pass http://backend;
proxy_cache my_cache;
proxy_cache_valid 200 302 10m;
proxy_cache_valid 404 1m;
proxy_cache_key $scheme$request_method$host$request_uri;
}
}上述配置中,my_cache 需在 http 块中定义,并指定 levels=1:2。当请求命中缓存时,Nginx 会根据 proxy_cache_key 生成的哈希值,自动将文件存入类似 /var/cache/nginx/1/a/b/c1a2b3d4e5f6... 的路径结构中。
扩容后旧数据如何处理
Nginx 本身不会自动迁移旧缓存数据。修改 levels 后,新请求会使用新的目录结构存储,而旧数据仍留在原目录结构中。这会导致缓存命中率暂时下降,直到旧数据自然过期或被清理。建议在业务低峰期手动删除旧缓存目录,或等待其过期。

# 假设旧缓存位于 /var/cache/nginx/my_cache_old # 新配置生效后,新数据写入 /var/cache/nginx/my_cache_new # 检查当前缓存目录结构 dtree /var/cache/nginx/my_cache # 若确认无活跃引用,可清理旧数据 rm -rf /var/cache/nginx/my_cache_old/*
在实际操作中,可以通过监控 proxy_cache_status 来观察新旧数据的分布情况。如果旧目录下的文件不再被访问,说明它们已失效,可以安全清理以释放磁盘空间。
基于 proxy_cache_key 冲突的具体问题
当多个不同 URL 生成相同的 proxy_cache_key 哈希值时,会发生缓存键冲突,导致错误内容被返回。虽然 Nginx 使用 SHA1 哈希,碰撞概率极低,但在极端情况下仍需注意。确保 proxy_cache_key 包含足够区分度的变量,如 $request_uri 而非仅 $uri,以避免查询参数不同的请求被误判为相同缓存项。


















