如何处理WordPress网站提示“建立数据库连接时出错”或“Error establishing a database connection”错误

在使用浏览器访问基于WordPress建立的网站时，有时会遇到“建立数据库连接时出错”或“Error establishing a database connection”的错误提示。本文将详细介绍该问题的原因和解决方案，帮助你快速恢复网站正常运行。

问题描述

当您在浏览器中访问WordPress网站时，可能会看到以下错误提示：

• “建立数据库连接时出错”

• “Error establishing a database connection”

这通常表示WordPress无法正常连接到MySQL数据库，导致网站无法加载。

问题原因

该问题通常是由于被访问的WordPress网站程序无法正常连接MySQL数据库导致。常见原因包括：

• MySQL数据库服务未运行
• 数据库登录凭据错误（用户名、密码或数据库名）
• 数据库服务器地址错误
• 数据库损坏

解决方案

要解决此问题，需要检查MySQL数据库服务是否正常运行，并重新配置WordPress网站程序中的数据库连接信息。以下是具体的操作步骤：

1. 检查MySQL数据库服务状态

登录到您的MySQL数据库服务器，然后执行以下命令查看MySQL数据库服务的状态：

systemctl status mysql

如果MySQL数据库服务运行状态为 active (running)，表示数据库服务正常运行，回显信息如下：

● mysql.service - MySQL Community Server
   Loaded: loaded (/lib/systemd/system/mysql.service; enabled; vendor preset: enabled)
   Active: active (running) since Mon 2023-07-03 15:57:24 CST; 1h 30min ago
   ...

如果MySQL数据库服务运行状态为 inactive (dead)，表示MySQL数据库服务已停止，回显信息如下：

● mysql.service - MySQL Community Server
   Loaded: loaded (/lib/systemd/system/mysql.service; enabled; vendor preset: enabled)
   Active: inactive (dead) since Mon 2023-07-03 14:57:34 CST; 1h 30min ago
   ...

在这种情况下，需要启动MySQL数据库服务。执行以下命令启动服务：

systemctl start mysql

如果启动过程中提示ERROR报错，需要根据报错信息修改数据库服务配置，然后重新执行启动命令。

2. 测试MySQL数据库连接

确认MySQL数据库服务正常运行后，测试是否可以正常登录到MySQL数据库中。执行以下命令：

mysql -u<User> -h<IP> -p<Password>

说明：

• <User>：MySQL数据库用户名
• <IP>：MySQL数据库的IP地址
• <Password>：MySQL数据库的密码

如果提示登录成功，但数据库密码错误，您需要重新修改MySQL数据库的密码。具体操作请参考MySQL官方文档。

3. 修改WordPress配置文件

确认数据库密码正确并能正常登录后，修改WordPress网站程序中的数据库连接信息。编辑 wp-config.php 文件，将文件中的 DB_PASSWORD 字段对应的数据库密码替换为正确的MySQL数据库密码。

以CentOS 7操作系统、wp-config.php 文件路径为 /usr/share/nginx/html/wordpress 为例，执行以下命令：

vim /usr/share/nginx/html/wordpress/wp-config.php

找到以下内容：

/** MySQL database password */
define('DB_PASSWORD', 'your_database_password');

将 'your_database_password' 替换为正确的MySQL数据库密码。

保存并退出文件，输入 :wq 然后按 Enter 键。

总结

通过上述步骤，可以有效解决WordPress网站提示“建立数据库连接时出错”或“Error establishing a database connection”错误的问题。确保MySQL数据库服务正常运行，并在WordPress配置文件中正确配置数据库连接信息，是恢复网站正常运行的关键。