uwsgi_cache_key

`uwsgi_cache_key` 指令在使用 uWSGI 缓存时为 NGINX 中的缓存设置键。 — NGINX HTTP Core

uwsgi_cache_key
httpserverlocation
语法uwsgi_cache_key string;
默认值$request_uri;
上下文http, server, location
模块NGINX HTTP Core
参数1

说明

`uwsgi_cache_key` 指令用于定义一个自定义键,NGINX 将使用该键将响应存入 uWSGI 缓存。该指令在需要根据某些参数对缓存进行分段的场景中非常重要,例如会话 ID、用户认证状态,或任何影响针对特定请求所提供内容的其他变量。默认情况下,NGINX 会使用请求 URI 的哈希,但通过该指令,你可以显式指定缓存键的构造方式。 该指令通过接受单个参数来工作,该参数是一个可以包含变量、常量或两者的字符串,从而提供了构建缓存键的灵活方式。例如,如果你希望基于用户会话使用不同的缓存条目,可以包含变量 $http_cookie。这里定义的键对于确保缓存命中准确至关重要,能够保证在随后相同请求发生时检索到预期的响应。

配置示例

uwsgi_cache_key "$scheme$request_method$host$request_uri$http_cookie";

覆盖默认 key 需要准确地指定,以避免 cache misses。

如果在 key 中使用 variables,请确保它们在访问 cache 的上下文中已被定义。