如何解决织梦CMS连接数据库失败的错误？配置、权限、版本全排查
织梦CMS（DedeCMS）提示"数据库连接失败"或"Error: Can't connect to MySQL server"是数据库配置或服务问题。完整排查。
织梦数据库配置文件。/data/common.inc.php内容： ```php $cfg_dbhost = 'localhost'; // 数据库地址 $cfg_dbname = '数据库名'; // 数据库名 $cfg_dbuser = '用户名'; // 用户名 $cfg_dbpwd = '密码'; // 密码 $cfg_dbprefix = 'dede_'; // 表前缀 $cfg_db_language = 'utf8'; // 字符集 ``` 四个信息必须和数据库实际一致。
原因一MySQL服务未启动（最常见）。1. 宝塔-软件商店-MySQL看状态停止了启动。2. 启动失败参考数据库无法启动排查。3. SSH /etc/init.d/mysqld status确认。
原因二配置信息错误。1. 数据库名/用户名/密码和实际不符。2. 迁移服务器后没改配置。3. 密码被改了但配置文件没更新。4. 检查宝塔-数据库看数据库名和用户名密码在配置文件里对比。5. 修复编辑data/common.inc.php填正确信息。6. 测试连接mysql -u用户名 -p密码 数据库名能进就配置对。
原因三数据库不存在。1. 数据库被删除或没导入。2. 宝塔-数据库看数据库是否存在。3. 不存在从备份恢复或新建数据库导入SQL。4. 数据库名拼写错（大小写敏感）。
原因四用户权限不足。1. 数据库用户没有该数据库权限。2. 主机限制用户只允许从特定IP连接localhost和127.0.0.1可能不同。3. 修复phpMyAdmin-root登录授权GRANT ALL ON 数据库.* TO '用户'@'localhost' IDENTIFIED BY '密码'; FLUSH PRIVILEGES;。4. 或宝塔-数据库-对应数据库-权限添加用户。
原因五数据库密码含特殊字符。密码里有#、&、单引号等PHP配置文件里可能解析问题。1. 密码用单引号包裹$cfg_dbpwd = 'p@ss#word';。2. 或改密码为字母数字避免特殊字符。3. 测试mysql -u用户 -p'密码' 数据库。
原因六MySQL版本兼容。1. 织梦老旧用mysql_*函数（PHP7已移除）PHP5.6+MySQL8.0可能连接问题。2. MySQL8.0默认认证插件caching_sha2_password旧版PHP不支持。3. 修复MySQL8.0里改用户认证ALTER USER '用户'@'localhost' IDENTIFIED WITH mysql_native_password BY '密码'; FLUSH PRIVILEGES;。4. 或用MySQL5.7兼容性好。5. PHP版本用5.6或7.0（织梦不支持PHP7.1+的mysql_函数需要补丁）。
原因七data目录权限。1. data/common.inc.php不可读配置加载失败。2. 权限chown www:www data/common.inc.php chmod 644。3. data目录755。4. 织梦data目录需要可写（缓存、session）。
原因八端口或地址错。1. MySQL改了非3306端口配置里没加端口。2. $cfg_dbhost = '127.0.0.1:3307';。3. 或用localhost走socket不经过TCP。4. 检查MySQL端口netstat -tlnp | grep mysql。
原因九数据库损坏。1. 表损坏导致连接后查询失败表现为连接成功但页面报错。2. 修复mysqlcheck -r -u root -p 数据库名。3. 或phpMyAdmin里选中表-修复表。4. 严重损坏从备份恢复。
原因十防火墙/安全组。1. 数据库在远程服务器3306端口没放行。2. 但织梦通常数据库和网站同服务器用localhost不经过防火墙。3. 远程数据库的话安全组放行3306 MySQL允许远程连接。
诊断步骤。1. 确认MySQL运行/etc/init.d/mysqld status。2. 测试命令行连接mysql -u用户 -p密码 数据库名看具体报错。3. 报错Access denied→密码/权限错。4. 报错Unknown database→数据库名错。5. 报错Can't connect→MySQL没运行或地址/端口错。6. 连接成功但网站还报错→配置文件没更新或权限/字符集问题。7. 看Nginx/PHP错误日志。
快速修复命令。 ```bash # 1. 启动MySQL /etc/init.d/mysqld start # 2. 测试连接（替换用户密码数据库名） mysql -u用户名 -p密码 数据库名 -e "SELECT 1;" # 3. 看配置 cat /www/wwwroot/域名/data/common.inc.php | grep cfg_db # 4. 修复权限 chown -R www:www /www/wwwroot/域名/data chmod -R 755 /www/wwwroot/域名/data ```
织梦安全提醒。织梦已停止更新漏洞多数据库连接信息泄露风险高。1. data目录移到web根目录外（织梦支持改配置）。2. 删除install目录。3. 后台目录dede改名。4. 定期备份数据库。5. 考虑迁移到PbootCMS等现代CMS。
织梦数据库连接失败按"MySQL运行→配置正确→权限足够→版本兼容"排查命令行测试连接是最快诊断方法。配置文件data/common.inc.php是关键四个信息填对基本能连上。
更新时间：2026-08-26 18:10:59
上一篇：如何替换网站中的图片：后台替换、FTP覆盖、模板修改三种场景全解