宝塔面板数据库连接错误排查方法

当WordPress报“建立数据库连接时出错”，问题往往并非密码错误或服务宕机，而是wp-config.php中DB_NAME、DB_USER、DB_PASSWORD、DB_HOST四行配置与宝塔面板实际设置存在毫厘之差——大小写、符号、空格、下划线甚至socket路径都必须严丝合缝；同时需穿透表象验证MySQL真实运行状态（不止看面板图标）、确认数据库用户拥有完整权限（而非仅创建成功）、并精准对齐PHP与MySQL所用的socket路径，稍有不匹配便会静默失败。掌握这四重校验逻辑，90%的“连不上库”难题迎刃而解。

wp-config.php 里四行配置必须逐字符一致

WordPress 报“建立数据库连接时出错”，八成是 wp-config.php 里的 DB_NAME、DB_USER、DB_PASSWORD、DB_HOST 和宝塔实际设置对不上——不是“差不多”，是必须完全一致。

• DB_NAME 必须和宝塔「数据库」列表中显示的名称一模一样，包括下划线、短横线、大小写；my-site-db ≠ mysitedb
• DB_USER 是宝塔该数据库行对应的「用户名」，不是你登录宝塔的账号，也不是 root
• DB_PASSWORD 要从宝塔面板点「修改密码」→勾选「显示密码」后复制，别带前后空格或换行；含 $、@ 等符号不用转义，原样填就行
• DB_HOST 默认填 'localhost' 即可；若改过 MySQL 配置或用 Docker，才考虑换成 '127.0.0.1' 或 socket 路径

MySQL 服务状态不能只信宝塔面板

宝塔首页显示 MySQL “运行中”，不代表它真在工作——进程可能卡死、端口没监听、甚至根本没加载配置。

• 终端执行 systemctl status mysqld（CentOS）或 systemctl status mysql（Ubuntu），确认输出含 active (running) 且无 recent crash
• 哪怕状态正常，也补一句 netstat -tlnp | grep :3306：没输出说明 MySQL 没监听端口，得查 /www/server/mysql/etc/my.cnf 里 bind-address 和 skip-networking 设置
• 如果 systemctl 提示 Unit not found，说明 MySQL 没装成功，去翻 /www/wwwlogs/install.log 搜 mysql

用户权限没给全，连上也白连

密码对、服务起、域名通，还是报错？可能是这个用户压根没被授权操作那个库。宝塔创建数据库时自动生成同名用户，但权限未必自动绑定。

• 进宝塔「数据库」页面 → 找到对应数据库 → 点右侧「管理」→ 切到「权限设置」标签页
• 检查该用户名对应的权限列是否为「所有权限」；若为「无」或部分权限，点「设置权限」→ 全选 → 提交
• 更准的验证方式：用 root 登 MySQL 命令行，执行 SHOW GRANTS FOR 'wpuser'@'localhost';，看输出里有没有 GRANT ALL PRIVILEGES ON `mydb`.*
• 注意反引号：数据库名含短横线（如 my-db）时，授权语句必须写成 `my-db`.*，否则不生效

错误信息里带 socket 路径，别急着改密码

报错类似 Can't connect to local MySQL server through socket '/tmp/mysql.sock'，大概率不是密码错了，而是 PHP 读的 socket 路径和 MySQL 实际路径不一致。

• 先查 MySQL 实际 socket 路径：mysql -u root -p -e "SHOW VARIABLES LIKE 'socket';"
• 常见真实路径是 /www/server/data/mysql.sock，不是 /tmp/mysql.sock
• 进宝塔 → 对应 PHP 版本 → 「设置」→ 「配置文件」，加两行：
  mysqli.default_socket = /www/server/data/mysql.sock
PDO_mysql.default_socket = /www/server/data/mysql.sock
• 改完必须点「重启」PHP，不是「重载配置」

实际排查时最常卡在 DB_HOST 和 socket 路径的组合问题上：一个填 localhost，另一个却指向 TCP 监听地址，两边根本对不上路。

好了，本文到此结束，带大家了解了《宝塔面板数据库连接错误排查方法》，希望本文对你有所帮助！关注golang学习网公众号，给大家分享更多文章知识！