DedeCMS虚拟主机部署常见踩坑故障排查+修复指南

很多老站长现在还在用DedeCMS做内容站，毕竟上手快模板多生态全，可换虚拟主机部署踩坑那真是家常便饭对吧？比如刚传完文件就白屏，后台死活登不上，或者前台页面乱码，真的能把人急得直挠头。这事儿吧，大多是没摸透DedeCMS和虚拟主机的“小脾气”，不是什么难搞的大问题，今天就掏心窝子给你们唠唠，把我踩过的坑和解决办法全抖出来。 传完文件刷新就白屏？别急着重装系统 这应该是新手+换主机老用户最容易碰到的事了，别慌，大概率不是程序崩了，是文件权限或者是PHP版本不匹配闹的。 先说权限这块，DedeCMS某些目录对读写执行有硬性要求，就像你寄快递要给快递员打开家门的权限、拆包裹验货的权限、放门口保管的权限似的。 先把data、uploads、include、templets这几个目录的权限改对，Linux主机一般直接用FTP工具（比如FileZilla）右键选755就行，子目录记得勾选递归修改权限，Windows主机的话找主机商控制面板里的文件夹权限，把写入权限打开。 要是权限改完还白屏，那就查PHP版本。很多新一点的虚拟主机默认PHP7.4甚至8.x，可DedeCMS5.7 SP1/SP2这些主流版本，最稳的还是PHP5.6或者PHP7.0，PHP7.2偶尔也能用但得改点小代码。 改版本也简单，直接去主机商的后台找“PHP版本切换”或者“环境配置”，换成刚才说的就行，换完记得刷新下缓存（虚拟主机一般有一键清缓存，没有的话删data/caches和data/sessions里的文件）。 后台账号密码明明对，就是登不上？ 登不上后台有两种情况，一种是输入完账号密码跳转回登录页，一种是直接提示账号密码错误。 先讲第一种，跳转回登录页的话，要么是session目录不可写，要么是cookie设置有问题。 session目录刚才权限里提过，data/sessions，再确认一遍是不是给了755递归权限，要是Linux主机还可以在include/common.inc.php里手动指定session目录，代码块放这： ``` // 手动指定session存储目录（放在data/safe里更安全） session_save_path(dirname(__FILE__).'/../data/safe'); ``` safe目录记得自己在data下新建一个，权限给700最稳妥。 cookie设置的话，看你的域名有没有加www和不加www的问题，要是绑定了两个域名，就打开include/common.inc.php，找到cookie相关的配置，把$cfg_cookie_domain改成主域名，比如你的站是example.com，就改成.example.com（前面有个点，别漏），$cfg_cookie_path直接改成/就行。 提示账号密码错误？那更简单，别乱猜，直接去数据库后台改。 先登录主机商的phpMyAdmin，找到你的DedeCMS数据库，找到dede_admin表，点击“浏览”，找到你的管理员账号那行，点击“编辑”，把pwd字段改成21232f297a57a5a743894a0e4a801fc3，这个是admin的MD5加密值，保存之后用账号admin密码admin登录就行，登录完记得第一时间改密码！ 前台页面全是乱码？连logo都显示成方块 这个问题大多是编码不统一导致的，就像你写中文信给外国人，他看不懂中文就给你翻译得乱七八糟一样。 DedeCMS默认有GBK和UTF-8两个版本，你先确认下你安装的版本和虚拟主机数据库的编码是不是一致，再确认下网页模板的编码。 查数据库编码的话，同样去phpMyAdmin，选中数据库，看右侧的“整理”是不是和你的版本对应，GBK对应gbk_chinese_ci，UTF-8对应utf8_general_ci或者utf8mb4_general_ci（要是有表情符号就用utf8mb4）。 查模板编码的话，用文本编辑器（比如Notepad++）打开templets/default/index.htm这些模板文件，看右下角的编码是不是和版本一致，要是不一致直接转成对应的编码保存就行，记得勾选转换为ANSI/UTF-8 without BOM，BOM头会导致页面乱码或者头部空白哦。 图片上传不了？显示上传失败或者上传后找不到 上传失败要么是uploads目录权限不对，要么是虚拟主机的上传限制太小。 权限刚才说过uploads给755递归，要是还不行就给777临时试试（记得解决完改回755，777太不安全了）。 上传限制的话，虚拟主机一般默认是2M或者5M，要是你传大一点的高清图或者压缩包肯定不行。改这个也简单，去主机商后台找“PHP配置修改”，把upload_max_filesize和post_max_size都改成你需要的大小，比如20M或者50M，记得两个都要改，而且post_max_size要比upload_max_filesize大一点。