WordPress报错 Error establishing a database connection

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%的情况:数据库损坏/主机商问题

原文

https://topfreetheme.com/?p=6722

相关推荐
一江寒逸2 小时前
零基础从入门到精通MongoDB(下篇):进阶精通篇——吃透高级查询、事务、索引优化与集群架构,成为MongoDB实战高手
数据库·mongodb·架构
sa100272 小时前
一键获取淘宝天猫商品评论:API 接口实战与多语言实现教程
数据库·oracle
huanmieyaoseng10032 小时前
Linux安装达梦数据库DM8
linux·运维·数据库
香蕉鼠片2 小时前
Mysql进阶篇
数据库·mysql·oracle
数厘2 小时前
2.12 sql 数据插入(INSERT INTO)
数据库·sql·oracle
薛定e的猫咪2 小时前
2026 年 4 月实测:OpenAI Codex 保姆级教程,从安装到 MCP、Skills 与多智能体协作
前端·数据库·人工智能
wgzrmlrm742 小时前
Django怎么优雅发送邮件_Python配置SMTP后端实现异步通知
jvm·数据库·python
014-code2 小时前
Redis 删除缓存失败怎么办?重试、死信、补偿的工程化方案
数据库·redis·缓存
I love studying!!!2 小时前
Web应用程序:用户账户
前端·数据库·sqlite
窝子面2 小时前
NestJs+MongoDB+Deepseek+Langchain实现ai聊天助手
javascript·数据库·人工智能·mongodb