核心是通过归一化和减法构造稳定缓存键：统一语言标识（如zh-hk→zh）、提取终端类型（mobile/desktop）、剔除无关query参数，仅保留影响响应的维度，如proxy_cache_key "web:$scheme://$host$request_uri|$lang|$device|$cookie_user_id"。
核心是让同一内容在不同设备、不同语言下生成相同缓存键，而真正有差异的内容则生成不同键——不是堆字段，而是做减法和归一化。
只保留影响响应的维度，剔除干扰项
默认 $scheme$host$request_uri 会把所有 query 参数、大小写、空格、编码变体都算进去，极易造成缓存分裂。比如：
-
/api/news?id=123&utm_source=wechat和/api/news?id=123&utm_medium=sns实际返回一样，却生成两个缓存 -
Accept-Language: zh-CN和zh-tw都该命中中文文案，但默认 key 会让它们互不命中 -
User-Agent差异导致 PC/移动端 HTML 被混存，用户看到错版页面
用 map 统一语言标识，避免 Accept-Language 泛滥
浏览器发来的语言头格式千奇百怪，直接用 $http_accept_language 会导致严重碎片。应在 http 块中预定义映射：
map $http_accept_language $lang {
~^zh "zh";
~^en "en";
~^ja "ja";
~^ko "ko";
default "en";
}
这样 zh-HK、ZH-cn、zh-TW 全部归为 "zh"，中文内容共用一份缓存。若站点支持 URL 路径语言（如 /en/about），优先取路径段；Cookie 中有 lang=ja 也比 Accept-Language 更权威，可叠加判断。
FastAPI Flask Proxy
下载
FastAPI + Flask 混合部署最佳实践，解决路由定义、API 代理等常见问题，适用于同时运行 FastAPI API 与 Flask 前端的场景。
区分终端类型，但不依赖 User-Agent 全量字符串
用 map 提取设备类型，避免 UA 字符串过长且易变：
map $http_user_agent $device {
"~*Mobile|Android|iPhone|iPad" "mobile";
"~*Tablet" "tablet";
default "desktop";
}
再结合业务逻辑决定是否纳入缓存键：静态资源（JS/CSS/图片）通常无需区分终端；SSR 页面或响应式 HTML 若确实返回不同结构，则加入 $device；但注意，同一语言+同一设备下的内容才应共享缓存。
构造干净、稳定、带前缀的最终 key
示例配置（含域名隔离与负载均衡兼容）：
proxy_cache_key "web:$scheme://$host$request_uri|$lang|$device|$cookie_user_id";
-
web:是业务前缀，便于后续按前缀批量清理或监控 -
$host防止多域名共用缓存（如www.example.com和app.example.com不混） -
$lang和$device是归一化后变量，非原始 header 或 args -
$cookie_user_id仅对登录态接口启用，未登录时统一设为"guest"（用 map 处理） - 不包含
$args全量，只保留影响响应的参数（如id、category），其余用 map 清洗掉
上线前务必通过 log_format cache '$cache_key - $upstream_cache_status'; 抽样验证 key 是否收敛，再配合 add_header X-Cache-Status $upstream_cache_status; 观察 HIT 率变化。
