dedecms数据库迁移后配置文件修改方法_数据库连接信息更新
dedecms数据库备份迁移说难不难，说简单也不简单。难在细节——表前缀不一致会还原失败，编码不匹配会出现乱码，附件没同步会图片全裂。简单在流程固定，按步骤操作基本不会出问题。本文把固定流程和易错细节同时呈现，让新手也能一次成功完成备份迁移。
把原网站的全部文件通过FTP下载到本地，再上传到新服务器对应目录。重点目录包括uploads附件目录、templets模板目录、data配置目录、include核心目录，这几个目录缺一不可。上传完成后设置目录权限，data目录和uploads目录需要写入权限，Linux下设为755或777。
还原数据库有两种方式。方式一用dedecms后台还原：把备份分卷文件上传到新服务器的data/backupdata/目录，登录新服务器的dedecms后台，进入「系统」-「数据库备份/还原」，点击「数据还原」，选择对应备份批次，点击「开始还原数据」即可。
后台备份时提示「备份目录不可写」，是因为data/backupdata/目录没有写入权限。Linux服务器用chmod命令设置该目录权限为755或777，Windows服务器在目录属性中给IIS用户添加写入权限。权限设置完成后刷新备份页面即可正常导出。
迁移后图片全部不显示，原因是uploads附件目录没有完整上传，或者附件路径配置错误。先检查uploads目录是否存在且包含所有图片文件，再检查后台系统参数中的「附件保存位置」是否正确。如果更换了域名，文章内容中的图片地址可能还是旧域名，需要用SQL批量替换。
迁移后页面出现乱码，通常是数据库编码不匹配导致。原数据库如果是gbk编码，新数据库创建时选了utf8，导入后中文就会乱码。解决方法是在新服务器创建与原数据库相同编码的数据库，或者在导入时指定正确的字符集。dedecms后台也可以在系统参数中调整编码设置。
数据库还原完成后，必须修改data/common.inc.php配置文件中的数据库连接信息。用文本编辑器打开这个文件，找到$cfg_dbhost、$cfg_dbname、$cfg_dbuser、$cfg_dbpwd这四个变量，分别替换为新服务器的数据库地址、数据库名、用户名、密码，保存后上传覆盖。
如果迁移后使用了新域名，需要在后台「系统」-「系统基本参数」中修改「网站根网址」为新域名，同时在「核心」-「网站栏目管理」中检查每个栏目的绑定域名是否需要更新。修改完成后进入「生成」-「一键更新网站」，重新生成所有静态页面。
dedecms的缓存文件需要在迁移后全部清理。进入data目录，删除cache、tplcache、sessions这三个子目录下的所有文件，保留目录本身。缓存中保存了旧服务器的路径信息和编译后的模板，不清理会导致页面显示异常或路径错误。
站长实操反馈：「按照这套步骤把dedecms站从老虚拟主机迁到阿里云，数据库200多MB，用phpmyadmin分卷导入一次成功，栏目文章附件全部正常，没有丢数据」「之前自己迁移老是图片不显示，这次按文中说的检查uploads目录和路径配置，问题很快定位到了」。
安全提醒：数据库备份文件包含网站全部数据，下载和传输过程中注意保密，不要在公共网络环境下传输未加密的备份文件。备份文件建议压缩加密后存储，解压密码使用复杂组合。废弃的备份文件要彻底删除，避免被他人获取导致数据泄露。
更新时间：2026-09-01 14:01:11