安装时提示"数据库连接失败"怎么办？

数据库连接失败通常有以下几个原因，按顺序排查：

1. 数据库主机地址错误：如果数据库和网站同一台服务器，填 localhost 或 127.0.0.1；如果是云数据库（如阿里云RDS），要填远程连接地址。
2. 账号密码错误：检查数据库用户名和密码是否与宝塔/数据库管理面板里的一致，注意密码中是否有特殊字符被截断。
3. 数据库用户权限不足：该用户必须有创建数据库、建表、读写权限。宝塔新建数据库时默认给了权限，如果是手动建的，需要在 MySQL 里 GRANT ALL ON *.* TO 'user'@'localhost';。
4. 数据库服务未启动：宝塔面板 → 数据库，看 MySQL 是否运行中。
5. 端口不是 3306：如果改过 MySQL 端口，需要在 config.php 里同步修改 port 字段。

先在服务器上执行 mysql -u用户名 -p密码 -h主机 测试，能连上再确认是 PHP 配置问题。