在 nginx 中根据设备类型(pc/mobile)设计缓存键,核心做法是利用 `map` 指令将 http 请求头中的 user-agent 解析为标识符,并将其作为变量嵌入到 proxy_cache_key 中。这样配置后,nginx 会分别为 pc 端和移动端生成独立的缓存文件,确保不同设备的用户访问时能命中各自专属的缓存内容,避免页面错乱。

如何定义 User-Agent 的设备识别逻辑
要实现上述功能,首先需要解决的是如何将杂乱的 User-Agent 字符串转化为明确的 pc 或 mobile 状态。这通常通过 map 块配合正则表达式来完成。在 Nginx 配置文件的 http 上下文中,可以定义一个变量(例如 $device_type),并设置匹配规则:如果 User-Agent 包含特定的移动设备关键词(如 Android, iPhone 等),则赋值为 mobile;否则默认赋值为 pc。这一步是后续缓存分发的基础,确保了判断逻辑的准确性与可维护性。

http {
# 定义设备类型映射
map $http_user_agent $device_type {
default "pc";
~*Android "mobile";
~*iPhone "mobile";
~*iPad "mobile";
}
server {
listen 80;
server_name example.com;
location / {
proxy_pass http://backend;
# 启用缓存
proxy_cache my_cache;
# 关键:将设备类型加入缓存键
proxy_cache_key "$scheme$host$request_uri$device_type";
}
}
}
缓存键的具体构成与冲突规避
确定设备标识后,下一步是构建最终的 proxy_cache_key。缓存键必须唯一标识一份缓存内容,因此不能仅依赖 $request_uri,否则 PC 和 Mobile 的请求会互相覆盖。正确的做法是将 $device_type 变量拼接在标准缓存键之后,形成类似 http://example.com/page?param=1mobile 的字符串。这种结构保证了同一 URL 在不同设备下拥有不同的哈希值,从而存储在不同的缓存文件中。同时,需注意若 URL 中包含动态参数,应确保这些参数也被纳入缓存键,以防止因参数不同但设备相同导致的缓存命中率下降或内容错误。

# 假设后端返回 HTML,前端通过 JS 区分渲染 # 此处展示完整的 cache key 构造逻辑 # 实际配置中,proxy_cache_key 行如下: # proxy_cache_key "$scheme$host$request_uri$device_type"; # 验证示例: # 请求 1: GET /index.html (User-Agent: Chrome on Windows) # -> $device_type = "pc" # -> Cache Key: "httpexample.com/index.htmlpc" # -> 命中/写入缓存 A # 请求 2: GET /index.html (User-Agent: iPhone Safari) # -> $device_type = "mobile" # -> Cache Key: "httpexample.com/index.htmlmobile" # -> 命中/写入缓存 B # 结果:两个请求分别获得针对 PC 和 Mobile 优化的响应内容
当 User-Agent 为空或缺失时会发生什么
在实际运行中,部分爬虫、内部监控工具或极简客户端可能不发送 User-Agent 头,或者其值为空。此时,map 指令的行为决定了系统的健壮性。在上述配置中,我们设置了 default "pc";,这意味着任何未明确匹配到移动设备特征(包括 UA 为空的情况)的请求,都会被归类为 pc。这一设计避免了因 UA 缺失导致 $device_type 为空字符串,进而引发缓存键不一致或意外共享缓存的问题。开发者应意识到,这种“默认视为 PC”的策略适用于大多数面向公众的网站,但对于强依赖 UA 的内部 API 服务,可能需要调整默认值或增加额外的日志监控以排查异常流量。











