wordpress网站访问时出现“Error establishing a database connection”

这是WordPress最常见的数据库连接失败错误，意思是：网站无法连接到MySQL/MariaDB数据库。

一、核心原因(99%都是这4类)

数据库配置信息错误(wp-config.php里的账号/密码/主机名写错)→最常见

数据库服务宕机/未启动(MySQL/MariaDB挂了)

数据库被删除/不存在

网站流量暴增/数据库损坏(服务器资源耗尽)

二、一步一步解决(从最简单到最复杂)

1.检查wp-config.php数据库配置(90%的问题在这里)

用FTP/文件管理器打开网站根目录，找到wp-config.php，检查这4项：

// 数据库名
define( 'DB_NAME', 'wodepress' );

// 数据库用户名
define( 'DB_USER', 'wodepress' );

// 数据库密码
define( 'DB_PASSWORD', '123456' );

// 数据库主机（绝大多数填 localhost）
define( 'DB_HOST', 'localhost' );

正确做法：

去你的主机面板(宝塔、cPanel、主机商后台)复制准确的数据库名、用户、密码

粘贴进去，不要有空格、不要写错字符

数据库主机：本地服务器填localhost;云数据库/独立数据库服务器填服务商给的IP

2.确认数据库用户拥有访问权限

很多人用户名密码都对，但没给权限，依然连不上。

解决：

宝塔/主机面板→数据库管理

找到你的数据库→给对应用户授予全部权限

重启数据库服务

3.数据库服务未启动(服务器环境问题)

如果是自己搭建的服务器(阿里云/腾讯云/独立服务器)，MySQL可能挂了。

Linux服务器重启命令：

# CentOS
systemctl restart mysqld
# 或
systemctl restart mariadb

# Ubuntu/Debian
systemctl restart mysql

重启后刷新网站即可。

4.数据库名称错误/数据库被删除

如果wp-config.php里的数据库名根本不存在，一定会报错。

检查：

去面板看数据库列表

确保名字和配置文件完全一致

5.数据库损坏(少见但会发生)

WordPress自带修复工具，打开wp-config.php加入一行：

define('WP_ALLOW_REPAIR', true);

然后访问：

wodepress.com/wp-admin/maint/repair.php

点击修复数据库，修复完务必删除刚才加的那行代码。

6.主机商服务器问题(无需你操作)

如果以上都没问题，就是主机商的数据库服务器宕机了。

等待5~20分钟，或联系主机商客服。

三、快速排查清单(复制对照)

wp-config.php数据库名、用户、密码完全正确

数据库用户拥有权限

DB_HOST是localhost或正确的数据库地址

MySQL/MariaDB服务正在运行

数据库真实存在

尝试修复数据库

四、最常见的坑(新手必看)

密码里有特殊符号，直接写在配置里没加引号

复制时多了空格/换行

数据库用户和数据库名搞混

用了root账号但没权限

数据库服务没启动

90%的情况：wp-config.php数据库配置写错

8%的情况：数据库服务未启动

2%的情况：数据库损坏/主机商问题

databasemysql数据库错误