Navicat连接MariaDB云实例失败的主因是白名单未配置或未开启公网地址，需在云平台控制台添加当前公网IP、启用公网访问、放行3306端口，并在Navicat中使用MySQL连接类型、指定公网域名、设置默认数据库及utf8mb4字符集，同时开启保活机制防超时断连。
Navicat 连接失败：提示 “Access denied” 或 “Connection refused”
大概率是白名单没开，或者实例没暴露公网地址。mariadb 云实例默认不开放外网访问，必须手动配置安全组和白名单（即允许连接的 ip 列表）。
实操建议：
- 登录云厂商控制台（如腾讯云、阿里云、DigitalOcean），找到对应 MariaDB 实例 → 网络与安全 → 白名单/安全组 → 添加当前电脑公网 IP（不是内网 IP）。可临时填
0.0.0.0/0测试，但上线前务必收紧 - 确认实例已开启“公网地址”或“公共网络访问”，部分云平台需单独申请并绑定弹性 IP
- 检查云防火墙是否拦截了
3306端口（有些厂商默认关闭该端口，即使白名单开了也不通） - Navicat 中主机名填的是公网地址（如
rm-xxxx.mysql.rds.aliyuncs.com），不是内网地址（10.x.x.x）
Navicat 配置时选错连接类型：MySQL 还是 MariaDB？
Navicat 没有独立的 “MariaDB” 连接类型，统一用 MySQL 协议连接——这是对的，不用强行找“MariaDB”选项。
关键点在于驱动兼容性与参数微调：
- 连接类型选
MySQL，版本尽量选MySQL 5.7+或Auto-detect；MariaDB 10.2+ 兼容 MySQL 5.7 协议，基本无坑 - 如果遇到认证失败（比如
Client does not support authentication protocol requested by server），说明服务端用了mysql_native_password以外的插件（如unix_socket或新默认的caching_sha2_password），但云厂商通常已禁用后者，不必手动切 - 勾选
Use SSL前先确认云实例是否启用 SSL 连接（控制台里看“SSL 开启状态”），否则连不上；若启用，需下载对应 CA 证书，在 Navicat 的 SSL 设置中指定CA File
用户名密码能登录，但看不到数据库或表权限不足
云数据库默认不给 root 权限，创建的账号通常是只读或限定库级权限，不是全库 GRANT ALL。
排查路径很直接：
- 用命令行或控制台自带 SQL 工具执行
SHOW GRANTS FOR 'your_user'@'%';，确认是否包含目标库（如myapp_db.*）的SELECT/INSERT等权限 - Navicat 左侧“数据库”列表为空，可能是未在连接设置中指定
Default database；在连接配置的Advanced标签页里填上具体库名，否则默认不加载任何 schema - 某些云平台（如 AWS RDS）禁止使用
CREATE USER或GRANT，权限变更必须走控制台“账号管理”页面操作，不能直接跑 SQL
连接成功但查询慢、偶尔断连：注意超时与字符集
云端 MariaDB 通常设了较短的 wait_timeout（如 300 秒），空闲连接会被主动断开；Navicat 默认不自动重连，导致执行长查询或切 Tab 后再操作就报错。
应对方式要兼顾服务端和客户端：
- 在 Navicat 连接配置的
Connection Settings里勾选Keep connection alive (every X seconds)，填60是个稳妥值 - 字符集别依赖默认：在连接配置的
Advanced页，把Default charset明确设为utf8mb4，避免中文乱码或插入 emoji 失败 - 如果执行
SELECT返回结果卡顿，先在控制台看实例 CPU / 连接数监控；云数据库连接数有限（如 100），Navicat 开太多查询 Tab 可能占满连接池
白名单、公网地址、协议选型、权限粒度、空闲超时——这五处任一漏掉，都会让 Navicat 连得上却用不了。尤其是白名单 IP 和 Default database，新手最容易在这两个地方卡住半天。
