nginx移动端适配需用server块顶层if判断可靠ua正则，return 302跳转并携带$request_uri防丢参、防循环、禁用permanent；m站不自动跳回pc，仅提供手动入口。
在 Nginx 中用 server 块配合 rewrite 实现移动端适配，核心是根据 $http_user_agent 判断设备类型，并用 return 302 或 rewrite ... redirect 做临时跳转。关键不是“能不能跳”，而是“跳得准、跳得稳、不循环、不缓存”。
判断依据要可靠
仅靠关键词匹配 UA 字符串，不能只写 mobile 或 android —— 很多桌面浏览器（如 Chrome DevTools 模拟）或微信内置浏览器也会带这些词，导致误判。
- 推荐用更严谨的正则，覆盖主流移动 UA 特征：
if ($http_user_agent ~* "(Android|iPhone|iPad|iPod|BlackBerry|IEMobile|Opera Mini|Mobile)") { - 排除常见干扰项，比如加额外条件：
if ($http_user_agent ~* "(Android|iPhone)" && $http_user_agent !~* "Chrome.*Desktop") { - 避免在
location内重复判断；统一放在server块顶层，便于维护
跳转必须用 302，禁用 permanent
移动端适配是动态策略，可能随业务调整。一旦用了 permanent（即 301），浏览器和 CDN 会强缓存跳转结果，改配置后用户仍被旧规则跳走，排查极难。
- ✅ 正确写法：
return 302 https://m.example.com$request_uri; - ❌ 错误写法：
rewrite ^(.*)$ https://m.example.com$1 permanent;→ 实际发 301，不可逆 - 不用
rewrite ... redirect也可，但return 302更直观、无重写解析开销，推荐优先使用
防止 PC 与 M 站互相跳转形成死循环
常见错误：PC server 块里跳去 M 站，M server 块里又无条件跳回 PC 站，用户点“电脑版”瞬间又被弹回去。
- PC server 块中加跳转时，先排除已带
m.的请求：if ($host != "m.example.com" && $http_user_agent ~* "(Android|iPhone)") { return 302 https://m.example.com$request_uri; } - M server 块中加“返回 PC 版”链接时，不要自动跳转；只提供手动入口（如页脚“电脑版”链接），或加明确标识参数（如
?desktop=1）再做条件跳转 - 可设 cookie 或 query 参数标记用户偏好，后续请求跳过 UA 判断，提升体验和稳定性
保留原始路径和参数
跳转时丢失 query string（如 ?id=123&ref=share）会导致功能异常，比如分享链接失效、登录态中断。
- 务必用
$request_uri，它包含完整 URI（路径 + 查询参数）
→return 302 https://m.example.com$request_uri; - 避免用
$uri（不含 query）或硬编码路径，否则/article/1?utm=abc会变成/article/1，丢参数 - 若需统一处理参数（如过滤 tracking 参数），可用
set配合正则提取，但非必需场景建议保持原样
