Nginx缓存键值设计（从零开始掌握高性能缓存配置）

在现代Web开发中，提升网站访问速度是优化用户体验的关键一环。而Nginx缓存作为一种高效、轻量的缓存机制，被广泛应用于各类高并发场景中。本文将手把手教你如何设计合理的缓存键值，让你即使没有经验也能轻松上手！

什么是Nginx缓存？

Nginx不仅可以作为Web服务器或反向代理，还支持通过proxy_cache模块对后端响应进行缓存。这样，当多个用户请求相同内容时，Nginx可以直接返回缓存结果，而无需每次都向后端服务器发起请求，从而显著提升Web性能优化效果。

缓存键值（Cache Key）的作用

缓存键值是Nginx用来判断“哪些请求应该命中同一个缓存”的依据。如果两个请求的缓存键相同，Nginx就会返回同一份缓存内容；如果不同，则视为不同资源，分别缓存。

默认情况下，Nginx使用以下字段组合生成缓存键：

$scheme：协议（如 http 或 https）
$host：主机名
$request_uri：完整的请求路径（包括查询参数）

也就是说，默认缓存键大致等价于：$scheme$host$request_uri。

Nginx缓存键值设计（从零开始掌握高性能缓存配置） Nginx缓存缓存键值 Nginx配置 Web性能优化第1张

为什么需要自定义缓存键值？

在某些场景下，默认缓存键可能不够精准。例如：

你的网站支持多语言，通过Accept-Language头区分语言版本，但默认键不包含该头，导致中文用户看到英文缓存。
移动端和PC端返回不同内容，但URL相同，需根据User-Agent区分缓存。
API接口依赖请求体（POST），但默认键只看URL，无法区分不同参数的POST请求。

如何自定义缓存键？

在Nginx配置中，你可以使用proxy_cache_key指令来自定义缓存键。语法如下：

proxy_cache_key "$scheme://$host$request_uri$http_accept_language";

上面的例子将Accept-Language头加入缓存键，确保不同语言用户获得正确内容。

常见自定义缓存键示例

1. 区分移动端与PC端：

proxy_cache_key "$scheme://$host$request_uri$http_user_agent";

2. 忽略某些无意义的查询参数（如utm_source）：

# 先用map模块清理URImap $request_uri $clean_uri {    ~^(?<path>[^?]*)\?(.*&)?(utm_source|fbclid)=[^&]*(&(.*))? $path?$5;    default $request_uri;}# 再用清理后的URI做缓存键proxy_cache_key "$scheme://$host$clean_uri";

3. 对POST请求按请求体缓存（谨慎使用）：

proxy_cache_key "$request_method|$request_uri|$request_body";

⚠️ 注意：缓存POST请求需非常小心，通常不建议缓存写操作。

完整配置示例

http {    proxy_cache_path /var/cache/nginx levels=1:2 keys_zone=my_cache:10m inactive=60m;    server {        listen 80;        server_name example.com;        location / {            proxy_pass http://backend;            proxy_cache my_cache;            proxy_cache_valid 200 302 10m;            proxy_cache_valid 404 1m;            # 自定义缓存键：包含语言和设备类型            proxy_cache_key "$scheme://$host$request_uri$http_accept_language$http_user_agent";        }    }}