无法连接远程MariaDB服务器（错误2002）的技术求助

可能的原因及解决步骤 #

1. SSL连接设置不匹配 #

• 检查远程服务器的MariaDB配置文件：
  Ubuntu系统找/etc/mysql/mariadb.conf.d/50-server.cnf，Mac系统找/usr/local/etc/my.cnf，查看是否开启了强制SSL：

  require_secure_transport = ON
  

  如果开启了，本地连接时需添加--ssl-mode=REQUIRED参数；或者临时将该配置改为OFF测试（生产环境不建议随意修改）。
  也可以直接尝试禁用SSL连接，验证是否能连通：

  mysql -h host.sld.TLD -P 3306 -u user --ssl-mode=DISABLED
  

2. 用户权限配置有误 #

• 登录远程服务器的MariaDB，确认用户权限配置：

  SELECT user, host FROM mysql.user WHERE user='user';
  

  确保host字段为你的本地IP，或设为%（允许所有IP连接，仅用于测试）。再查看权限详情：

  SHOW GRANTS FOR 'user'@'你的本地IP';
  

  同时检查是否意外设置了密码：

  SELECT user, authentication_string FROM mysql.user WHERE user='user';
  

  如果authentication_string不为空，说明存在密码，要么删除该密码，要么连接时添加-p参数输入密码。

3. 客户端与服务器认证插件不兼容 #

• 从telnet返回内容可知，服务器使用的是mysql_native_password插件，而本地10.9.3版本的MariaDB默认可能采用caching_sha2_password。先查看本地客户端的默认插件：

  mysql --help | grep default-auth
  

  如果确实是caching_sha2_password，连接时指定插件尝试：

  mysql -h host.sld.TLD -P 3306 -u user --default-auth=mysql_native_password
  

4. 本地配置文件干扰 #

• 检查本地的~/.my.cnf或/usr/local/etc/my.cnf文件，是否存在错误配置（比如默认强制SSL、错误端口等），先将文件重命名备份，再重试连接：

  mv ~/.my.cnf ~/.my.cnf.bak
  

5. 本地安全工具拦截 #

• 尽管telnet能连通，但本地杀毒软件、防火墙可能专门拦截MariaDB客户端的连接，可暂时关闭这类工具测试。

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