网站数据库连接失败 / 账号密码错误 排查指南

我给你整理了最常见、最快能解决的排查步骤，按顺序检查就能快速定位问题，新手也能看懂。

一、先确认核心报错原因

你遇到的问题分两类：

1. 账号密码错误：数据库用户名 / 密码填错了

2. 连接失败：能连上数据库，但配置 / 权限 / 服务有问题

二、快速排查步骤（按顺序做）

1. 检查网站配置文件（最关键！90% 问题在这）

找到网站的数据库配置文件，核对 4 项信息：

• 数据库地址：localhost / 127.0.0.1 / 云服务器内网 IP

• 数据库名：必须已创建

• 数据库用户名

• 数据库密码

常见配置文件位置：

• WordPress：wp-config.php

• ThinkPHP：/config/database.php

• Laravel：.env

• 织梦 / 帝国：/data/common.inc.php

• 通用 PHP：config.php / db.php

注意：密码里不要有空格、中文、特殊符号，复制粘贴最容易错！

2. 验证数据库账号密码是否正确

用 phpMyAdmin / Navicat / 宝塔面板 直接登录数据库：

• 能登录 = 账号密码正确

• 不能登录 = 账号密码错误，需要重置

3. 数据库用户没有权限（常见坑）

即使账号密码对，也可能出现：

• 用户只允许 localhost 访问，网站填了外网 IP

• 用户没有绑定该数据库权限

解决：给数据库用户授权全部权限，并绑定正确主机。

4. 数据库服务没启动

• Windows：查看 MySQL 服务是否运行

• Linux：systemctl status mysqld

• 宝塔 / 面板：直接看数据库状态是否 运行中

5. 端口错误

MySQL 默认端口：3306 如果改过端口，配置文件必须同步修改。

三、最常见的 3 种错误 & 一键解决

错误 1：Access denied for user 'xxx'@'localhost'

原因：账号密码错误 解决：

1. 重置数据库密码

2. 重新填写到网站配置文件

3. 清除网站缓存

错误 2：Can't connect to MySQL server

原因：连不上数据库服务 解决：

1. 检查数据库是否启动

2. 检查地址是否写对（不要用外网 IP 连本地库）

3. 防火墙 / 安全组是否放行 3306 端口

错误 3：Unknown database 'xxx'

原因：数据库名不存在 解决：去面板创建对应名字的数据库。

四、你可以直接告诉我这 3 项，我帮你精准定位

1. 你用的什么程序（WordPress/ThinkPHP/ 自己写的？）

2. 完整的报错信息

3. 数据库地址、账号密码是否能正常登录

我可以直接帮你判断是哪一步错了。

总结

• 90% 的问题是配置文件写错或密码错误

• 先核对配置 → 再验证登录 → 最后检查权限 / 服务

• 只要能正常登录 phpMyAdmin，网站一定能连上

本文编辑由 否玩代码 http://www.fouwan.com