Nginx需为静态与动态资源分别定义独立缓存区、匹配路径及策略：静态资源由root直接服务并设浏览器缓存，动态请求经proxy_pass转发至后端并启用对应proxy_cache，避免混用导致失效或冲突。
要让 Nginx 同时高效缓存静态资源和动态内容，关键不是“只开一个缓存”，而是为两类请求建立**独立的缓存区、独立的缓存策略和独立的匹配路径**。静态缓存讲求长期稳定、浏览器直取；动态缓存讲求服务端可控、按状态码分级过期。两者混用会互相干扰，比如把 HTML 接口和 JS 文件共用一个缓存区，容易因 key 冲突或 inactive 时间不一致导致意外失效。
1. 分开定义缓存区（keys_zone）
在 http {} 块顶层分别声明两个缓存区，名称、大小、清理策略互不干扰：
-
静态缓存区：专用于 CSS/JS/图片等，生命周期长、容量可大些
proxy_cache_path /var/cache/nginx/static levels=1:2 keys_zone=static_cache:50m max_size=5g inactive=30d use_temp_path=off; -
动态缓存区：专用于 API、HTML 页面等，更关注响应状态和更新频率
proxy_cache_path /var/cache/nginx/dynamic levels=1:2 keys_zone=dynamic_cache:20m max_size=2g inactive=10m use_temp_path=off;
注意：inactive 表示缓存项多久未被访问就自动清理——静态设为 30 天合理，动态设为 10 分钟更安全，避免 stale 数据堆积。
2. 按 location 分流并绑定对应缓存
在 server {} 块内，用不同 location 匹配规则，各自启用专属缓存：
-
静态资源走本地文件 + 浏览器缓存（不走 proxy_cache，直接返回）：
location ~* \.(css|js|png|jpg|gif|woff2|ttf)$ {
root /var/www/static;
expires 1y;
add_header Cache-Control "public, immutable";
} -
动态接口走反向代理 + 动态缓存区：
location /api/ {
proxy_pass http://backend;
proxy_cache dynamic_cache;
proxy_cache_key "$scheme$request_method$host$request_uri$is_args$args";
proxy_cache_valid 200 302 5m;
proxy_cache_valid 404 1m;
proxy_cache_use_stale error timeout updating;
} -
带版本号的静态资源（如 /static/v2/app.js）也可走 dynamic_cache，便于后端统一控制刷新逻辑，此时需确保
proxy_cache_key包含版本字段，避免 key 冲突。
3. 缓存标识与调试建议
加响应头区分来源，方便验证是否命中正确缓存：
- 在静态 location 中加：
add_header X-Cache "STATIC-HIT"; - 在动态 location 中加：
add_header X-Cache-Status $upstream_cache_status;
add_header X-Cache-Name "DYNAMIC";
用 curl 测试：
curl -I https://example.com/api/user
→ 查看 X-Cache-Status: HIT / MISS / BYPASS
→ 查看 X-Cache-Name: DYNAMIC
4. 避免常见陷阱
几个实际部署中高频出错点：
- 不要复用同一个 keys_zone：static_cache 和 dynamic_cache 必须名称不同，否则配置冲突、缓存互相覆盖。
- 不要在静态 location 里写 proxy_cache：静态资源由 Nginx 直接读磁盘，加 proxy_cache 反而绕路、无效甚至报错。
-
动态缓存必须校验后端响应头：如果后端返回
Cache-Control: no-cache或Set-Cookie，Nginx 默认不缓存；需显式加proxy_ignore_headers Cache-Control Set-Cookie;才强制缓存（慎用，确认业务允许）。 -
缓存目录权限要对：确保 nginx worker 进程用户（如 www-data 或 nginx）对
/var/cache/nginx/static和/var/cache/nginx/dynamic有读写权限，否则日志报open() "/var/cache/nginx/... failed (13: Permission denied)"。
