宝塔面板数据库连接失败？网站打不开数据库的排查与修复
宝塔面板管理的网站提示"数据库连接失败"，是常见故障。原因涉及MySQL服务、配置信息、权限、网络等。
原因一，MySQL服务没启动。最常见。检查：宝塔-软件商店-MySQL，状态是不是"已停止"。或SSH执行/etc/init.d/mysqld status。修复：点"启动"或/etc/init.d/mysqld start。启动失败看错误日志，参考MySQL无法启动的排查方法。
原因二，数据库配置信息错误。网站程序里的数据库名、用户名、密码和宝塔创建的不一致。检查：PbootCMS看config/config.php里的db_name、db_user、db_pwd。织梦看data/common.inc.php。WordPress看wp-config.php里的DB_NAME、DB_USER、DB_PASSWORD。对比宝塔-数据库里的数据库名和用户名。修复：配置文件里改成正确的信息，或在宝塔里改数据库密码为配置文件里的密码（两边要一致）。
原因三，数据库密码被改了但配置文件没同步。在宝塔里改了数据库密码，但网站配置文件还是旧密码。修复：两边统一，改配置文件或改数据库密码。改数据库密码后必须同步改配置文件，否则网站连不上。
原因四，数据库被删除或损坏。宝塔-数据库里看数据库是否存在。不存在的话从备份恢复。损坏的话修复表或恢复备份。
原因五，MySQL端口被改或被防火墙拦截。MySQL默认3306端口，如果改了端口，网站配置里的db_port要对应。本地连接一般用localhost或127.0.0.1，不走网络，端口问题影响小。远程连接的话要开放3306端口和允许远程访问。
原因六，数据库用户权限不足。数据库用户没有该数据库的权限。宝塔-数据库-对应数据库-权限，看用户是否有所有权限。修复：重新设置权限，或创建新用户授权。SQL命令：GRANT ALL PRIVILEGES ON 数据库名.* TO '用户名'@'localhost' IDENTIFIED BY '密码'; FLUSH PRIVILEGES;
原因七，MySQL的bind-address限制。MySQL配置里bind-address=127.0.0.1只允许本地连接，网站在同一服务器用localhost没问题。如果网站和数据库不在同一服务器，需要改成0.0.0.0并允许远程连接。
原因八，连接数满了。MySQL max_connections太小，高并发时连接数占满，新连接被拒。检查：MySQL里SHOW PROCESSLIST;看连接数。修复：my.cnf里max_connections=500，重启MySQL。同时优化程序，关闭不用的连接。
原因九，磁盘满了。磁盘100%满，MySQL无法写临时文件，可能无法接受连接。df -h检查，清理空间。
原因十，MySQL socket文件问题。提示"Can't connect to local MySQL server through socket '/tmp/mysql.sock'"。MySQL没启动或socket路径配置不一致。检查socket文件是否存在，my.cnf里[mysqld]和[client]的socket路径要一致。
排查流程。1. 先看MySQL服务状态，没启动就启动。2. 启动了还连不上，对比配置文件和宝塔的数据库信息。3. 信息一致还连不上，看MySQL错误日志。4. 检查磁盘和连接数。5. 用命令行测试连接：mysql -u用户名 -p密码 数据库名，能连上说明MySQL没问题，是程序配置问题；连不上看报错。
快速修复命令。重启MySQL：/etc/init.d/mysqld restart。查看数据库列表：mysql -u root -p -e "SHOW DATABASES;"。修复表：mysqlcheck -r -u root -p 数据库名。
预防措施。1. 不要随便改数据库密码，改了同步改配置文件。2. 定期备份数据库。3. 监控MySQL状态和磁盘空间。4. 数据库用户用最小权限，不用root。5. 高并发网站配置连接池和合理的max_connections。
数据库连接失败通常是简单问题（服务没起或密码错），按流程排查很快解决。
更新时间：2026-08-26 18:00:13
上一篇：修改网页内容的方法：后台、模板、数据库、静态HTML四种场景