检查 nginx 缓存路径配置的正确性,核心在于验证 proxy_cache_path 指令中定义的目录是否存在、权限是否允许 nginx 工作进程写入,以及磁盘空间是否充足。具体做法是确认 levels 参数生成的子目录结构与实际文件系统一致,并检查 keys_zone 名称是否与 proxy_cache 调用处匹配。若配置有误,nginx 会在启动或重新加载时拒绝服务或在日志中报错。

如何验证 proxy_cache_path 的目录结构与权限
该指令通过 levels 参数控制缓存文件的层级深度,例如 levels=1:2 会创建两级子目录。要验证其正确性,需确保 Nginx 运行用户(通常是 www-data 或 nginx)对该路径拥有读写执行权限,且父目录存在。如果权限不足,Nginx 将无法写入缓存文件,导致回源请求激增。

mkdir -p /var/cache/nginx/proxy chown -R www-data:www-data /var/cache/nginx/proxy chmod 755 /var/cache/nginx/proxy ls -ld /var/cache/nginx/proxy
上述命令创建了缓存目录并赋予正确的所有者和权限。执行 ls -ld 后,应看到类似 drwxr-xr-x 2 www-data www-data ... /var/cache/nginx/proxy 的输出,表明目录存在且可写。若权限错误,Nginx 将在错误日志中记录 permission denied。
如何检查 keys_zone 名称与 proxy_cache 调用的匹配性
proxy_cache_path 必须通过 keys_zone 参数定义一个共享内存区域,并在 location 块中使用 proxy_cache 指令引用该名称。若名称不匹配,Nginx 将忽略缓存配置或报错。验证方法是检查配置文件中的名称一致性,并确保内存大小足够存储键值对。

# 在 http 块中定义
proxy_cache_path /var/cache/nginx/proxy levels=1:2 keys_zone=my_cache:10m max_size=1g inactive=60m;
# 在 server/location 块中引用
location / {
proxy_pass http://backend;
proxy_cache my_cache; # 必须与 keys_zone 名称一致
}
此配置片段展示了标准的缓存设置。关键点在于 keys_zone=my_cache:10m 中的 my_cache 必须在 proxy_cache 指令中精确匹配。任何拼写错误或大小写差异都会导致缓存失效。此外,max_size 限制了磁盘占用,inactive 定义了非活跃缓存的保留时间。
基于 proxy_cache_path 中 max_size 参数的具体问题是:当缓存达到最大容量时,Nginx 如何处理旧缓存?
当缓存目录达到 max_size 设定的上限时,Nginx 会根据 LRU(最近最少使用)算法删除最久未访问的缓存文件,以腾出空间给新内容。这一过程是自动的,无需人工干预。可以通过监控缓存目录的大小或使用 proxy_cache_valid 指令来优化缓存策略,确保重要内容不被过早清除。


















