安装Laragon后无法连接本地MariaDB的问题求助

环境信息 #

• OS: Windows 11
• Laragon full V6.0
• MariaDB V11.2

问题简述 #

安装Laragon后，无法连接此前单独安装在Program Files中的MariaDB服务器，报错：
ERROR 2002 (HY000): Can't connect to server on 'localhost' (10061)

详细描述 #

从XAMPP切换到Laragon，此前已安装MariaDB用于项目开发。在XAMPP时期曾遇到类似端口冲突问题，修改MySQL端口后解决；但安装Laragon后，即使将Laragon自带的MySQL端口改为3360（原MariaDB使用3306），仍无法连接原MariaDB；关闭Laragon控制面板中的MySQL服务后问题依旧。

已通过PS > netstat -a -o检查，3306和3360端口均未被占用。

测试情况：

• 使用mariadb -h localhost -P 3306 -u root -p连接原MariaDB失败
• 启动Laragon的MySQL后，mariadb -h localhost -P 3360 -u root -p可成功连接Laragon自带的数据库
• 关闭Laragon的MySQL后，两个端口的连接请求均报错

推测Laragon的相关配置阻止了对原MariaDB的访问。

需求 #

希望保留使用原有MariaDB服务器，寻求解决方法。

1. 用127.0.0.1代替localhost连接原MariaDB #

Laragon可能修改了localhost的解析优先级（比如指向socket而非TCP/IP），尝试用IP地址直接连接：

mariadb -h 127.0.0.1 -P 3306 -u root -p

2. 调整系统环境变量顺序 #

Laragon会自动将自身的bin目录（包含mysql/mariadb客户端）加入系统PATH，可能导致你调用的mariadb命令是Laragon自带版本，和原MariaDB服务器存在兼容性问题：

• 打开系统环境变量设置，找到PATH变量
• 把原MariaDB的bin目录路径（比如C:\Program Files\MariaDB 11.2\bin）移到Laragon相关路径的上方
• 重启终端后再尝试连接

3. 确认原MariaDB服务状态 #

虽然端口显示未被占用，但可能原MariaDB服务未启动：

• 按Win+R输入services.msc打开服务管理器
• 找到名为MariaDB的服务，确认其状态为正在运行，未启动则手动启动

4. 清理Laragon残留的MySQL服务 #

Laragon可能安装了隐藏的MySQL服务，即使关闭面板也在后台运行：

• 打开管理员权限的命令提示符，执行：

  sc query | findstr /i mysql
  sc query | findstr /i mariadb
  

• 如果发现不属于你原MariaDB的服务，执行sc delete [服务名]删除（比如sc delete MySQL80）

5. 检查原MariaDB的网络连接配置 #

确认原MariaDB允许TCP/IP连接：

• 找到原MariaDB的my.ini配置文件（通常在安装目录或C:\Program Files\MariaDB 11.2\data下）
• 检查[mysqld]段是否有以下配置：

  bind-address = 127.0.0.1
  port = 3306
  

• 如果有skip-networking配置，注释掉它，然后重启MariaDB服务

6. 彻底终止Laragon相关进程 #

关闭Laragon面板后，打开任务管理器，结束所有包含laragon、mysql、mariadb的进程，再尝试连接原MariaDB

内容的提问来源于stack exchange，提问作者Basile