DedeCMS连接数据库失败怎么办？教你快速修复
在使用 DedeCMS 搭建网站时，经常会遇到“错误警告：连接数据库失败，可能数据库密码不对或数据库服务器出错”的提示。尤其是在迁移服务器、更换主机环境后，这个问题尤为常见。
本文将详细介绍该问题的成因及解决方法，帮助您快速恢复网站运行。
如果您不确定如何操作，也可提交工单请求技术支持协助处理。
本文将详细介绍该问题的成因及解决方法，帮助您快速恢复网站运行。
一、问题原因分析
该错误通常出现在以下场景中：| 场景 | 原因说明 |
|---|---|
| 网站迁移 | 更换服务器后，程序中的数据库连接信息未更新 |
| 修改密码 | 手动更改了数据库密码但未同步到配置文件 |
| 环境变更 | 使用虚拟主机更换数据库或云服务器重新部署 |
⚠️ 根本原因：/data/common.inc.php 文件中的数据库连接参数（如用户名、密码、数据库名）与当前服务器配置不一致。
二、解决方法详解
步骤 1：找到并下载配置文件
- 登录 FTP 或主机控制面板 → 找到网站根目录。
- 进入
/data/目录 → 下载common.inc.php文件至本地。
✅ 推荐使用 EditPlus、Dreamweaver 等专业代码编辑工具打开，避免使用记事本导致 BOM 头问题。
步骤 2：修改数据库连接信息
用编辑器打开common.inc.php 文件，找到如下内容并进行修改：
php
$cfg_dbhost = 'localhost'; // 数据库服务器地址 $cfg_dbname = 'your_database'; // 数据库名称 $cfg_dbuser = 'your_username'; // 数据库用户名 $cfg_dbpwd = 'your_password'; // 数据库密码 $cfg_dbprefix = 'dede_'; // 表前缀（一般无需修改）🔍 将红色区域中的内容替换为当前服务器的数据库信息。
步骤 3：上传并覆盖文件
- 保存修改后的文件。
- 通过 FTP 上传回原路径
/data/目录，覆盖旧文件。
三、获取数据库信息的方法
根据您的主机类型，查看数据库信息的方式略有不同：| 主机类型 | 查看方式 |
|---|---|
| 虚拟主机 | 登录控制面板 → 【业务管理】→【虚拟主机管理】→【管理】→ 左侧【数据库管理】查看 |
| 云服务器（有控制面板） | 登录控制面板 → 左侧【数据库管理】查看 |
| 自建服务器 | 查看 MySQL 配置或联系运维人员核实 |
四、注意事项
| 注意事项 | 说明 |
|---|---|
| 编辑工具选择 | 切勿使用 Windows 记事本编辑，容易产生 BOM 头导致空白页错误 |
| 文件编码 | 保持原文件编码格式（通常是 UTF-8） |
| 权限设置 | 修改后建议将 common.inc.php 权限设为 644，防止被恶意篡改 |
| 测试访问 | 修改完成后刷新网站页面，确认是否恢复正常 |
总结
“DedeCMS 错误警告：连接数据库失败”是典型的配置类问题，只需正确修改/data/common.inc.php 文件中的数据库连接信息即可解决。无论是在虚拟主机、云服务器还是本地开发环境中，只要确保配置准确，就能顺利恢复网站运行。如果您不确定如何操作，也可提交工单请求技术支持协助处理。
更新时间：2025-05-19 22:34:56
上一篇：为何微擎系统推荐使用 Linux + PHP7.0 环境？