正确写法是RewriteCond %{HTTP_USER_AGENT}，大小写敏感需加[NC]，多关键词用|连接，重定向必须带[R=302,L]，排除白名单用!pattern且顺序在前，调试须开启rewrite:trace3日志。
Apache里用RewriteCond匹配User-Agent的正确写法
直接用 RewriteCond %{HTTP_USER_AGENT}，别写成 %{USER_AGENT} 或 %{HTTP_USER_AGENT_STRING}——后者根本不存在，Apache会静默忽略该条件，重定向不生效却查不出错。
匹配时注意大小写：默认是大小写敏感的。移动端常见字符串如 Mobile、iPad、Android 首字母大写，但有些爬虫或旧客户端可能全小写。稳妥起见加 [NC] 标志：
RewriteCond %{HTTP_USER_AGENT} mobile [NC]
多个关键词用 \|（反斜杠竖线）连接，不是 || 或空格：
RewriteCond %{HTTP_USER_AGENT} (mobile|android|iphone|ipad) [NC]
重定向到不同域名时必须加[R=302]和[L]标志
漏掉 [R] 会导致内部重写而非外部跳转，浏览器地址栏不变，用户感知不到跳转；漏掉 [L] 则后续规则仍会执行，可能触发意外覆盖或循环重定向。
生产环境首次上线建议用 [R=302]，确认逻辑无误后再切为 [R=301]。301被浏览器和CDN强缓存，一旦配错很难立即回滚。
完整示例（将移动流量导向 m.example.com）：
RewriteEngine On<br>RewriteCond %{HTTP_USER_AGENT} (mobile|android|iphone|ipad) [NC]<br>RewriteCond %{HTTP_HOST} ^example\.com$ [NC]<br>RewriteRule ^(.*)$ https://m.example.com/$1 [R=302,L]
注意：^example\.com$ 中的点号必须转义，否则匹配任意字符；$1 是对 ^(.*)$ 的捕获，保留原始路径。
排除特定User-Agent避免误伤
微信内置浏览器、QQ浏览器、部分安卓桌面版都带 Mobile 字样，但实际需要桌面体验。不能只靠“含 Mobile 就跳转”，得加白名单排除。
用负向匹配（!pattern）在 RewriteCond 前加叹号：
Apache Superset 是一个广泛采用的开源 BI 平台，用于 SQL 探索、图表构建和仪表板交付。当代理需要查询仓库数据、组装仪表板或使用成熟的分析界面解释指标而不是临时笔记本代码时，此技能非常有用。
RewriteCond %{HTTP_USER_AGENT} !(MicroMessenger|QQBrowser|Chrome.*Android) [NC]
顺序很重要：先排除白名单，再匹配移动关键词，否则排除无效。规则按从上到下执行：
RewriteCond %{HTTP_USER_AGENT} !(MicroMessenger|QQBrowser) [NC]<br>RewriteCond %{HTTP_USER_AGENT} (mobile|android|iphone) [NC]<br>RewriteRule ^(.*)$ https://m.example.com/$1 [R=302,L]
注意：正则中不要用过于宽泛的模式，比如 .* 单独出现可能匹配空字符串，引发非预期行为。
调试时开启mod_rewrite日志很关键
Apache 默认不记录重写过程，光看访问日志看不出哪条规则生效、哪个条件失败。必须手动开启：
在虚拟主机或主配置中加入：
RewriteLogLevel 3<br>RewriteLog "/var/log/apache2/rewrite.log"
⚠️ Apache 2.4+ 已废弃 RewriteLog 和 RewriteLogLevel，改用通用日志机制：
LogLevel alert rewrite:trace3<br>LogFormat "%h %l %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-Agent}i\" %{rewrite}e" combined
然后在 VirtualHost 里指定 ErrorLog，日志里会出现 [rewrite:trace3] 行，清晰显示每个条件是否匹配、变量值是多少。没开这个，等于闭眼调规则。
真实环境中，User-Agent 字符串长度可能超 256 字节，某些精简 UA（如 IoT 设备）可能为空，%{HTTP_USER_AGENT} 在为空时值为 null——这会导致整条 RewriteCond 判定为 false，但不会报错，也不易察觉。
