proxy_cache不用于动静分离，而是对已分离的动态接口做缓存加速；动静分离靠location规则实现，静态资源直出，动态请求才走proxy_pass并可选启用proxy_cache。
在企业级大流量网站中，proxy_cache 不直接用于“动静分离”，而是配合动静分离做动态内容缓存加速。真正的动静分离靠 location 规则把请求分流：静态资源走本地文件系统（root / alias），动态请求才交给 proxy_pass 并可选启用 proxy_cache。混淆这两者会导致配置失效或缓存污染。
动静分离是前提，cache 是增强层
必须先完成基础动静分离，再考虑是否对某些动态接口做缓存：
- 静态资源（.js/.css/.png/.woff2 等）由 Nginx 直接读取磁盘，不经过后端，也不走 proxy_cache
- 动态接口（如 /api/、/user/info）才通过
proxy_pass转发，此时才可配置proxy_cache缓存其响应 -
proxy_cache对静态文件无效——因为根本没触发代理；强行配了也不会生效
关键 cache 配置项与企业级实践要点
启用前需在 http 块定义缓存区，再在 location 中引用：
-
proxy_cache_path /var/cache/nginx/api_cache levels=1:2 keys_zone=api_cache:256m inactive=1h max_size=10g use_temp_path=off;
— 指定缓存路径、内存元数据区（256MB）、过期策略（1小时无访问即淘汰）、总容量上限 -
proxy_cache api_cache;
— 在对应 location 内启用该缓存区 -
proxy_cache_valid 200 302 10m; proxy_cache_valid 404 1m;
— 不同状态码设不同缓存时长，避免错误响应长期滞留 -
proxy_cache_key "$scheme$request_method$host$request_uri$is_args$args";
— 确保带参数的 URL（如 /api/list?page=2）被正确区分缓存 -
proxy_ignore_headers Cache-Control Expires Set-Cookie;
— 企业后端常返回Cache-Control: no-cache，此处强制忽略，由 Nginx 统一管控
缓存穿透与更新控制（企业刚需）
高流量下必须解决缓存一致性问题：
aperture: the L402 aware reverse proxy
下载
安装并运行 Aperture（Lightning Labs 的 L402 闪电反向代理），用于创建 L402 付费墙、配置付费 API 端点、为其他代理托管付费内容或测试 L402 认证流程。
- 用
proxy_cache_bypass $arg_nocache;支持加 ?nocache=1 强制回源调试 - 集成
ngx_cache_purge模块，提供 PURGE 方法清除指定 URL 缓存（需编译时加入） - 对登录态、用户个性化接口（含 Cookie 或 Authorization 头），默认禁用缓存：
proxy_no_cache $cookie_sessionid $http_authorization; - 设置
proxy_cache_lock on;和proxy_cache_lock_timeout 5s;，防止缓存失效瞬间大量请求击穿后端
动静分离配置示例（含 cache 启用位置）
以下是一个典型生产配置片段，注意 cache 只出现在动态 location 中：
upstream backend {
server 10.0.1.10:8080;
server 10.0.1.11:8080;
}
<p>proxy_cache_path /var/cache/nginx/api_cache levels=1:2 keys_zone=api_cache:256m inactive=1h max_size=10g use_temp_path=off;</p><p>server {
listen 80;
server_name example.com;</p><pre class="brush:php;toolbar:false;"># 静态资源：直出，不代理，不缓存
location ~* \.(js|css|png|jpg|gif|webp|woff2|ttf|svg)$ {
root /data/www/static;
expires 1y;
add_header Cache-Control "public, immutable";
}
# 动态接口：代理 + 缓存
location /api/ {
proxy_pass http://backend;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_cache api_cache;
proxy_cache_valid 200 302 10m;
proxy_cache_valid 404 1m;
proxy_cache_use_stale error timeout updating http_500 http_502 http_503 http_504;
proxy_cache_lock on;
proxy_cache_lock_timeout 5s;
proxy_cache_bypass $arg_nocache;
proxy_no_cache $cookie_user_token $http_authorization;
}}
