根本原因是MariaDB未监听TCP端口,需注释skip-networking、设置bind-address=0.0.0.0或127.0.0.1并重启服务;Navicat应选MySQL类型,版本设为5.7+;权限需单独授权'root'@'127.0.0.1';启用MySQL Keep-Alive防超时断连。
Navicat 连接 MariaDB 10.11 提示 “Connection refused” 怎么办
根本原因是 mariadb 服务没监听 tcp 网络端口,只启用了本地 socket 连接。macos 用 port install mariadb-server 安装的默认配置里,skip-networking 是开启的,bind-address 也常被注释或设为 127.0.0.1,导致 navicat 无法通过 localhost:3306 建立连接。
实操建议:
- 打开配置文件:
/opt/local/etc/mariadb-10.11/my.cnf或/opt/local/etc/mariadb-10.11/macports-default.cnf - 找到并注释掉这一行:
skip-networking - 确保
[mysqld]段落中有明确绑定:bind-address = 0.0.0.0(若只要本机连,可写127.0.0.1) - 重启服务:
sudo port unload mariadb1011-server && sudo port load mariadb1011-server - 验证是否监听:
lsof -i :3306或netstat -an | grep 3306,看到LISTEN才算生效
Navicat 新建连接时选 “MySQL” 还是 “MariaDB”?
选 MySQL。Navicat for MariaDB 是独立产品线,但标准版 Navicat(如 Navicat Premium、Navicat for MySQL)没有单独的 MariaDB 类型选项——它靠协议兼容性工作,不是靠“名字匹配”。MariaDB 10.11 默认使用 MySQL 5.7 协议,完全兼容 MySQL 连接类型。
关键参数设置:
-
连接类型:选MySQL -
版本:设为MySQL 5.7+或Auto-detect(避免选 5.0/5.1,可能触发旧认证插件问题) -
主机名:填localhost或实际 IP,别填127.0.0.1和localhost混用(权限表里 host 匹配严格) -
字符集:显式设为utf8mb4,避免插入 emoji 或四字节字符时报错
能连上但看不到数据库,或提示 “Access denied for user”
不是密码错,是权限粒度问题。MariaDB 10.11 默认创建的用户(比如 root)在 mysql.user 表里 host 字段通常是 localhost,而 Navicat 从 TCP 连进来时,服务器识别的 host 是 127.0.0.1(哪怕你填的是 localhost),两者不等价。
解决办法(登录 MariaDB 控制台后执行):
- 确认当前用户 host:
SELECT User, Host FROM mysql.user WHERE User = 'root'; - 如果只有
localhost,补一条通配 host:GRANT ALL PRIVILEGES ON *.* TO 'root'@'127.0.0.1' IDENTIFIED BY 'your_password'; - 或者更干脆:
GRANT ALL PRIVILEGES ON *.* TO 'root'@'%' IDENTIFIED BY 'your_password';(仅测试环境用) - 别漏掉:
FLUSH PRIVILEGES;
注意:% 不代表“任意地址”,它不匹配 localhost;Unix socket 连接走的是 localhost,TCP 连接走的是 127.0.0.1 或真实 IP,必须分开授权。
连接成功但几分钟后自动断开
Navicat 默认不发保活包,MariaDB 的 wait_timeout 默认 28800 秒(8 小时),但云实例或某些配置会压到 300 秒(5 分钟)。空闲连接超时后,Navicat 不会自动重连,表现为查询卡住或报错 Lost connection to MySQL server during query。
两个层面解决:
- 服务端调大(需有 SUPER 权限):
SET GLOBAL wait_timeout = 28800;(临时)或改配置文件加wait_timeout = 28800 - 客户端启用保活:
Navicat → 连接属性 → 高级 → 勾选 “MySQL Keep-Alive”,间隔设为 60 秒即可 - 额外提醒:如果用了 SSH 隧道,还要检查 SSH 服务端的
ServerAliveInterval,否则隧道先断
真正容易被忽略的是 host 匹配细节和 keep-alive 开关——这两个点不处理,其他都调对了也会隔几分钟就断一次。











