当前位置：首页 > 工作总结

Ubuntu VPS中wordpress网站打开时提示”建立数据库连接错误”的解决办法

管理员 2025-02-18

工作总结

在 Ubuntu VPS 上运行 WordPress 网站时，如果遇到“建立数据库连接错误”（Error Establishing a Database Connection），通常是因为 WordPress 无法连接到 MySQL/MariaDB 数据库。这个问题可能由多种原因引起，以下是一些常见的解决方法。

1. 检查数据库配置

WordPress 通过 wp-config.php 文件中的配置连接到数据库。确保配置文件中的数据库信息正确。

步骤：

打开 wp-config.php 文件：

sudo nano /var/www/your-website/wp-config.php

检查以下配置项：

define('DB_NAME', 'your_database_name');      // 数据库名define('DB_USER', 'your_database_user');      // 数据库用户名define('DB_PASSWORD', 'your_database_password'); // 数据库密码define('DB_HOST', 'localhost');               // 数据库主机（通常是 localhost）

如果配置有误，修改后保存并退出（按 Ctrl + X，然后按 Y 确认）。

2. 检查数据库服务是否运行

确保 MySQL/MariaDB 服务正在运行。

步骤：

检查数据库服务状态：
bash
复制
```
sudo systemctl status mysql
```
或（如果是 MariaDB）：
bash
复制
```
sudo systemctl status mariadb
```
如果服务未运行，启动服务：
bash
复制
```
sudo systemctl start mysql
```
或：
bash
复制
```
sudo systemctl start mariadb
```

设置服务开机自启：

sudo systemctl enable mysql

或：

sudo systemctl enable mariadb

3. 检查数据库用户权限

确保 WordPress 使用的数据库用户具有访问数据库的权限。

步骤：

检查用户权限：

SHOW GRANTS FOR 'your_database_user'@'localhost';

如果用户没有权限，授予权限：

GRANT ALL PRIVILEGES ON your_database_name.* TO 'your_database_user'@'localhost';FLUSH PRIVILEGES;

退出 MySQL：
sql
复制
```
EXIT;
```

4. 检查数据库是否存在

确保 WordPress 使用的数据库已经创建。

步骤：

登录 MySQL/MariaDB：
bash
复制
```
sudo mysql -u root -p
```
列出所有数据库：
sql
复制
```
SHOW DATABASES;
```
如果数据库不存在，创建数据库：
sql
复制
```
CREATE DATABASE your_database_name;
```
退出 MySQL：
sql
复制
```
EXIT;
```

5. 检查数据库连接限制

如果数据库连接数达到上限，可能会导致连接失败。

步骤：

查看当前连接数：

SHOW STATUS LIKE 'max_used_connections';SHOW VARIABLES LIKE 'max_connections';

如果连接数接近上限，可以临时增加连接数：
sql
复制
```
SET GLOBAL max_connections = 200;
```
永久修改连接数：
编辑 MySQL 配置文件：
bash
复制
```
sudo nano /etc/mysql/mysql.conf.d/mysqld.cnf
```
找到 max_connections 并修改：
ini
复制
```
max_connections = 200
```
重启 MySQL 服务：
bash
复制
```
sudo systemctl restart mysql
```

6. 检查防火墙设置

确保防火墙允许 MySQL/MariaDB 的端口（默认是 3306）通过。

步骤：

检查防火墙状态：
bash
复制
```
sudo ufw status
```
如果防火墙阻止了 MySQL 端口，允许端口：
bash
复制
```
sudo ufw allow 3306
```

7. 检查数据库主机地址

如果数据库不在本地，确保 DB_HOST 配置正确。

步骤：

打开 wp-config.php 文件：

sudo nano /var/www/your-website/wp-config.php

检查 DB_HOST 配置：

define('DB_HOST', 'your_database_host'); // 例如：localhost 或远程数据库 IP

如果数据库在远程服务器上，确保远程服务器允许连接。

8. 检查数据库表是否损坏

如果数据库表损坏，可能会导致连接失败。

步骤：

Ubuntu

  VPS

  wordpress

  网站

  开时

  提示
 
                       

                       

                       
                       希望以上内容对你有所帮助！如果还有其他问题，请随时提问。

各类知识收集 拥有多年CMS企业建站经验，对
iCMS，
LeCMS，
ClassCMS，
Fastadmin，
PbootCMS，
PHPCMS，
易优CMS，
YzmCMS，
讯睿CMS，
极致CMS，
Wordpress，
HkCMS，
YznCMS，
WellCMS，
ThinkCMF，
等各类cms的相互转化，程序开发，网站制作，bug修复，程序杀毒，插件定制都可以提供最佳解决方案。

                        未经允许不得转载：Str Tom工作室 » Ubuntu VPS中wordpress网站打开时提示”建立数据库连接错误”的解决办法

PHP建站技术分享-从入门到精通_各类知识收集