root指令仅用于静态文件服务，与proxy_cache无关；代理缓存依赖proxy_cache_path、proxy_cache、proxy_cache_key和proxy_cache_valid四组指令协同工作，且proxy_pass与root不能共存于同一location。
root 指令本身不参与代理缓存逻辑，它只在 Nginx 作为静态文件服务器时起作用（比如 location /static/ { root /var/www; }），而代理缓存（proxy_cache）发生在 proxy_pass 转发到后端的场景中。两者职责不同、互不干扰——但容易混淆，尤其当配置里同时出现 root 和 proxy_pass 时。
下面直接讲清楚怎么配、为什么这么配、常见踩坑点：
root 和 proxy_cache 不共存于同一 location
Nginx 的 location 块里，如果用了 proxy_pass，就表示走反向代理流程，此时 root 或 alias 完全不生效（会被忽略）。
例如：
location /api/ {
root /data/app; # ← 这行无效！Nginx 不会用它找文件
proxy_pass http://backend;
}
✅ 正确做法：代理场景下删掉 root，只保留 proxy_pass 及配套缓存指令。
代理缓存真正依赖的配置项
要让缓存生效，关键不是 root，而是这四组指令协同工作：
-
proxy_cache_path：定义缓存存储路径和内存 zone（必须在http块顶层声明） -
proxy_cache：启用指定 zone 的缓存（写在server或location里） -
proxy_cache_key：决定“什么请求算同一个缓存项”（默认含$scheme$host$uri$is_args$args） -
proxy_cache_valid：按响应状态码设置缓存时间（如200 302 10m）
示例（精简有效）：
http {
proxy_cache_path /var/cache/nginx/mycache levels=1:2 keys_zone=mycache:10m max_size=1g;
server {
location / {
proxy_pass http://127.0.0.1:8000;
proxy_cache mycache;
proxy_cache_key "$scheme$request_method$host$request_uri";
proxy_cache_valid 200 301 302 10m;
proxy_cache_valid 404 1m;
add_header X-Cache-Status $upstream_cache_status; # 方便调试
}
}
}
需要 root 的典型场景（非代理）
只有当你想让 Nginx 直接提供本地静态资源时，才用 root，且此时不能有 proxy_pass：
location /assets/ {
root /opt/web; # → 实际访问 /opt/web/assets/logo.png
expires 1h;
}
如果你希望“部分路径走静态（用 root），部分走代理缓存”，那就用多个 location 分开写：
location /static/ {
root /var/www/html;
}
location / {
proxy_pass http://app_backend;
proxy_cache mycache;
# … 缓存相关配置
}
容易出错的细节提醒
- 缓存目录
/var/cache/nginx/mycache必须由nginx用户可读写（chown -R nginx:nginx /var/cache/nginx/mycache） -
proxy_cache_valid若没覆盖到后端返回的状态码（比如后端返回 503），该响应就不会被缓存 -
proxy_buffering on（默认开启）是缓存前提：Nginx 必须收完后端响应才能写入缓存；关掉它会导致缓存失效 -
add_header X-Cache-Status $upstream_cache_status是调试神器，返回头里能看到HIT/MISS/BYPASS
本质上，root 管文件路径映射，proxy_cache 管网络响应复用——它们属于 Nginx 的两个平行能力模块，混用只会导致配置失效或行为不可预期。
