WordPress 新手安装实录：数据库连接报错 5 分钟解决

最近想搭建个人博客，跟着教程下载好 WordPress 源码，上传到虚拟主机，满心期待打开安装页面，结果直接撞上经典报错：Error establishing a database connection（建立数据库连接时出错）。作为纯新手，一瞬间有点慌，查了资料一步步排查，前后只用 5 分钟搞定，把这次踩坑全过程记录下来，给同样初学搭建网站的朋友参考。

我使用的是普通虚拟主机，提前在主机后台新建了数据库，复制好数据库名、用户名、密码，进入 WordPress 安装界面填写数据库信息。一开始我以为复制粘贴就不会出错，点提交之后没有进入下一步，而是跳出这个白底黑字的报错页面。之前听说这个问题很难搞，很多人卡几小时，我先稳住心态，记住这个报错的核心：WordPress 程序拿不到数据库的连接权限，大多不是服务器坏了，而是配置信息不匹配。

第一步，登录主机后台的 phpMyAdmin，核对数据库信息。很多新手最容易踩的坑：复制密码时多带空格、区分大小写，数据库主机不一定全是localhost，部分主机需要填写指定地址。我仔细对比发现，密码复制末尾多了一个看不见的空格，删掉空格之后再次尝试，依旧报错。接着检查数据库用户权限，确认这个用户已经被授予该数据库的全部权限，没有权限的账号，就算账号密码全对，也无法连接数据库WordPress …。

第二步，打开网站根目录下的wp-config.php文件，这是 WordPress 存储数据库配置的核心文件。文件里四项关键配置：DB_NAME 数据库名、DB_USER 用户名、DB_PASSWORD 密码、DB_HOST 数据库主机。我这里的问题是数据库主机，教程默认写localhost，但是我这台虚拟主机需要改成127.0.0.1，改完保存文件，刷新页面。

刷新页面后，报错消失，顺利进入 WordPress 的站点名称、管理员账号设置页面，安装流程正常走完，前后刚好 5 分钟。复盘这次排错，一共就两个小问题：密码自带多余空格、数据库主机地址不适配默认的localhost。

很多新手遇到这个报错，第一反应是重装源码、重启服务器，其实完全没必要。这个报错 90% 的情况都集中在四项数据库信息写错、账号没有数据库权限、数据库主机地址不对这三点上，优先核对这几项，基本都能快速解决WordPress …。

这次踩坑也让我明白，搭建 WordPress 不要盲目跟着教程照抄参数，主机服务商不同，数据库配置规则会有差异。遇到报错先看提示，优先核对凭证，不要上来就做复杂操作。如果你也遇到同样的数据库连接报错，可以按照这个顺序排查，大概率几分钟就能顺利完成安装。