解决 WordPress 提示“建立数据库连接时出错”的方法

WordPress 网站提示“建立数据库连接时出错”是一个常见的问题，通常是由于数据库连接信息不正确、MySQL 服务未运行、数据库表损坏等原因引起的。以下是详细的解决步骤，包括使用 WordPress 内置的数据库修复工具。

1. 检查 wp-config.php 文件中的数据库信息

最常见的原因是 wp-config.php 文件中的数据库信息不正确。请按照以下步骤检查和修改：

1. 找到 wp-config.php 文件：

   • 这个文件位于您的 WordPress 网站根目录中。

2. 打开 wp-config.php 文件：

   • 使用 FTP 客户端或主机提供商的文件管理器打开该文件。

3. 检查数据库信息：

   • 确认以下几行信息是否正确：
     php

      

     define('DB_NAME', 'your_database_name'); define('DB_USER', 'your_database_username'); define('DB_PASSWORD', 'your_database_password'); define('DB_HOST', 'localhost');
   • 确保数据库名、用户名和密码与您的数据库实际信息一致。
   • 如果最近更换了服务器或修改了数据库信息，务必同步更新这些值。

4. 尝试修改数据库地址：

   • 如果其他信息都正确，可以尝试将 DB_HOST 从 localhost 修改为 127.0.0.1，看看是否能解决问题。

2. 检查 MySQL 服务是否运行

MySQL 服务可能因为各种原因停止运行，导致无法连接。请按照以下步骤检查和重启 MySQL 服务：

1. 检查 MySQL 服务状态：

   • 如果您使用的是宝塔面板，可以在软件管理中查看 MySQL 服务的状态。
   • 如果您使用的是命令行，可以运行以下命令检查 MySQL 服务状态：
      

      

     sudo systemctl status mysql

2. 重启 MySQL 服务：

   • 如果 MySQL 服务未运行，可以尝试重启它：
     • 在宝塔面板中，找到 MySQL 服务并点击“重启”按钮。
     • 在命令行中，运行以下命令重启 MySQL 服务：
        

        

       sudo systemctl restart mysql

3. 使用 WordPress 内置的数据库修复工具

WordPress 内置了一个优化和修复数据库的工具，可以帮助修复损坏的数据库表。以下是具体步骤：

1. 编辑 wp-config.php 文件：

   • 打开 wp-config.php 文件，在“/* 好了!请不要再继续编辑。请保存本文件。使用愉快! */”前面添加以下代码：
      

      

     define('WP_ALLOW_REPAIR', true);

2. 访问数据库修复工具：

   • 打开浏览器，访问以下 URL：
      

      

     http://你的域名/wp-admin/maint/repair.php

3. 执行数据库修复：

   • 在页面上，您会看到两个选项：
     • 修复数据库：修复所有损坏的数据表。
     • 优化数据库：优化所有数据表以提高性能。
   • 选择“修复数据库”并点击“修复数据库”按钮。

4. 确认修复结果：

   • 如果修复成功，页面会显示“数据库修复完成”。
   • 如果修复过程中出现错误，请根据错误信息进行相应的调整。

5. 移除 WP_ALLOW_REPAIR 定义：

   • 修复完成后，为了安全起见，移除 wp-config.php 文件中添加的 define('WP_ALLOW_REPAIR', true); 代码。

4. 检查数据库表和 PHP 文件是否损坏

如果前两步都没有解决问题，可能是数据库表或某些 PHP 文件损坏了。请按照以下步骤检查和修复：

1. 检查数据库表：

   • 登录到 phpMyAdmin 或使用命令行工具，检查数据库表是否有损坏。
   • 可以运行以下 SQL 命令检查和修复表：
      

      

     REPAIR TABLE table_name;

2. 恢复备份：

   • 如果您有网站和数据库的备份文件，尝试恢复到备份状态。
   • 使用 FTP 客户端上传备份的文件，使用 phpMyAdmin 导入备份的数据库。

5. 升级服务器配置

如果您的服务器配置较低，可能会导致 MySQL 服务频繁崩溃。建议升级服务器配置，特别是对于使用复杂主题和插件的 WordPress 站点：

• 推荐配置：
  • 至少 1 核 2G 内存。
  • 对于使用复杂主题（如 Avada）的站点，建议 2 核 4G 内存。

总结

大多数情况下，“建立数据库连接出错”是由 wp-config.php 文件中的数据库信息不正确或 MySQL 服务未运行引起的。按照上述步骤逐一排查，通常可以解决问题。如果问题依然存在，建议检查服务器日志文件，获取更详细的错误信息。使用 WordPress 内置的数据库修复工具也是一个有效的解决方案。