- 网站更换服务器或主机
- 数据库用户名、密码或数据库名被修改
- 手动迁移织梦网站
修改的核心是织梦的配置文件 data/common.inc.php,下面我将为你提供详细的步骤、注意事项和常见问题解答。

(图片来源网络,侵删)
核心方法:修改 data/common.inc.php 文件
这个文件是织梦系统的核心配置文件,存储了连接数据库所需的所有信息。
第一步:找到并下载配置文件
- 通过FTP或主机的文件管理器,登录到你的网站根目录。
- 找到
data文件夹。 - 进入
data文件夹,找到名为common.inc.php的文件。 - 将这个文件下载到你的本地电脑上。
注意:
data目录默认在安装织梦时会有权限设置(如禁止外部访问),这是为了安全,修改时请确保你有足够的权限。
第二步:编辑配置文件
使用任何代码编辑器(如 VS Code、Sublime Text、Notepad++ 或记事本)打开下载的 common.inc.php 文件。
你将看到类似下面这样的代码:

(图片来源网络,侵删)
<?php // database config info $cfg_dbhost = 'localhost'; // 数据库服务器 $cfg_dbname = 'dedecmsv57'; // 数据库名 $cfg_dbuser = 'root'; // 数据库用户名 $cfg_dbpwd = '123456'; // 数据库密码 $cfg_dbprefix = 'dede_'; // 数据库表前缀 $cfg_db_language = 'gbk'; // 数据库语言版本 ?>
第三步:修改数据库信息
根据你的新数据库信息,修改以上对应的变量值。
$cfg_dbhost: 数据库服务器地址,通常是localhost,如果不是(例如某些虚拟主机或云数据库会提供一个公网IP),请填写正确的地址。$cfg_dbname: 数据库名称,你的网站数据存储在这个库里。$cfg_dbuser: 数据库用户名,用于连接数据库的用户。$cfg_dbpwd: 数据库密码,对应用户名的密码。$cfg_dbprefix: 数据库表前缀。强烈建议不要修改,除非你安装织梦时自定义了前缀,并且确保所有相关的配置文件和代码都与之匹配,保持和原来一样即可。$cfg_db_language: 数据库字符集,通常是gbk或utf8。务必保持和原来一样,否则可能会导致网站出现乱码。
第四步:保存并上传文件
- 保存修改后的
common.inc.php文件。 - 通过FTP或文件管理器,将修改后的文件上传回原来的位置(
/data/目录下),覆盖原文件。
修改后的检查与验证
上传文件后,你的网站可能还不能立即正常访问,需要进行以下检查:
检查目录权限
这是最常见的问题,确保以下目录具有可写权限(通常是 755 或 777,但 755 是更安全的选择):
/data//data/common.inc.php/uploads//templets//a/(后台目录)/special/(专题目录)/plus/(附加功能目录)
如果权限不正确,请通过FTP或主机控制面板进行修改。

(图片来源网络,侵删)
清除浏览器缓存和Cookie
有时候浏览器会缓存旧的连接信息,导致看起来像没修改成功,尝试清除浏览器缓存,或使用无痕/隐私模式访问网站。
检查数据库用户权限
确保你设置的数据库用户名和密码拥有对 $cfg_dbname 这个数据库的所有权限(包括 SELECT, INSERT, UPDATE, DELETE, CREATE, DROP, ALTER 等)。
使用织梦后台修复工具
如果网站后台可以登录,可以进入后台的【系统】-> SQL命令行工具,执行以下SQL来修复可能出现的 session 问题:
DELETE FROM `dede_adminsessions`;
(注意:如果你的表前缀不是 dede_,请替换成你自己的前缀)
常见问题与解决方案 (FAQ)
Q1: 修改后网站打不开,显示“无法连接数据库”或空白页。
A1: 这是最常见的问题,请按以下顺序排查:
- 检查
common.inc.php中的数据库信息是否完全正确,特别是密码,容易多打或少打空格。 - 检查目录权限,特别是
/data/和common.inc.php的权限是否正确。 - 检查数据库服务器地址
$cfg_dbhost是否为localhost,如果不是,确认正确的地址。 - 联系你的主机服务商,确认数据库服务是否正常,以及你提供的用户名密码是否正确。
Q2: 网站可以打开,但后台登录后立即跳转到登录页面,或者所有页面都是空白。
A2: 这通常是 session 存储路径的问题。
- 登录你的网站根目录,检查是否存在
/data/session/目录。 - 如果不存在,请手动创建一个名为
session的文件夹。 - 确保
session文件夹有可写权限(通常是 755 或 777)。 - 如果已存在,请检查其权限是否正确。
Q3: 修改后网站出现乱码。
A3: 几乎可以肯定是 $cfg_db_language 配置项与数据库实际字符集不一致。
- 登录你的数据库管理工具(如 phpMyAdmin)。
- 查看你的数据库(
$cfg_dbname)的“整理”或“字符集”设置,是utf8_general_ci还是gbk_chinese_ci。 - 回到
common.inc.php文件,确保$cfg_db_language的值与之对应(utf8或gbk)。
重要提醒
- 操作前备份:在进行任何修改之前,务必备份你的网站文件(特别是
/data/目录)和数据库,这是防止操作失误导致网站崩溃的最后一道防线。 - 安全第一:修改完成后,如果网站不再需要安装目录(
install/),请将其删除或重命名,以防止被恶意利用。 - 寻求帮助:如果自己无法解决,不要犹豫,立即联系你的主机服务商或织梦技术支持社区,提供你已尝试过的步骤和错误信息,以便他们能更快地帮助你。
希望这份详细的指南能帮助你顺利完成织梦数据库信息的修改!
