缓存键设计怎么通过proxy_cache_key自定义基础键-Nginx-PHP中文网

proxy_cache_key 是 nginx 反向代理层的缓存键配置指令，用于定义 http 响应缓存的唯一标识，与 spring boot 的 @cacheable 或 redis 缓存键无关；其默认值为 $scheme$proxy_host$request_uri，支持通过变量组合（如 $cookie_user_id、$http_user_agent）自定义键，适用于已启用 proxy_cache 的静态资源或 api 响应缓存场景。

缓存键设计怎么通过proxy_cache_key自定义基础键

你提到的 proxy_cache_key 是 Nginx 的指令，和 Spring Boot + Redis 的缓存键（如 @Cacheable 生成的 key）完全无关。它用于 Nginx 反向代理层的 HTTP 缓存（即 proxy_cache），控制“哪些请求应视为同一个缓存条目”。不是 Redis 缓存、也不是 Spring Cache 的配置项。

proxy_cache_key 的作用与常见写法

该指令定义 Nginx 在缓存响应时，用哪些变量拼出一个唯一字符串作为缓存键。默认值是：
$scheme$proxy_host$request_uri
即协议 + 后端主机名 + 完整请求 URI（含查询参数）。

你可以按需扩展，例如：

区分用户登录态：proxy_cache_key "$scheme$proxy_host$request_uri $cookie_user_id";
忽略特定参数（如跟踪用的 utm_source）：proxy_cache_key "$scheme$proxy_host$uri$is_args$args"; 配合 map 清洗 $args
强制区分移动端/桌面端：proxy_cache_key "$scheme$proxy_host$request_uri $http_user_agent";（不推荐，粒度太细易击穿）

别和 Spring 的 cacheKey 混淆

Spring Boot 的 @Cacheable 缓存键由 Java 方法上下文决定，走的是 KeyGenerator 或 SpEL 表达式；而 proxy_cache_key 是 Nginx 在 HTTP 协议层做的字符串拼接，两者运行位置、生效阶段、数据格式都不同。即使你用 Redis 做 Spring 缓存，Nginx 层的 proxy_cache 仍是独立的一套缓存机制，不会读取或影响 Spring 生成的 key。

CPA Update - Secure CLI Proxy API Maintenance

安全更新和维护 CLI Proxy API（CPA）部署与配置。用于 CPA 镜像升级、配置变更、认证目录兼容修复、上线验证与回滚。适用于用户提到“CPA 更新/升级/配置改了/容器重建/回滚”等场景。

下载

什么时候该用 proxy_cache_key？

适用于静态资源、API 响应等「可被整个 HTTP 响应缓存」的场景，且你已开启 Nginx 的 proxy_cache 模块。典型配置片段：

proxy_cache_path /var/cache/nginx/api_cache levels=1:2 keys_zone=api_cache:10m max_size=1g;<br>
server {<br>
  location /api/ {<br>
    proxy_pass http://backend;<br>
    proxy_cache api_cache;<br>
    proxy_cache_key "$scheme$host$request_uri";<br>
    proxy_cache_valid 200 5m;<br>
  }<br>
}

想统一管理缓存键？分层考虑

若你同时用了 Nginx 缓存和 Spring Redis 缓存，建议：

Nginx 层：聚焦「HTTP 维度」——用 proxy_cache_key 控制 URL、Header、Cookie 等组合
应用层：聚焦「业务维度」——用 Spring 的 @Cacheable(key = "...") 或自定义 KeyGenerator，确保方法调用语义清晰、key 可读可追溯
避免两层 key 设计逻辑重叠，比如不要在 Nginx 里拼用户 ID，又在 Spring 里也拼一次用户 ID 做缓存——容易错位失效