数据库连接错误源于wp-config.php与宝塔数据库凭证不一致，需依次核对密码、修正配置文件参数、确认用户权限、将DB_HOST改为127.0.0.1、重启数据库服务。
如果您在宝塔面板中安装WordPress时收到“数据库连接错误”提示，则很可能是WordPress配置文件中填写的数据库用户名、密码或主机信息与宝塔面板实际创建的数据库凭证不一致。以下是验证和修正数据库密码的详细步骤：
一、核对宝塔面板中数据库用户的实际密码
宝塔面板创建数据库时，若未手动设置密码，系统会自动生成随机密码；若曾修改过密码但未同步更新wp-config.php，将导致连接失败。需进入宝塔面板后台确认当前生效的数据库用户密码。
1、登录宝塔面板，点击左侧菜单栏的数据库选项。
2、在数据库列表中找到WordPress所用的数据库名称，查看其对应的用户名字段内容。
3、点击该用户名所在行右侧的修改密码按钮（锁形图标），查看当前已设置的密码；若显示为“******”，勾选显示密码复选框即可明文查看。
二、检查WordPress配置文件wp-config.php中的数据库参数
wp-config.php是WordPress读取数据库连接信息的核心文件，其中DB_NAME、DB_USER、DB_PASSWORD、DB_HOST四个常量必须与宝塔面板中完全一致，任一字符差异（包括空格、大小写、特殊符号）都会引发连接失败。
1、通过宝塔面板的文件管理功能，进入WordPress网站根目录（通常为/www/wwwroot/您的域名/）。
2、找到并右键点击wp-config.php文件，选择编辑。
3、定位到以下四行代码，逐项比对：
define('DB_NAME', 'your_database_name');
define('DB_USER', 'your_db_username');
define('DB_PASSWORD', 'your_db_password');
define('DB_HOST', 'localhost');
4、确保DB_PASSWORD的值与步骤一中查到的密码完全一致，注意不可遗漏末尾分号，也不可包含中文引号。
三、验证数据库用户权限是否包含对应数据库
即使密码正确，若该数据库用户未被授权操作目标数据库，WordPress仍无法建立连接。需确认该用户拥有对该数据库的全部权限（SELECT、INSERT、UPDATE、DELETE等）。
1、仍在宝塔面板数据库页面，点击对应数据库名称右侧的管理按钮（齿轮图标）。
2、切换到权限设置标签页，查看下方用户列表中，该数据库用户名对应的权限列是否显示为所有权限。
3、若权限为“无”或仅部分权限，点击该行右侧的设置权限，在弹窗中勾选所有权限，然后点击提交。
四、测试数据库连接是否启用本地Socket或TCP/IP
部分宝塔环境（尤其是MySQL 8.0+）默认使用socket连接，而wp-config.php中DB_HOST设为localhost时可能触发DNS解析，导致连接超时。改用127.0.0.1可强制走TCP/IP协议，绕过解析环节。
1、打开wp-config.php文件，找到define('DB_HOST', 'localhost');这一行。
2、将其修改为：define('DB_HOST', '127.0.0.1');
3、保存文件后，刷新WordPress安装页面，观察错误是否消失。
五、重启数据库服务以应用配置变更
当数据库密码、权限或网络配置发生变更后，MySQL/MariaDB服务可能需要重新加载权限表或释放旧连接缓存，否则新设置可能暂不生效。
1、返回宝塔面板首页，点击左侧软件商店。
2、在已安装列表中找到正在运行的MySQL或MariaDB服务。
3、点击其右侧的重启按钮（循环箭头图标），等待状态变为运行中后再尝试WordPress安装流程。
