在 nginx 中配置包含请求 uri 的缓存键,需要在 proxy_cache_key 指令中使用变量 $request_uri。这能确保不同路径的请求被独立缓存,避免内容混淆。

如何设置 proxy_cache_key 以区分不同路径
通过指定 $request_uri 作为缓存键的一部分,Nginx 会根据完整的请求 URI 生成唯一的缓存文件。这样,访问 /api/v1 和 /api/v2 的内容会被分别存储,互不干扰。

server {
listen 80;
server_name example.com;
location /api/ {
proxy_pass http://backend;
proxy_cache my_cache;
proxy_cache_key "$scheme$request_method$host$request_uri";
proxy_cache_valid 200 302 10m;
proxy_cache_valid 404 1m;
}
}
上述配置中,proxy_cache_key 结合了协议、方法、主机名和请求 URI。当请求 GET /api/users 时,Nginx 会检查是否存在对应的缓存键。如果存在且未过期,则直接返回缓存内容;否则,向后端发起请求并缓存响应。
如何处理带查询参数的 URI 缓存
当请求包含查询参数时,$request_uri 会完整保留这些参数,从而为每个不同的查询字符串生成独立的缓存项。这对于需要区分不同筛选条件的 API 非常有用。

location /search {
proxy_pass http://search_backend;
proxy_cache search_cache;
proxy_cache_key "$request_uri";
proxy_cache_valid 200 5m;
}
在此示例中,proxy_cache_key 仅使用 $request_uri。这意味着 /search?q=foo 和 /search?q=bar 将被视为不同的资源并分别缓存。如果希望忽略某些参数,可以结合 $args 或自定义逻辑进行处理。
基于请求 URI 的缓存命中率分析
在实际运行中,观察缓存命中率有助于验证 $request_uri 的使用效果。高命中率表明缓存策略有效,低命中率可能意味着缓存键过于细分或后端响应变化频繁。











