访问网站提示“连接数据库失败”怎么办？
当访问网站时提示 “连接数据库失败”，通常表示网站程序无法与数据库建立有效连接。以下是详细的排查和解决方法：
| 排查步骤 | 操作说明 |
|---|---|
| 1 | 检查数据库服务是否运行：登录服务器，使用命令 systemctl status mysql 或 systemctl status mariadb 查看数据库状态，若未运行可尝试启动服务：systemctl start mysql。 |
| 2 | 确认数据库配置信息正确：打开网站的数据库配置文件（如WordPress的wp-config.php、ThinkPHP的.env或database.php），检查以下参数：<br> - 数据库名称（DB_NAME）<br> - 用户名（DB_USER）<br> - 密码（DB_PASSWORD）<br> - 主机地址（DB_HOST，默认为 localhost） |
| 3 | 测试数据库连接：使用命令行或工具（如phpMyAdmin）手动连接数据库，验证账号密码是否正确，命令如下：<br> mysql -u 用户名 -p -h 主机地址 |
| 4 | 检查数据库用户权限：确保数据库用户拥有对目标数据库的访问权限。可通过MySQL命令设置权限：<br> GRANT ALL PRIVILEGES ON 数据库名.表名 TO '用户名'@'主机'; FLUSH PRIVILEGES; |
| 5 | 远程数据库需检查网络连通性：如果数据库部署在远程服务器上，请确认：<br> - 网络可达<br> - 数据库端口（默认3306）已开放<br> - 防火墙/安全组允许访问该端口<br> - MySQL允许远程IP连接（修改bind-address或授权%） |
| 6 | 查看数据库日志定位具体错误：MySQL的日志通常位于 /var/log/mysql/error.log 或 /var/lib/mysql/主机名.err，可从中查找连接失败的具体原因。 |
| 7 | 重启相关服务：有时重启服务即可解决问题，执行以下命令：<br> - Web服务：systemctl restart nginx 或 systemctl restart httpd<br> - 数据库服务：systemctl restart mysql |
| 8 | 检查服务器资源使用情况：使用 top、free -m、df -h 等命令检查内存、CPU、磁盘空间是否充足，避免因资源耗尽导致连接失败。 |
其他建议：
- 如果是高并发场景下频繁连接失败，建议优化SQL语句、增加数据库连接池或升级服务器配置。
- 定期备份数据库，防止数据损坏或丢失。
更新时间：2025-05-15 10:58:30