织梦CMS数据库连接失败怎么办？

排查思路：从易到难，从常见到罕见

请按照以下顺序进行检查,每一步都确认无误后再进行下一步。

第一步：检查最常见的原因 - 数据库配置文件 config.php

这是最有可能出错的地方,织梦CMS的数据库连接信息存储在 /data/config.db.php 文件中。

1. 找到文件：通过FTP或你的主机控制面板的文件管理器，进入网站根目录，找到 data 文件夹，然后打开 config.db.php 文件。

2. 检查信息：打开文件后，你会看到类似下面的代码，请仔细核对每一项信息是否正确。

   <?php
   //数据库连接信息
   $cfg_dbhost = 'localhost'; // 数据库主机
   $cfg_dbname = 'your_database_name'; // 数据库名称
   $cfg_dbuser = 'your_database_user'; // 数据库用户名
   $cfg_dbpwd = 'your_database_password'; // 数据库密码
   $cfg_dbprefix = 'dede_'; // 数据库表前缀
   $cfg_db_language = 'gbk'; // 数据库语言版本
   ?>

3. 核对要点：

   
   （图片来源网络，侵删）
   • $cfg_dbhost (数据库主机)：绝大多数情况下是 localhost，少数虚拟主机或云服务器可能需要填写服务器的IP地址，如果你不确定，先尝试 localhost。
   • $cfg_dbname (数据库名)：这是你在创建数据库时给数据库起的名字，区分大小写，请确保完全正确。
   • $cfg_dbuser (数据库用户名)：这是你用来连接数据库的用户名，区分大小写。
   • $cfg_dbpwd (数据库密码)：这是数据库用户的密码。特别注意，有时候密码中包含特殊字符（如 , , , 等），可能会导致解析错误，可以尝试重置一个纯字母数字的密码来测试。
   • $cfg_dbprefix (数据库表前缀)：如果你在安装时修改了默认的前缀（比如从 dede_ 改成了 abc_），那么这里就必须和你数据库里实际的表前缀一致。

常见错误：信息输入时打错字、大小写错误、密码记错。

第二步：检查数据库和用户本身

config.db.php 文件里的信息看起来没问题，那么问题可能出在数据库服务器或用户权限上。

1. 确认数据库存在：登录你的主机控制面板（如 cPanel、宝塔面板、阿里云/腾讯云控制台），找到“数据库”管理功能。

   • 检查你配置文件中填写的 $cfg_dbname 对应的数据库是否存在。
   • 如果不存在,请创建一个。

2. 确认数据库用户存在且权限正确：

   
   （图片来源网络，侵删）
   • 在数据库管理界面,检查你配置文件中填写的 $cfg_dbuser 对应的用户是否存在。
   • 最关键的一步：检查这个用户对你数据库的权限，通常需要选择 “所有权限” (All Privileges) 或至少包含 SELECT, INSERT, UPDATE, DELETE, CREATE, DROP, ALTER 等权限。
   • 如果用户不存在,请创建一个新用户，并将其与你创建的数据库关联，赋予所有权限。

常见错误：数据库用户存在，但没有被授权访问指定的数据库。

第三步：检查数据库服务状态和连接限制

如果数据库和用户都配置正确,那么可能是服务本身的问题。

1. 数据库服务是否运行：

   • 如果你使用的是云服务器（如阿里云ECS、腾讯云CVM），检查数据库服务（通常是MySQL或MariaDB）是否正常运行。
   • 如果你使用的是虚拟主机,请联系你的主机服务商，询问他们的MySQL数据库服务是否正常。

2. IP地址白名单：

   • 对于云服务器上的数据库,为了安全，通常会设置IP地址白名单，只允许特定的IP地址连接。
   • 检查你的数据库安全组或访问控制规则,确保你网站所在的服务器的IP地址（或者 localhost）在允许访问的列表中。
   • 如果你不知道服务器IP,可以尝试在 config.db.php 中将 $cfg_dbhost 从 localhost 改为服务器的公网IP地址进行测试。

3. 数据库连接数限制：

   如果你的网站流量突然增大,可能会达到数据库的最大连接数限制，导致新的连接失败，可以查看主机控制面板里的数据库状态信息，或者联系服务商确认。

常见错误：数据库服务宕机，或者服务器的IP地址没有被加入数据库的访问白名单。

第四步：检查文件权限和编码

这一步相对少见,但在某些特定环境下也会发生。

1. 文件权限：

   • 确保 /data 文件夹以及 config.db.php 文件的权限设置正确。
   • /data 文件夹权限设置为 755，config.db.php 文件权限设置为 644，错误的权限可能导致程序无法读取配置文件。

2. 数据库编码：

   • 检查 config.db.php 中的 $cfg_db_language 设置（gbk 或 utf8）。
   • 登录数据库管理工具（如 phpMyAdmin），查看你的数据库、数据表以及字段的默认字符集是否与此设置一致，如果编码不统一，虽然不一定直接导致连接失败，但会引发后续的乱码等问题，所以最好保持一致。

总结与快速排查清单

当你遇到“数据库连接失败”时，请按这个清单快速检查：

如果以上所有步骤都检查过,问题依旧存在，那么可以尝试：

• 联系你的主机服务商：告诉他们你的问题，并提供你的数据库配置信息（不含密码），让他们从服务器端帮你排查。
• 检查 php.ini 文件：极少数情况下，PHP的 mysqli 或 pdo_mysql 扩展可能被禁用，导致无法连接数据库，可以检查 php.ini 文件中 extension=mysqli 和 extension=pdo_mysql 前面的分号 是否被去掉了。

希望这份详细的指南能帮助你解决问题！