nginx 不支持基于浏览器类型的业务逻辑降级,但可通过 map 指令识别 ua 特征生成变量,在 location 中实现静态资源路径切换、压缩策略调整、协议回退等体验降级。

在 Nginx 中,不能直接基于浏览器类型“降级功能”(比如禁用某个 API 或隐藏某块 HTML),但可以针对不同浏览器的软硬件能力、协议支持或兼容性限制,对响应内容、压缩策略、协议协商或资源路径做差异化处理——这本质是“体验降级”或“能力适配”,而非业务逻辑降级。
识别浏览器并生成决策变量(用 map)
核心是利用 map 指令从 $http_user_agent 提取特征,生成可复用的布尔或字符串变量,供后续 location 判断:
- 区分老旧浏览器(如 IE11 及以下):
map $http_user_agent $is_legacy_ie {<br> ~*msie|trident 1;<br> default 0;<br>} - 识别低性能设备(如旧 Android WebView 或低端平板 UA):
map $http_user_agent $is_lowend_device {<br> ~*android.*samsung|lenovo.*a3500 1;<br> ~*mobile.*gt\-i9100|sm\-t210 1;<br> default 0;<br>} - 判断是否支持现代压缩(Brotli):
map $http_accept_encoding $use_brotli {<br> ~*br 1;<br> default 0;<br>}
在 location 中按需应用降级策略
把上述变量注入具体资源路径的处理逻辑中,避免全局影响。例如针对静态 JS/CSS 资源:
- 对老旧 IE 强制返回未压缩、无 ES6 语法的兼容版本:
location ~* \.(js|css)$ {<br> if ($is_legacy_ie) {<br> rewrite ^(.*)\.(js|css)$ /legacy$1.$2 break;<br> }<br> # 正常走 gzip/brotli 压缩<br>}
前提:提前准备/legacy/xxx.js文件,放在与原路径同级目录下。 - 对低性能设备关闭 Brotli,改用轻量 gzip:
location ~* \.(js|css|woff2)$ {<br> gzip on;<br> gzip_types application/javascript text/css font/woff2;<br> brotli off;<br> if ($is_lowend_device) {<br> brotli off;<br> gzip_comp_level 3;<br> }<br>}
配合协议与资源加载行为做兼容兜底
浏览器能力差异也体现在 HTTP 协议和资源加载机制上,这些可通过 location 分层控制:
- 对不支持 HTTP/3 的客户端(如旧版 Safari 或未开启 QUIC 的 Chrome),确保 TCP+HTTP/2 通道始终可用:
在 server 块中必须同时存在:listen 443 ssl http2;<br>listen 443 quic reuseport;
这样即使 QUIC 失败,也会自动回落到 HTTP/2,无需 location 干预。 - 对不支持
crossorigin或模块化 script 的浏览器,用 location 重写资源请求至兼容入口:location /assets/js/module/ {<br> if ($is_legacy_ie) {<br> rewrite ^/assets/js/module/(.*)$ /assets/js/compat/$1 break;<br> }<br>}
注意边界与限制
纯 Nginx 无法修改 HTML 内容或动态插入 polyfill,所以“浏览器降级”只能作用于:
— 静态资源路径选择
— 响应头(如 Vary: User-Agent)
— 压缩方式与级别
— 协议协商头(如 Alt-Svc)
— 重定向或内部跳转目标
若需更深度的 DOM 层降级(如替换 script 标签、注入 shim),必须由前端框架或边缘计算(如 Cloudflare Workers / OpenResty Lua)完成。











