宝塔数据库链接失败怎么办？检查用户名密码是否正确？

网站程序连接数据库失败，通常是由于用户名、密码错误，主机权限限制或数据库服务未启动所致。

• 典型场景

  • 安装CMS或商城系统后提示连接失败。
  • 修改数据库密码后程序未同步更新。
  • 数据库迁移后配置文件未更改。

• 常见原因导致连接失败

  1. 数据库用户名或密码填写错误。
  2. 数据库用户未授权访问对应IP。
  3. 数据库服务未运行。
  4. 数据库配置文件路径错误。

解决方案对比

方法	适用情况	注意事项
使用宝塔数据库模块测试连接	快速验证账号密码	支持一键测试
手动编辑配置文件修改凭据	更新站点数据库信息	如.env或config.php
检查MySQL用户权限	确认远程访问权限	使用GRANT语句授权

操作建议

1. 进入【数据库】→ 选择对应数据库 → 点击“测试连接”。
2. 检查网站根目录下的数据库配置文件，确认用户名、密码、数据库名是否匹配。
3. 执行systemctl status mysqld确认数据库服务是否运行。
4. 若为远程连接，需确保数据库用户已授权对应IP地址。