proxy_cache_key 如何配置以包含查询参数
在 nginx 中,通过设置 proxy_cache_key 变量并引用 $query_string 即可将查询参数纳入缓存键。这样配置后,nginx 会根据 url 的路径和完整的查询字符串生成唯一的缓存标识,确保不同参数的请求获取到不同的缓存内容。

忽略特定参数或简化缓存键的方法
如果某些查询参数(如时间戳或追踪 ID)不应影响缓存内容,可以通过自定义变量过滤掉这些参数,或者使用 $uri 替代 $request_uri 来排除查询部分。这种做法能减少缓存碎片,提高缓存命中率。

当查询参数为空时缓存键的行为
当请求 URL 中不包含任何查询参数时,$query_string 变量的值为空字符串。此时缓存键仅由路径和其他固定部分组成,例如 /index.html-。这意味着带参数和不带参数的请求会被视为不同的资源,分别缓存。
server {
listen 80;
server_name example.com;
# 定义缓存路径和级别
proxy_cache_path /var/cache/nginx levels=1:2 keys_zone=my_cache:10m max_size=1g inactive=60m;
location /api/ {
# 核心配置:包含查询参数的缓存键
# $scheme://host$request_uri$query_string 确保唯一性
proxy_cache_key "$scheme://$host$request_uri$query_string";
proxy_pass http://backend_server;
proxy_cache my_cache;
# 设置缓存过期时间
proxy_cache_valid 200 302 10m;
proxy_cache_valid 404 1m;
}
}
上述配置中,proxy_cache_key 使用了 $request_uri(包含路径和查询串)和 $query_string。虽然 $request_uri 已经包含了查询串,但显式添加 $query_string 是一种更清晰、更常见的做法,特别是在需要精确控制缓存键组成时。如果希望完全忽略查询参数,可以将缓存键设置为 $scheme://$host$request_uri 中的 $uri 部分,即 $scheme://$host$uri。
# 忽略所有查询参数的示例
proxy_cache_key "$scheme://$host$uri";
# 仅保留特定参数的示例(需配合 map 或 if)
# 这里展示一个简化的逻辑,实际生产中建议使用 map 指令
map $query_string $filtered_query {
default "";
"page=1" "page=1";
"sort=date" "sort=date";
}
proxy_cache_key "$scheme://$host$uri$filtered_query";
在第一个代码块中,我们看到了标准的包含查询参数的配置。在第二个代码块中,展示了两种简化策略:一是完全忽略查询参数,二是通过 map 指令筛选特定参数。这两种方法都能有效管理缓存空间,避免因为无关参数导致缓存膨胀。
对于第三个问题,当查询参数为空时,$query_string 的值为空。因此,缓存键变为 $scheme://$host$uri-(注意末尾的空字符串)。这确保了无参请求和有参请求不会冲突。开发者应意识到,即使参数为空,Nginx 也会为每个不同的 URI 路径创建独立的缓存条目,这是符合预期的行为。


















