要实现移动端与 pc 端缓存隔离,核心做法是修改 nginx 的 proxy_cache_key,在原有的 url 基础上追加区分设备的标识(如 cookie 或 user-agent),从而让同一 url 生成不同的缓存键。具体配置时,建议在 http 块中定义一个变量来提取设备类型,然后在 location 块中将此变量加入缓存键表达式,这样 nginx 就会为不同设备分别存储和返回缓存内容。

如何定义并提取设备标识变量
首先需要从请求头中提取用于区分设备的字段,通常使用 User-Agent 或特定的 Cookie。在 Nginx 中,可以使用 map 指令将复杂的 UA 字符串映射为简单的布尔值或分类标签,以便后续拼接进缓存键。这一步确保了缓存键生成的逻辑清晰且易于维护。

http {
# 定义变量 $mobile,根据 User-Agent 判断是否为移动端
map $http_user_agent $mobile {
default 0;
~*mobile 1;
~*android 1;
~*iphone 1;
}
server {
listen 80;
server_name example.com;
location / {
proxy_pass http://backend;
# 将设备标识加入缓存键
proxy_cache_key "$scheme$host$request_uri$is_args$args$mobile";
}
}
}
上述代码中,map 块定义了 $mobile 变量,当 User-Agent 包含 "mobile"、"android" 或 "iphone" 时值为 1,否则为 0。在 location 中,proxy_cache_key 使用了 $mobile 变量,这意味着对于同一个 URL,PC 端访问时缓存键末尾为 0,移动端访问时为 1,从而实现物理隔离。
缓存键结构对命中率的实际影响
缓存键的设计直接决定了缓存的粒度和命中率。如果仅依赖 URL,所有设备共享同一份缓存,可能导致移动端用户加载了不适合屏幕尺寸的 PC 版页面。通过引入设备标识,缓存空间被逻辑分割,虽然增加了存储开销,但保证了内容的准确性。此外,还需注意查询参数是否也参与了键的生成,以避免因参数顺序不同导致的缓存碎片化。

# 对比:未隔离的缓存键(错误示例) # proxy_cache_key "$scheme$host$request_uri"; # 结果:PC 和 Mobile 共用缓存,Mobile 可能收到 PC 页面 # 隔离后的缓存键(正确示例) # proxy_cache_key "$scheme$host$request_uri$mobile"; # 结果:PC 和 Mobile 拥有独立缓存,互不干扰
在实际运行中,可以通过查看 Nginx 的缓存状态日志或使用 proxy_cache_valid 配合监控工具来验证隔离效果。确保后端服务没有因为缓存键的变化而返回错误的状态码。同时,建议设置合理的 proxy_cache_path 目录权限,防止缓存文件读写冲突。
如何处理动态内容与缓存失效
对于包含用户个性化信息的动态页面,即使区分了设备,也可能需要更精细的控制。例如,登录后的用户信息不应被缓存,或者需要根据会话 ID 进一步隔离。此时可以在 proxy_cache_key 中加入 $cookie_session_id,或者使用 proxy_no_cache 和 proxy_cache_bypass 指令来跳过特定请求的缓存。此外,当后台内容更新时,需确保旧的设备相关缓存能被正确清理或过期,避免用户看到陈旧数据。











