配置动态缓存键变量需使用 proxy_cache_key 指令,通过拼接 $scheme、$host、$request_uri 等内置变量来生成唯一标识。该配置直接决定 nginx 如何识别和存储不同的请求内容,确保不同参数或路径的请求获得独立的缓存条目。

如何构建包含查询参数的完整缓存键
默认情况下,Nginx 的缓存键可能不包含 URL 中的查询字符串,导致携带不同参数的相同路径请求命中同一缓存。要解决这个问题,必须显式地将 $query_string 加入缓存键中,从而区分 GET 请求的不同参数组合。

server {
listen 80;
server_name example.com;
location /api/ {
proxy_pass http://backend;
# 构建包含协议、主机、路径和查询参数的完整缓存键
proxy_cache_key "$scheme$host$request_uri$query_string";
proxy_cache my_cache;
proxy_cache_valid 200 10m;
}
}
上述配置中,$scheme$host$request_uri$query_string 组合确保了 /api/data?id=1 和 /api/data?id=2 被视为两个完全不同的资源。如果省略 $query_string,两者将共享同一个缓存文件,可能导致数据泄露或错误响应。此方法适用于所有需要基于参数区分内容的 API 接口。
如何处理动态生成的复杂路径缓存
对于由后端动态生成的路径(如用户 ID 或会话令牌),直接使用 $request_uri 会导致缓存键过长且碎片化。此时应提取关键标识符并简化路径结构,以平衡缓存命中率与存储空间。

server {
listen 80;
server_name example.com;
location /user/ {
proxy_pass http://backend;
# 仅使用主机和 URI 路径部分,忽略具体 ID 差异以复用缓存
# 或者使用正则提取关键参数作为键的一部分
set $cache_key "$host$uri";
proxy_cache_key $cache_key;
proxy_cache my_cache;
proxy_cache_valid 200 5m;
}
}
在第二个示例中,通过设置 $cache_key 变量并仅保留 $host 和 $uri,我们忽略了路径末尾的动态 ID。这意味着 /user/123 和 /user/456 将共享相同的缓存内容。这种做法适用于那些对特定 ID 不敏感或内容高度相似的场景。若需更精细控制,可结合 map 指令预处理 URI,提取特定段作为缓存键,避免全路径带来的缓存膨胀问题。
当缓存键中包含未定义变量时会发生什么
如果在 proxy_cache_key 中引用了未在上下文中定义的变量,Nginx 会将其解析为空字符串,这可能导致缓存键意外缩短,引发非预期的缓存命中冲突。例如,若 $custom_var 未被声明,$scheme$host$custom_var 将退化为 $scheme$host,使得所有来自同一主机的请求都指向同一个缓存条目。


















