Nginx 如何根据设备类型（PC/手机）访问不同目录？一份避坑指南
先明确一个核心事实：Nginx 本身并没有内置“手机/PC”的判断逻辑。但别担心，这完全可以通过正则匹配 $http_user_agent 请求头来实现。关键在于，你得用对方法。常见的思路是结合 location 或 if 指令来动态修改 root 目录，但这里有个大坑：if 指令在 location 块内是无法用来重定义 root 的，Nginx 会直接忽略它。
比如，下面这种写法就不会生效：
location / {
if ($http_user_agent ~* "Mobile") {
root /var/www/mobile;
}
}
问题出在哪？root 指令在 if 上下文中的行为是受限的。正确的做法，要么提前用 map 指令预定义变量，要么在 server 块顶层进行条件判断和设置。
推荐方案：用 map 指令预定义 $device_root 变量
要说最干净、性能最佳且被官方推荐的方式，非 map 指令莫属。它在 http 块中定义，全局生效，完美避开了 if 指令的各种陷阱。
具体操作起来很简单。在你的 Nginx 主配置文件（例如 phpEnv 中的 /phpenv/nginx/conf/nginx.conf）或站点配置文件的 http 块内，加入以下映射：
map $http_user_agent $device_root {
default "/var/www/pc";
"~*Mobile|Android|iPhone|iPad|iPod|Opera Mini|IEMobile" "/var/www/mobile";
}
定义好变量之后，在对应的 server 块中就可以直接引用了：
server {
listen 80;
server_name example.com;
root $device_root;
index index.php;
location ~ \.php$ {
fastcgi_pass 127.0.0.1:9000;
fastcgi_index index.php;
fastcgi_param SCRIPT_FILENAME $device_root$fastcgi_script_name;
include fastcgi_params;
}
}
这里有几点必须注意：
map块必须放在http块内，不能放入server或location。- 正则匹配使用了
~*进行不区分大小写的匹配，default行则作为 PC 端的兜底路径。 - 最关键的一步：在 PHP 处理块中，
SCRIPT_FILENAME参数也必须使用$device_root变量来拼接完整路径，否则 PHP-FPM 会找不到脚本文件。 - 最后，务必确保
/var/www/mobile和/var/www/pc这两个目录真实存在，并且运行 Nginx 的用户（如www-data或nginx）拥有读取权限。
为什么不推荐 try_files + rewrite 方案？
你可能还见过另一种思路：利用 try_files 检查文件是否存在，例如 try_files /mobile/$uri /pc/$uri =404。但这条路基本走不通。
原因在于，try_files 检查的是物理路径是否存在，它无法作为设备判断的逻辑起点。用户完全可能直接输入 /mobile/style.css 这样的 URL，从而绕过你的设备检测逻辑，导致控制权丢失。
更根本的问题是，try_files 不会改变 root 指令的基准路径。所有请求的路径拼接仍然基于原始的 root，这会导致 PHP 脚本的 SCRIPT_FILENAME 计算错误，最终引发 502 或 404 错误。所以，必须从源头——即 root 指令本身——进行控制，而不是依赖后续的文件回退机制。
调试与验证要点
配置写好了，部署时却可能卡住。以下几个点是高频踩雷区：
- 配置生效：修改配置后，务必执行
nginx -t测试语法，然后通过nginx -s reload重载。有时图形化管理界面（如 phpEnv 的面板）的“重启”操作可能不彻底，命令行操作更可靠。 - 测试方法：使用 curl 命令模拟移动端访问是很好的验证方式：
curl -H “User-Agent: Mozilla/5.0 (iPhone; CPU iPhone OS 16_0 like Mac OS X) AppleWebKit/605.1.15” https://localhost - 排查日志：遇到问题时，首先查看 Nginx 的错误日志（例如
/phpenv/nginx/logs/error.log）。如果看到“Primary script unknown”这类 FastCGI 错误，几乎可以断定是SCRIPT_FILENAME的路径拼接有误。 - 客户端干扰：手机浏览器开启“桌面版网站”模式时，其 User-Agent 会变成 PC 版本，导致请求落入 PC 目录。这并非配置错误，而是客户端行为，测试时需要提醒关闭此选项。
说到底，真正的难点往往不在于写出正确的正则表达式，而在于确保 PHP-FPM 处理的脚本路径与 Nginx 服务的静态资源路径，都严格对齐到同一个 $device_root 变量上。只要有一处忘了替换，整个移动站点的 CSS、JS 和 PHP 文件就可能全部报 404。细节，才是成败的关键。
