搞了11年独立博客，头发是少了，坑是填了不少。

今天不聊虚的，聊聊最让人头秃的“数据库连接失败”。

很多刚入坑的朋友，网站搭好了，一访问就白屏。

或者满屏英文报错，看着就心慌。

其实，90%的情况不是代码写错了，是配置没对。

我拿最近帮朋友修的一个WordPress站点举例。

服务器是阿里云轻量应用服务器，系统CentOS 7。

数据库用的MySQL 5.7，这版本挺稳，但也容易出小毛病。

朋友给我截图，报错信息是：

“Error establishing a database connection”。

翻译过来就是：连不上数据库。

这时候别急着重装系统，那是笨办法。

咱们得像老中医一样，望闻问切。

第一步，查配置。

打开wp-config.php文件，这是网站的“身份证”。

看看DB_NAME、DB_USER、DB_PASSWORD这三个参数。

是不是填对了？

很多新手复制粘贴，多敲了一个空格，或者大小写搞反。

比如密码里有个大写的L，你看成了小写的i。

这种低级错误，我见过太多次了。

建议直接去数据库后台，重置一下密码。

然后复制新的密码，粘贴到配置文件里。

注意，别用记事本改，用专业的代码编辑器，比如VS Code。

记事本容易引入隐藏字符，导致解析失败。

第二步，查权限。

如果配置没错，那可能是权限不够。

登录phpMyAdmin，或者用命令行连接数据库。

看看当前用户有没有访问该数据库的权限。

有时候，新建的用户默认只有localhost权限。

如果你的网站代码和数据库不在同一台机器，那就麻烦了。

这时候需要把权限改成%或者具体IP。

但要注意，改成%虽然方便，但安全性大打折扣。

最好指定你的服务器IP地址，这样安全又稳定。

这一步做完，如果还是连不上，别慌。

第三步，查服务状态。

登录服务器，输入命令：systemctl status mysql。

看看MySQL服务是不是在运行。

有时候服务器重启，或者内存爆了，数据库服务会挂掉。

如果状态是dead或者failed，那就重启一下。

命令很简单：systemctl restart mysql。

重启后，再试试访问网站。

这时候，大概率能打开了。

当然，还有一种情况，是防火墙挡住了。

服务器安全组里，3306端口开了吗？

很多云厂商默认是不开放数据库端口的。

你需要手动添加规则，允许特定IP访问3306端口。

这一步漏了，外网肯定连不上内网数据库。

我见过不少朋友，为了省事，直接把防火墙关了。

这是大忌！

一旦开放，黑客扫描器几秒钟就能找到你。

轻则数据泄露，重则服务器被挖矿。

所以，安全这块必须得严。

除了上面说的，还有一个细节容易被忽视。

就是字符集。

以前老项目用gbk，新环境默认utf8mb4。

如果字符集不匹配，虽然能连接，但中文会乱码。

或者插入数据时报错。

这时候，需要统一字符集设置。

在配置文件里加上define('DB_CHARSET', 'utf8mb4');

这样能确保兼容性最好。

我总结了一下，数据库连接问题，核心就三点。

配置要对，权限要给，服务要活。

只要顺着这个思路排查，基本都能解决。

别一报错就找外包，自己动手，成就感满满。

而且，排查过程也是学习的过程。

下次再遇到类似问题，你一眼就能看出毛病。

这才是做技术博客的意义，分享实战经验。

而不是抄抄教程，糊弄过去。

希望这篇文章能帮到你。

如果有其他建站问题，欢迎在评论区留言。

咱们一起交流，一起避坑。

记住，建站是一场马拉松，不是百米冲刺。

慢慢来，比较快。

本文关键词：网站建设 数据库连接