织梦CMS内容页生成失败？别慌，运维老手教你5分钟精准排雷

安装环境检测不通过，卡在第一关

织梦CMS内容页生成失败？别慌，运维老手教你5分钟精准排雷

报错现象：
本地或服务器安装织梦CMS时，系统提示“PHP版本过低”“GD库未开启”或“目录权限不足”，安装进度条直接卡死,无法进入下一步。

原因分析：
织梦CMS对运行环境有硬性要求：PHP 5.4~7.0（推荐5.6）、必须开启GD库（用于图片水印和验证码）、data和uploads目录需可写，很多站长用了过新的PHP版本（如7.4），或虚拟主机默认关闭了扩展,导致检测脚本直接判死。

解决步骤：

1. 切换PHP版本：进入宝塔面板或虚拟主机控制台，将PHP版本改为5.6（或5.4/5.5），同时确认“防跨站攻击”已关闭。
2. 开启GD库：在php.ini中找到extension=php_gd2.dll（Windows）或extension=gd.so（Linux），去掉行首分号保存，或在宝塔中直接点击“安装扩展”一键开启。
3. 修改目录权限：用FTP工具登录，将data、uploads、templets三个文件夹权限设为777（右键属性，勾选“可写”）。
4. 重跑安装：删除install目录下的install.lock文件，关闭防火墙拦截，重新访问安装页面,检测项应全绿。

后台登录异常，验证码不显示或提示密码错误

报现象：
后台地址输完账号密码，点击登录后页面无反应，或验证码图片显示红叉；直接提示“密码错误”,但明明刚改过密码。

原因分析：
90%是浏览器缓存旧Session或验证码文件损坏，织梦后台登录依赖GD库生成验证码，若GD库未正确加载，验证码就会失效；另一些情况是服务器时间不准,导致Cookie过期。

解决步骤：

1. 清缓存换浏览器：按Ctrl+F5强制刷新，或换Chrome无痕模式尝试登录。
2. 手动重置密码：进入phpMyAdmin，找到dede_admin表，将pwd字段改为e10adc3949ba59abbe56e057f20f883e（这是md5加密的“admin”），userid改为你的账号，保存后即可用密码“admin”登录。
3. 删除旧验证码缓存：打开data/cache目录，清空所有*.php文件（保留index.html），然后重新登录。
4. 修复文件权限：检查data/sessions目录是否存在且可写,不存在则手动创建并赋予777权限。

页面空白或乱码，前台打开像一堆“天书”

报现象：
首页能访问，但点进任何文章页全是白屏，或显示一堆���Dz���之类的乱码；偶尔地址栏有参数,但内容死活不出来。

原因分析：
空白多半是模板文件语法错误（比如{dede:arclist}写成了{dede:arclist}，少了冒号）或PHP报错被隐藏，乱码则是编码不一致，常见于模板文件保存成了UTF-8带BOM,而数据库是GBK。

解决步骤：

1. 开启调试：在data/config.cache.inc.php中找到$_cfg_php_error，改为1；同时访问页面，浏览器按F12看Console报错，定位具体文件行号。
2. 修复模板标签：用编辑器（如Notepad++）打开报错行，检查所有{dede:xxx}标签，确保标签名、属性引号成对，且不包含中文字符括号。
3. 统一编码：用记事本或VS Code将模板文件另存为UTF-8无BOM格式，并在后台“系统-系统基本参数”中把“页面编码”设为与数据库一致（如UTF-8）。
4. 清空缓存：删除data/tplcache目录下的所有文件，后台“生成-更新系统缓存”重新生成。

模板标签调用无效，想调出文章却啥也没有

报现象：
在模板里写了{dede:list pagesize='10'}，但前台只显示一行空白或“列表为空”,文章页能正常访问单个内容。

原因分析：
通常是因为未指定typeid（栏目ID）或列表页模板与文章页模板混用，织梦的list标签属于列表页专用，在内容页（article.html）里必须用prenext、field标签，否则无数据输出,标签参数中的单引号在PHP中被转义也会导致失效。

解决步骤：

1. 区分模板场景页用{dede:field.title/}、{dede:field.body/}，列表页用{dede:list}，若需要在内容页显示同栏目文章，改用{dede:likearticle}或{dede:arclist typeid='栏目ID'}。
2. 检查typeid取值：在后台“内容管理-栏目管理”复制栏目ID（如5），然后在标签中写typeid='5'。
3. 删除重载标签：如果模板里有重复的{dede:list}，只保留一个，多余的删掉。
4. 测试标签：在模板底部加一行{dede:field.typeid/}，看输出数字是否为当前栏目ID，若为0则说明栏目绑定失效,重新编辑栏目并保存。

生成静态页报错，提示“目录不存在”或“写入失败”

报现象：
后台“生成-更新文档”时，进度条走到一半弹窗“Warning: mkdir() ... No such file or directory”，或直接提示“保存html失败，请检查目录权限”。

原因分析：
多为栏目路径过深（如a/b/c/d）而服务器PHP不允许递归创建目录；或静态文件目录data/sitemap不存在；更常见的是栏目设置中的URL跳转型错误，导致生成路径变成/a/b/../c这种非法路径。

解决步骤：

1. 手动建目录：在FTP中按栏目层级依次建立文件夹（如a下建b，b下建c），确保最底层目录可写。
2. 重置栏目URL方式：后台“栏目-更新栏目”中，将“栏目文件保存目录”改为“自动生成”，保存后重新生成。
3. 修改PHP配置：在php.ini中搜索allow_url_fopen设为On，并确认open_basedir为空（某些主机锁定了目录，注释掉该行）。
4. 关闭伪静态干扰：若开启了伪静态，暂时在后台“系统-核心设置”中关闭“使用伪静态”，生成纯静态文件后测试,成功后再开回。

数据库连接失败，网站直接躺平

报现象：
前台访问直接显示“Data not found”或“数据库连接失败，请检查数据库配置”，后台也打不开,白底黑字一行错误。

原因分析：
要么数据库密码被改，要么data/common.inc.php文件被损坏（比如迁移主机时忘记改配置），要么数据库服务挂了（比如MySQL进程被kill）。

解决步骤：

1. 检查数据库服务：服务器上运行systemctl status mysql（或service mysqld status），确保进程在跑；若挂了执行systemctl start mysql。
2. 核对配置：用编辑器打开data/common.inc.php，检查$cfg_dbname（库名）、$cfg_dbuser（用户名）、$cfg_dbpwd（密码）是否正确，通常迁移主机后这三项必须手动改。
3. 后台修复工具：如果前台都打不开，直接访问/install/index.php，选择“修复数据库表”，输入数据库信息尝试修复。
4. 重置密码：用phpMyAdmin进入数据库，执行ALTER USER '你的用户名'@'localhost' IDENTIFIED BY '新密码';，然后同步修改common.inc.php，若实在不行，最快方法是把数据库导出SQL，重装织梦后导入,但记得改后台密码和上传目录权限。