安装环境检测不通过，卡在第一步
报错现象： 点击“下一步”后，页面反复跳回环境检测页，提示“GD库未安装”“MySQL扩展缺失”“allow_url_fopen未开启”等红字警告。
织梦CMS一键生成中断？七年运维老手的硬核排坑指南
原因分析： 织梦CMS对PHP环境有硬性要求，尤其是GD库用于图片水印和缩略图生成，MySQL扩展负责数据库通信，很多云服务器或虚拟主机默认安装的是精简版PHP，会砍掉这些模块，PHP版本过高（如8.0以上）反而会导致兼容性问题，织梦CMS在5.6-7.4版本上最稳。
解决步骤：
- 换PHP版本：登录服务器面板（宝塔/AppNode/AMH），把PHP切换到7.3或7.4，别用8.0+。
- 安装缺失扩展：在面板的“PHP扩展”列表里，勾选
gd、mysqli、pdo_mysql、curl、openssl，然后重启PHP服务。 - 开启allow_url_fopen：在PHP配置文件
php.ini里搜索allow_url_fopen，把值设为On，如果用的是宝塔，直接在“PHP设置-禁用函数”里删除allow_url_fopen（它不在禁用列表里，而是单独开关）。 - 检查目录权限：安装目录下
data、uploads、templets文件夹必须设置为755权限，且拥有者为www用户（否则织梦无法写配置文件和缓存）。
后台登录异常——要么白屏，要么提示“验证码错误”
报错现象： 输入管理员账号密码后，页面无任何反应、白屏，或者明明输入正确的验证码却一直报错，更离谱的是，在Chrome上正常，换Edge就崩。
原因分析：
织梦CMS后台验证码依赖GD库的session机制，如果PHP配置里session.save_path不可写，或者session.auto_start被设置为On导致冲突，就会翻车，白屏多半是模板文件被加密过、PHP内存不足或error_reporting级别过高导致致命错误。
解决步骤：
- 修复验证码循环：打开
/include/helpers/check.helper.php，找到CheckCaptcha()函数，把session_start()前面加上符号抑制错误：@session_start();。 - 清理session目录：进入
/tmp目录，执行chmod 777 sess_*并删除所有session文件，然后给/var/lib/php/session设置777权限。 - 开启调试模式：在
/data/config.cache.inc.php里定义define('DEDE_DEBUG', true);，刷新后台页面看具体报错，常见报错是Call to undefined function dede_html2text()，那就去下载完整CMS包覆盖/include目录。 - 关闭验证码：临时方案——进入数据库
dede_sysconfig表，把cfg_captcha_admin值设为N，直接跳过验证码登录。
页面空白或乱码——前端首页一片惨白
报错现象： 打开网站首页，浏览器里什么都没有，或者满屏的“锟斤拷”乱码，但后台正常，用开发者工具看源代码，发现只有几个空标签。
原因分析：
90%的空白页是因为模板文件中存在语法错误，比如{dede:arclist}少写了，或者{dede:field name='typename'}里的单双引号混用，乱码则一定是文件编码不一致——模板文件用GBK，数据库却是UTF-8，或者反过来。
解决步骤：
- 强制显示错误：在
/include/arc.archives.class.php顶部加入error_reporting(E_ALL); ini_set('display_errors', 1);，刷新页面，一般会看到类似Parse error: syntax error, unexpected '('的信息。 - 检查模板标签语法：找到报错所指向的模板文件（通常是
/templets/default/index.htm），逐行检查花括号闭合，常见坑是{dede:channel}的type='son'写成type=son（没加引号）。 - 统一编码：如果数据库是UTF-8，确保所有模板文件用UTF-8无BOM格式保存（用Notepad++转码），修改
/include/common.inc.php，把$cfg_soft_lang强制设为utf-8。 - 重置缓存：删除
/data/tplcache目录所有文件，然后重新生成首页静态页。
模板标签调用无效——“调用arclist没反应”
报错现象：
在模板里写{dede:arclist typeid='1' row='10'}，结果页面上什么都不显示，或者显示“Arclist标签调用错误”，换成{dede:channel}和{dede:type}也一样。
原因分析：
织梦的标签解析依赖/include/taglib/目录下的对应PHP文件，文件被删除、权限不对，或者data/config.cache.inc.php里$cfg_tplcache缓存参数异常，都会导致标签被当成普通文本，没在后台更新“模板风格缓存”也是新手常犯的错。
解决步骤：
- 确认标签库文件存在：检查
/include/taglib/里有没有arclist.lib.php，如果没有，从官方安装包补全。 - 清空标签缓存：登录后台，点击“系统→系统基本参数→更新系统缓存”，或者直接删除
/data/module目录下的所有缓存文件。 - 检查数据表前缀：如果数据库前缀不是默认的
dede_，需要在/data/common.inc.php里修改$cfg_dbprefix的值，否则标签无法正确查询。 - 手动测试标签：在模板里直接用
[field:global.autoindex/]这类基础标签测试，如果连这都不行，说明模板解析引擎挂了，重装/include文件夹。
生成静态页报错——“生成HTML失败，请联系管理员”
报错现象： 在后台点击“生成→更新主页/更新栏目/更新文档”时，进度条走到一半突然弹红框，提示“生成失败”，并且生成页面里只生成了一篇文档后停住。
原因分析：
织梦生成静态页是串行的，一旦某篇文章的标题或正文包含无法转义的字符（如表情符号、特殊HTML实体），或者文章中的图片地址是外链且无法访问，就会卡死，更常见的是/data/index.html被锁死，或者PHP执行时间不足。
解决步骤：
- 增加PHP执行时间：在
/data/config.cache.inc.php里添加set_time_limit(0);，让脚本无限制执行，或者修改php.ini的max_execution_time = 300。 - 开启“忽略错误”：在“生成HTML”页面底部勾选“强制模式”，让系统跳过有问题的文章，如果不生效，直接修改
/dede/makehtml_archives_action.php，找到foreach($ArcQuery as $k=>$v)，在前面加一行@set_time_limit(0);。 - 排查问题文章：分批次生成，比如一次选10篇文档，找到哪篇卡住，把那篇文章的标题中的特殊字符删掉，或者进入数据库
dede_archives表，把title字段里的emoji过滤掉。 - 删除锁文件：检查
/data/index.html.lock这类.lock文件，手动删除后再试试。
数据库连接失败——“连接数据库失败，请检查数据库连接”
报错现象： 网站突然打不开，后台也进不去，只显示“连接数据库失败：Access denied for user ‘dede’@‘localhost’”，或者提示“MySQL server has gone away”。
原因分析： 最直观的原因是数据库密码被改了、数据库服务挂了、或者磁盘满了导致MySQL无法写入临时文件，织梦的重连机制较弱，一旦连接中断不会自动恢复，如果用了云数据库但IP白名单没配好，也会报错。
解决步骤：
- 验证数据库服务状态：通过SSH执行
systemctl status mysql，如果没运行就systemctl restart mysql，检查磁盘：df -h，如果使用率100%，删除/tmp下的临时文件或清理日志。 - 核对连接信息：打开
/data/common.inc.php，确认$cfg_dbuser、$cfg_dbpwd、$cfg_dbname、$cfg_dbhost是否正确，尤其注意$cfg_dbhost，如果数据库在本地用localhost，用云数据库填内网地址。 - 重置密码：进入MySQL命令行，执行
ALTER USER 'dede'@'localhost' IDENTIFIED BY '新密码';，然后同步修改common.inc.php。 - 修复表结构：用
mysqlcheck -r dede_数据库名命令修复所有表，如果提示“Table is marked as crashed”，用repair table dede_archives;单独修复。
最后说一句：以上所有操作前，第一件事是备份/data目录和整个数据库，织梦CMS的很多问题，根源都在缓存和编码混乱上，养成“先清缓存、再查报错”的习惯，能省下80%的排查时间，如果按步骤操作后还是不行，十有八九是服务器环境本身有木马或文件权限锁死，这时就该考虑换回官方纯净包重新部署了。
