网站安装时提示“数据库连接失败，请检查配置”问题_已解决
报错现象：填写数据库地址、用户名、密码、数据库名后，点击“下一步”，弹出“数据库连接失败，请检查配置”提示，无法完成安装。
报错原因：数据库地址、账号、密码填写错误；虚拟主机数据库地址非localhost（多为空间商提供的专属地址）；数据库用户无对应数据库的读写权限；MySQL服务未正常运行；PHP版本过高（如PHP8.2+）导致数据库驱动兼容异常。
修复步骤：
-
核对数据库信息：重新确认数据库地址、用户名、密码、数据库名，确保无空格、无拼写错误；虚拟主机需使用空间商提供的专属数据库地址（如mysql.xxx.com），不可默认填写localhost。
-
检查数据库权限：登录数据库管理工具（如phpMyAdmin），确认该数据库用户具备SELECT、INSERT、UPDATE、DELETE、CREATE等管理权限，无权限则联系空间商或数据库管理员添加。
-
MySQL服务排查：
-
Linux环境：执行命令
service mysql status检查MySQL服务是否运行，未运行则执行service mysql start启动；若仍失败，尝试将数据库地址改为127.0.0.1。 -
Windows环境：在“服务”中找到MySQL（或MariaDB），确认状态为“正在运行”，未运行则右键“启动”。
-
PHP版本适配：PbootCMS推荐PHP7.0-7.4版本，若使用PHP8.0+，需修改根目录下php.ini文件，开启mysqli扩展，同时下载PbootCMS最新版本，适配高版本PHP。
-
MySQL8.0适配：若使用MySQL8.0，需修改数据库用户认证方式为mysql_native_password，执行SQL命令
ALTER USER '用户名'@'localhost' IDENTIFIED WITH mysql_native_password BY '密码';，刷新权限后重新尝试。
更新时间：2026-03-12 11:16:28