Nginx可通过location块内配置proxy_cache_valid实现路径级缓存时长控制；不同location可设不同缓存时间，且默认cache_key含$request_uri确保路径隔离；配合proxy_cache_bypass和proxy_no_cache可进一步实现路径级缓存开关。
Nginx 的 proxy_cache_valid 本身不支持按路径（location）直接设置不同缓存时间，但可以通过组合 location 块、proxy_cache_key 和 proxy_cache_valid 的作用域机制来实现“为不同路径设置不同缓存时长”的效果。
利用 location + proxy_cache_valid 实现路径级缓存时长控制
proxy_cache_valid 指令可以在 http、server 或 location 级别使用。只要把它写在具体的 location 块内，它就只对该 location 下的请求生效。
例如：
proxy_cache_path /var/cache/nginx levels=1:2 keys_zone=my_cache:10m inactive=60m use_temp_path=off;
<p>server {
location /api/v1/products/ {
proxy_pass <a href="https://www.php.cn/link/0e2f55a256a7218367349b9e87657252">https://www.php.cn/link/0e2f55a256a7218367349b9e87657252</a>;
proxy_cache my_cache;
proxy_cache_valid 200 302 10m; # 仅此路径下：成功响应缓存 10 分钟
proxy_cache_valid 404 1m; # 404 也缓存 1 分钟
}</p><pre class="brush:php;toolbar:false;">location /api/v1/users/ {
proxy_pass https://www.php.cn/link/0e2f55a256a7218367349b9e87657252;
proxy_cache my_cache;
proxy_cache_valid 200 302 5m; # 此路径下：仅缓存 5 分钟
proxy_cache_valid 404 30s;
}
location /static/ {
proxy_pass https://cdn;
proxy_cache my_cache;
proxy_cache_valid 200 302 1h; # 静态资源缓存 1 小时
expires 1h;
}
}
注意 cache_key 与路径匹配的一致性
如果多个 location 共享同一个 proxy_cache 区域（如都用 my_cache），Nginx 默认用 $scheme$proxy_host$request_uri 生成 key —— 它天然包含路径，所以不同路径的响应不会互相覆盖。
但如果你自定义了 proxy_cache_key（比如去掉了 $request_uri 或只保留了参数），就可能造成路径 A 的响应被路径 B 误命中。务必确保 key 足够区分路径：
- 默认 key 已含完整 URI，通常安全
- 若需排除某些参数（如跟踪用的
utm_*），可用map清洗$request_uri后再构造 key - 避免在不同 location 中用相同 key 却期望不同缓存行为
配合 proxy_cache_bypass 和 proxy_no_cache 精细控制
仅靠 proxy_cache_valid 控制“该缓存多久”还不够，有时还需控制“是否跳过缓存”或“是否不缓存”。比如：
- 对带特定 header（如
X-No-Cache: 1）的请求，用proxy_cache_bypass $http_x_no_cache让其绕过缓存 - 对登录态接口（如
/api/v1/profile），可加proxy_no_cache $cookie_sessionid，有 session 就不缓存 - 这些指令同样支持写在 location 内，实现路径级开关
验证与调试技巧
确认配置是否生效，可通过响应头和日志观察：
- 开启
add_header X-Cache-Status $upstream_cache_status;，返回HIT/MISS/BYPASS - 检查 Nginx error 日志是否有
cache miss或 key 冲突提示 - 用
curl -I查看Age头，判断是否命中及已缓存时长 - 临时把
inactive设小（如 30s），快速验证过期逻辑
