Laragon环境下无法连接phpMyAdmin问题求助

1. 检查MySQL服务状态 #

• 打开Laragon面板，确认MySQL服务处于启动状态（显示绿色运行标识）。若未启动，点击Start按钮尝试启动；启动失败的话，通过面板右下角Logs按钮查看报错日志定位问题。

2. 核对phpMyAdmin配置文件 #

• 找到Laragon目录下的phpMyAdmin/config.inc.php，检查核心配置项：

  $cfg['Servers'][$i]['host'] = '127.0.0.1'; // 优先用IP而非localhost，避免socket连接异常
  $cfg['Servers'][$i]['port'] = '3306'; // 需与Laragon MySQL端口一致，默认3306，修改过则对应调整
  $cfg['Servers'][$i]['user'] = 'root'; // Laragon默认MySQL用户为root
  $cfg['Servers'][$i]['password'] = ''; // 默认root密码为空，自行设置过则填写对应密码
  

3. 同步Laravel.env与MySQL配置 #

• 确保Laravel项目.env的数据库参数与Laragon MySQL完全匹配：

  DB_CONNECTION=mysql
  DB_HOST=127.0.0.1
  DB_PORT=3306
  DB_DATABASE=你的目标数据库名
  DB_USERNAME=root
  DB_PASSWORD=你的MySQL密码（无密码则留空）
  

• 修改配置后执行php artisan config:clear清除配置缓存，避免旧配置残留。

4. 排查端口冲突 #

• XAMPP的MySQL可能占用3306端口，导致Laragon MySQL无法启动。打开命令提示符执行：

  netstat -ano | findstr :3306
  

• 查看结果中的进程ID，打开任务管理器结束对应进程，再重启Laragon的MySQL服务。

5. 重置Laragon MySQL（极端情况） #

• 若以上方法无效，可尝试重置：
  1. 停止Laragon的MySQL服务
  2. 备份Laragon目录下data\mysql文件夹（存放数据库文件）
  3. 删除data\mysql文件夹
  4. 通过Laragon面板Tools > Quick add > MySQL重新初始化MySQL
  5. 将备份的数据库文件恢复到新的mysql文件夹，重启服务

内容的提问来源于stack exchange，提问作者Isaac Method R'