第一步:核心设置检查(最常见的原因)
这是最首要、最关键的检查点,确保你的网站已经开启了手机站功能。

(图片来源网络,侵删)
- 登录后台:使用管理员账号登录您的织梦后台。
- 进入“系统” -> “系统基本参数”:
- 在左侧菜单栏找到
系统->系统基本参数并点击进入。 - 在弹出的页面中,切换到 “核心设置” 选项卡。
- 在左侧菜单栏找到
- 检查并设置关键参数:
- 是否开启手机站:找到
是否开启手机站这一项,确保它的值是 “是”,如果选择“否”,后续所有设置都无效。 - 手机站域名:找到
手机站域名这一项,请务必填写您手机站的完整域名,https://m.yourdomain.com或https://www.yourdomain.com/m/。这个域名必须可以正常访问,织梦会通过这个域名来调用手机模板。 - 手机站模板目录:找到
手机站模板目录这一项,这里填写的是您手机模板文件夹的名称,您的手机模板文件夹是/templets/mobile/,那么这里就填写mobile,请确保这个目录存在并且里面有模板文件。 - 手机站默认首页:找到
手机站默认首页这一项,填写您手机站的首页模板文件名,通常是index.html。
- 是否开启手机站:找到
第二步:目录和文件检查
如果第一步的设置都正确,接下来就要检查文件和目录是否正确放置。
-
模板目录:
- 进入网站根目录下的
/templets/文件夹。 - 确认是否存在您在“基本参数”中设置的目录(
mobile)。 - 进入该目录,检查里面是否有模板文件,特别是
index.html(首页)、list_article.html(列表页)、article_article.html(文章页)等核心模板文件。
- 进入网站根目录下的
-
PC端模板调用标签:
- 打开您的PC端首页模板文件(通常是
/templets/default/index.htm)。 - 在
<head>标签内,找到用于自动切换手机站的代码,织梦默认的代码通常是这样的:<script type="text/javascript"> if(window.location.toString().indexOf('pref=padindex') != -1){}else{ if (/AppleWebKit.*Mobile/i.test(navigator.userAgent) || (/MIDP|SymbianOS|NOKIA|SAMSUNG|LG|NEC|TCL|Alcatel|BIRD|DBTEL|Dopod|PHILIPS|HAIER|LENOVO|MOT-|Nokia|SonyEricsson|SIE-|Amoi|ZTE/.test(navigator.userAgent))){ if(window.location.href.indexOf("?mobile")<0){ try{ if(/Android|Windows Phone|webOS|iPhone|iPod|BlackBerry/i.test(navigator.userAgent)){ window.location.href="{dede:global.cfg_mobileurl/}/"; }else if(/iPad/i.test(navigator.userAgent)){ window.location.href="{dede:global.cfg_mobileurl/}/" }else{ window.location.href="{dede:global.cfg_mobileurl/}/" } }catch(e){} } }} </script> - 检查
{dede:global.cfg_mobileurl/}这个标签是否正确解析,您可以在前台页面右键查看源代码,看看这段JS代码中的window.location.href的值是不是您在“基本参数”里设置的手机站域名,如果不是,说明第一步的设置可能没有生效,或者网站缓存问题。
- 打开您的PC端首页模板文件(通常是
-
手机站首页文件是否存在:
(图片来源网络,侵删)- 织梦手机站需要有一个物理入口文件来重定向,这个文件通常位于网站根目录。
- 请检查根目录下是否存在
index.php文件,织梦默认安装时,这个文件会包含一段重定向代码,将访问者引导向正确的PC或手机首页。 - 打开根目录的
index.php,检查其内容是否类似以下代码(这是织梦V5.7版本的典型代码):require_once (dirname(__FILE__) . "/include/common.inc.php"); require_once DEDEINC."/arc.partview.class.php";
$pv = new PartView(); $pv->SetTemplet($cfg_basedir . $cfg_templets_dir . "/index.htm"); $pv->Display();
* 这段代码的作用是加载PC端的首页模板,织梦会根据第一步的JS判断,如果检测到是移动设备,就会跳转到 `cfg_mobileurl` 指定的地址。**所以这个文件是必须存在的**。
第三步:缓存问题
织梦有很强的缓存机制,有时候修改了设置但前台不生效,就是因为缓存。
- 清理系统缓存:
- 登录织梦后台。
- 进入
系统->一键更新网站->更新系统缓存,点击执行。
- 清理浏览器缓存:
- 按
Ctrl + F5强制刷新浏览器页面。 - 或者打开浏览器的“无痕/隐私模式”进行访问测试。
- 按
- 清理模板缓存:
- 在后台
系统->系统基本参数->性能选项中,可以找到模板缓存目录,手动删除里面的缓存文件,或者直接通过FTP删除/data/cache/目录下的所有文件(注意:这会清除所有缓存,包括系统缓存和栏目缓存,更新后需要重新生成)。
- 在后台
第四步:伪静态规则检查
如果您的网站开启了伪静态(URL重写),手机站的跳转和访问也可能受到影响。
- 检查伪静态规则:
- 进入后台
系统->系统基本参数->核心设置。 - 找到
是否使用伪静态,确保设置正确。 - 检查您的服务器环境(Apache, Nginx, IIS)是否为织梦手机站配置了正确的伪静态规则。
- Nginx 伪静态规则示例(通常放在
/usr/local/nginx/conf/nginx.conf或网站配置文件中):rewrite "^/index\.html$" /index.php last; rewrite "^/list\/(.+)\.html$" /plus/list.php?tid=$1 last; rewrite "^/view\/(.+)\.html$" /plus/view.php?arcID=$1 last; # 手机站相关规则 if ($http_host ~* "^m\.yourdomain\.com$") { rewrite "^(.*)$" /m/$1 last; } - Apache 伪静态规则(通常放在
.htaccess文件中):<IfModule mod_rewrite.c> RewriteEngine On RewriteRule ^index\.html$ index.php RewriteRule ^list\/(.+)\.html$ plus/list.php?tid=$1 RewriteRule ^view\/(.+)\.html$ plus/view.php?arcID=$1 </IfModule>
- 请确保您的伪静态规则包含了手机站目录的访问规则。
- 进入后台
第五步:检查浏览器和设备
有时候问题可能出在访问端。
- 使用开发者工具模拟:
- 在PC浏览器上打开您的网站,按
F12打开开发者工具。 - 点击设备模拟图标(通常是一个手机或平板的图标)。
- 选择不同的设备型号(如 iPhone, Android)进行测试,观察页面是否会自动跳转到手机站。
- 在PC浏览器上打开您的网站,按
- 使用真机测试:
- 用手机连接Wi-Fi(确保和服务器在同一网络或外网可以访问),直接输入您的域名,看是否能正常显示手机模板。
- 有时可能是手机浏览器缓存或运营商DNS缓存问题,可以尝试切换网络或重启手机。
第六步:检查PHP和MySQL版本兼容性
如果您是最近升级了服务器环境(如PHP版本),可能会遇到不兼容的问题。
- 织梦DedeCMS 5.7 SP2官方推荐PHP版本为
PHP5.2到PHP7.2。 - 如果您的PHP版本过高(如PHP 7.4+)或过低,可能会导致一些功能异常,包括模板调用。
- 您可以在后台
系统->系统信息中查看当前的PHP和MySQL版本。
总结与排查流程
当遇到“织梦无法调用手机模板”时,请按以下顺序排查:
- 【首要】检查后台“系统基本参数”:确保手机站开关为“是”,手机域名、模板目录、首页文件都已正确填写。
- 【文件】检查PC端模板中的JS代码:确认
{dede:global.cfg_mobileurl/}能正确解析为您设置的域名。 - 【文件】检查网站根目录的
index.php:确认其存在且内容正确。 - 【缓存】清理所有缓存:后台系统缓存、浏览器缓存、
/data/cache/目录。 - 【环境】检查伪静态规则:确保服务器环境支持并正确配置了织梦的伪静态。
- 【工具】使用开发者工具和真机测试:排除浏览器和设备端的问题。
- 【兼容性】检查PHP/MySQL版本:排除环境不兼容的可能性。
按照这个流程,您应该能定位并解决绝大多数手机模板无法调用的问题,如果问题依旧存在,请提供您的后台设置截图、PC端首页模板的JS代码部分以及网站域名,以便进一步分析。
