未修改配置却出现phpMyAdmin无法连接MySQL及本地WordPress数据库错误

问题背景 #

使用XAMPP环境，一周后开机出现以下问题：

• 本地WordPress网站提示「连接数据库服务器时发生错误」
• phpMyAdmin无法连接MySQL，未修改过任何配置，此前曾解决过同类连接问题

排查与解决步骤 #

1. 确认MySQL服务状态 #

• 打开XAMPP控制面板，查看MySQL模块是否处于Running状态：
  • 未启动则点击「Start」尝试启动；启动失败时点击「Logs」查看错误日志，重点排查端口占用、权限报错等信息。
  • 端口冲突排查：Windows执行netstat -ano | findstr :3306，Mac/Linux执行lsof -i :3306，找到占用3306端口的进程并结束，再重启MySQL。

2. 检查MySQL核心配置 #

• 打开XAMPP安装目录下mysql\bin中的my.ini（Windows）或my.cnf（Mac/Linux），验证以下配置：
  • 确保port = 3306，与phpMyAdmin、WordPress配置一致
  • 确认bind-address = 127.0.0.1，允许本地连接
  • 若存在skip-networking，添加注释符#禁用该行（否则会阻止TCP/IP连接）
• 保存配置后重启MySQL服务。

3. 验证phpMyAdmin配置 #

• 打开XAMPP安装目录下phpMyAdmin中的config.inc.php，核对以下配置项：

  $cfg['Servers'][$i]['host'] = '127.0.0.1';
  $cfg['Servers'][$i]['port'] = '3306';
  $cfg['Servers'][$i]['user'] = 'root';
  $cfg['Servers'][$i]['password'] = ''; // 替换为你的MySQL root密码，默认为空
  

• 保存后刷新phpMyAdmin页面重试连接。

4. 修复WordPress数据库配置 #

• 打开WordPress根目录下的wp-config.php，确认数据库参数正确：

  define('DB_NAME', '你的WordPress数据库名');
  define('DB_USER', 'root');
  define('DB_PASSWORD', '你的MySQL密码');
  define('DB_HOST', '127.0.0.1'); // 替换localhost避免解析问题
  define('DB_PORT', '3306');
  

• 保存后刷新WordPress网站重试。

5. 检查MySQL数据目录权限 #

• Windows：右键XAMPP的mysql\data目录→属性→安全→编辑，给当前用户添加「完全控制」权限。
• Mac：打开终端执行命令，赋予MySQL进程数据目录所有权：

  sudo chown -R _mysql:_mysql /Applications/XAMPP/xamppfiles/var/mysql
  

• 权限修改完成后重启MySQL。

6. 重置MySQL root密码（若密码失效/遗忘） #

• 停止XAMPP中的MySQL服务。
• 打开命令行，进入XAMPP的mysql\bin目录：
  • Windows：cd C:\xampp\mysql\bin
  • Mac：cd /Applications/XAMPP/xamppfiles/bin
• 执行命令跳过权限验证启动MySQL：

  mysqld --skip-grant-tables
  

• 新开一个命令行窗口，进入同一目录执行mysql -u root进入MySQL命令行，执行以下语句重置密码（替换new_password为你的新密码）：

  USE mysql;
  UPDATE user SET authentication_string=PASSWORD('new_password') WHERE User='root';
  FLUSH PRIVILEGES;
  EXIT;
  

• 关闭所有命令行窗口，重启MySQL服务，同步更新phpMyAdmin和WordPress的密码配置。

内容的提问来源于stack exchange，提问作者Tomáš Mejzr