在 nginx 中按语言区分缓存,核心做法是修改 proxy_cache_key 配置,将请求头中的 accept-language 变量加入键值。这样当用户请求不同语言的页面时,nginx 会生成不同的缓存文件并分别存储,实现语言隔离。

如何配置 proxy_cache_key 以包含语言信息
直接回答:需要在 http 或 server 块中设置 proxy_cache_key,并在其中引用 $http_accept_language 变量。通常建议结合 $scheme、$host 和 $request_uri 使用,以确保缓存键的唯一性。

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 use_temp_path=off;
location /api/ {
# 关键配置:将 Accept-Language 加入缓存键
proxy_cache_key "$scheme$host$request_uri$http_accept_language";
# 启用缓存
proxy_cache my_cache;
proxy_cache_valid 200 10m;
# 转发请求到后端
proxy_pass http://backend_server;
proxy_set_header Host $host;
}
}
上述配置中,proxy_cache_key 的值由协议、主机名、请求 URI 和用户首选语言组成。如果用户发送 Accept-Language: zh-CN,生成的键将包含 "zh-CN";若发送 en-US,则键中包含 "en-US"。Nginx 会根据这两个不同的键存储两份独立的缓存内容。
如何处理默认语言和缓存失效问题
直接回答:当客户端未发送 Accept-Language 头时,$http_accept_language 为空,可能导致所有无语言标识的请求共用一个缓存。为避免此问题,可设置默认语言或使用 map 指令规范化语言代码。同时,需注意后端返回的 Vary 头是否影响缓存行为。

# 在 http 块中定义 map 指令,确保语言代码标准化
map $http_accept_language $lang {
default "en";
~^zh.* "zh";
~^ja.* "ja";
}
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 use_temp_path=off;
location /api/ {
# 使用标准化的语言变量作为缓存键的一部分
proxy_cache_key "$scheme$host$request_uri$lang";
proxy_cache my_cache;
proxy_cache_valid 200 10m;
# 告知下游缓存器根据 Vary 头进行缓存
add_header Vary Accept-Language;
proxy_pass http://backend_server;
proxy_set_header Host $host;
}
}
通过 map 指令,我们将各种语言变体(如 zh-CN、zh-TW)统一映射为简写代码(如 zh),从而减少缓存碎片。同时,add_header Vary Accept-Language 确保 CDN 或浏览器也能正确识别语言差异,避免跨语言缓存污染。若需强制刷新某语言缓存,可通过删除对应缓存文件或调整 proxy_cache_valid 时间来实现。
基于 Accept-Language 头缺失时的缓存行为具体问题
直接回答:当请求中缺少 Accept-Language 头时,$http_accept_language 值为空字符串,导致所有此类请求共享同一个缓存条目。这可能导致中文用户因未发送该头而获取到英文默认内容。解决方法是使用 map 设置默认值,或在后端根据 IP 区域推断语言并注入自定义头。


















