Moodle数据库连接失败问题排查请求（附config.php配置）

先看你给出的错误提示：

数据库连接失败，可能是数据库过载或运行异常，请管理员检查config.php中的数据库配置。

再结合你提供的config.php配置代码：

unset($CFG); global $CFG; $CFG = new stdClass(); $CFG->dbtype = 'mariadb'; $CFG->dblibrary = 'native'; $CFG->dbhost = '192.0.0.0'; $CFG->dbname = 'moodle'; $CFG->dbuser = 'root'; $CFG->dbpass = 'admindb@123'; $CFG->prefix = 'mdl_'; $CFG->dboptions = array ( 'dbpersist' => 0, 'dbport' => 3306, 'dbsocket' => '', 'dbcollation' => 'utf8mb4_general_ci', ); $CFG->wwwroot = 'http://192.0.0.0/moodle-apexon'; $CFG->dataroot = 'C://xampp//moodledata'; $CFG->admin = 'admin';

我帮你梳理几个核心排查点，按优先级来：

• 修正无效的数据库主机IP：你的$CFG->dbhost设为了192.0.0.0，这是一个无效的网络地址（属于保留的网络段标识，不能作为具体服务器的IP）。如果是本地XAMPP环境，改成127.0.0.1或者localhost；如果是远程数据库，换成实际的服务器公网/内网IP。另外你的wwwroot里也用了192.0.0.0，同样需要改成实际的服务器IP或者域名。

• 检查数据库服务状态：打开XAMPP控制面板，确认MariaDB（或MySQL）服务是否正常启动。如果服务没运行，点击"Start"启动；如果启动失败，查看日志排查端口占用（比如3306是否被其他程序占用）。

• 验证数据库账号权限与密码：

  • 确认root用户的密码admindb@123是否正确，可以用XAMPP的phpMyAdmin登录测试，或者在命令行用mysql -uroot -padmindb@123尝试连接。
  • 如果Moodle和数据库不在同一服务器，还要确认root账号是否允许从Moodle服务器的IP地址访问数据库（默认root可能只允许本地访问）。

• 确认数据库存在性：登录phpMyAdmin，检查是否存在名为moodle的数据库，以及数据库前缀mdl_是否和你创建数据库时设置的一致。

• 核对字符集配置：确认moodle数据库的默认字符集是utf8mb4_general_ci，如果不一致，需要修改数据库字符集或者调整$CFG->dboptions['dbcollation']的值。

按上面的步骤逐一排查，大概率能解决连接问题。

内容的提问来源于stack exchange，提问作者karuppasamy