如何解决织梦CMS连接数据库失败的错误？配置、权限、服务全排查
织梦CMS（DedeCMS）提示"连接数据库失败"或"数据库连接错误"，是常见问题。织梦的数据库配置在data/common.inc.php，按下面排查。
第一步，确认MySQL服务运行。宝塔-软件商店-MySQL，状态"已运行"。或SSH执行/etc/init.d/mysqld status。没运行就启动，启动失败看错误日志（参考MySQL无法启动排查）。
第二步，检查配置文件。织梦数据库配置文件：data/common.inc.php。内容包括： ```php $cfg_dbhost = 'localhost'; // 数据库主机，本地用localhost $cfg_dbname = '数据库名'; // 数据库名 $cfg_dbuser = '用户名'; // 数据库用户名 $cfg_dbpwd = '密码'; // 数据库密码 $cfg_db_language = 'utf8'; // 字符集 ``` 对比宝塔-数据库里的数据库名和用户名。注意：1. 数据库名和用户名可能不同，宝塔创建时默认同名，但可以不同。2. 密码是数据库密码，不是宝塔面板密码，也不是后台管理员密码。3. 引号、分号不能少，PHP语法错会500。4. data目录权限要可写，织梦会写缓存和session。
第三步，测试数据库连接。命令行测试：mysql -u用户名 -p密码 数据库名，能进mysql>说明连接正常，是配置文件问题；连不上看报错。报错对照：Access denied (1045)→用户名或密码错；Unknown database (1049)→数据库名错；Can't connect (2002)→MySQL没启动或socket错。
第四步，数据库用户权限。宝塔-数据库-对应数据库-权限，确认用户有所有权限。或SQL：SHOW GRANTS FOR '用户名'@'localhost';。没有权限就重新授权：GRANT ALL ON 数据库名.* TO '用户名'@'localhost' IDENTIFIED BY '密码'; FLUSH PRIVILEGES;
第五步，数据库是否存在。宝塔-数据库看数据库在不在，phpMyAdmin登录看能不能看到数据库。被删除了就从备份恢复。
第六步，data目录权限。织梦的data目录需要写入权限，存缓存、session、上传文件。权限不对可能导致各种问题，包括数据库连接相关的session问题。chown -R www:www /www/wwwroot/域名/data，chmod -R 755 /www/wwwroot/域名/data。
第七步，字符集问题。织梦老版本用gbk，新版本用utf8。配置文件的$cfg_dbpwd_language和数据库字符集要一致。不一致可能导致乱码或连接问题（一般是乱码不是连接失败）。创建数据库时选和程序一致的字符集。
第八步，MySQL8.0兼容问题。织梦CMS很老，用的是旧的mysql扩展，MySQL8.0默认认证插件caching_sha2_password不支持。解决：1. 用MySQL5.7或5.6（宝塔软件商店可以装多个版本）。2. 或改用户认证插件：ALTER USER '用户名'@'localhost' IDENTIFIED WITH mysql_native_password BY '密码'; FLUSH PRIVILEGES;。3. PHP版本用5.6或7.0，高版本PHP可能不兼容织梦。
第九步，配置文件被还原。有些织梦有data/common.inc.php的备份或安装脚本会还原配置，确认修改的是正在使用的文件。多站点或移动过目录的，确认路径正确。
第十步，安装时的配置。如果是新安装织梦，安装向导里填的数据库信息会写入common.inc.php。安装时提示连接失败，就是信息填错了，返回上一步重新填。
常见错误场景。场景一，迁移服务器后连接失败：数据库名/用户/密码变了，新服务器上创建同名数据库和用户，或改common.inc.php。场景二，改了数据库密码后失败：配置文件还是旧密码，同步修改。场景三，宝塔升级MySQL后失败：版本不兼容或配置变了，检查my.cnf和用户权限。场景四，磁盘满了MySQL起不来：清理磁盘。
修复后验证。1. 网站首页能打开，不提示数据库错误。2. 后台能登录。3. 文章内容正常显示。4. phpMyAdmin能看到数据库和表。5. 生成静态页正常（织梦静态模式）。
织梦CMS版本老旧，建议新网站用PbootCMS等现代CMS。仍在使用织梦的，做好安全防护（删install目录、改后台目录、强密码、定期备份），数据库连接问题按上面步骤排查。
更新时间：2026-08-26 17:52:54
上一篇：PbootCMS登录表单校验失败？按这个排查清单一步步走就能解决