通过SSH使用MySQL Workbench连接MySQL失败，命令行连接正常求助

可通过SSH成功登录VM，也能在VM内通过命令行连接MySQL服务器，但使用MySQL Workbench通过SSH隧道连接时，使用相同凭证和IPv4地址，出现如下错误：

Failed to Connect to MySQL at :3306 through SSH tunnel at user@VM with user .
Unable to Connect to localhost.

本地未安装MySQL，可成功执行的命令行操作流程：

1. 登录VM：ssh user@<ipaddress of VM>
2. 连接MySQL：mysql -h <Mysqlhost> -u <user> -p <database> -A

• 修正Workbench的MySQL目标地址配置
  命令行连接MySQL用的是<Mysqlhost>，但Workbench若默认填localhost会导致失败。需将Workbench中「Connection Method」选为Standard TCP/IP over SSH，然后在「MySQL Hostname」处填写你命令行里的<Mysqlhost>，而非localhost。

• 检查SSH隧道端口转发设置
  Workbench默认会把远程3306端口转发到本地端口，若本地该端口被占用，或VM内MySQL监听的不是3306端口，就会连接失败。可在Workbench的SSH设置中，将「Remote Port」改为MySQL实际监听的端口，「Local Port」改为本地未被占用的端口（比如3307），同时确保VM防火墙允许该端口的流量。

• 调整MySQL的绑定地址
  登录VM，打开MySQL配置文件（常见路径：/etc/mysql/my.cnf或/etc/mysql/mysql.conf.d/mysqld.cnf），查看bind-address参数。如果该参数设为127.0.0.1，MySQL仅允许VM本地访问，需改为0.0.0.0或VM的内网IP，之后重启MySQL服务：sudo systemctl restart mysql。

• 确认MySQL用户的访问权限
  检查你使用的MySQL用户<user>是否允许从SSH隧道的上下文访问。若用户权限为user@localhost，仅能在VM本地登录，需调整为user@127.0.0.1（SSH隧道相当于从VM的localhost发起访问）或user@%（允许任意地址访问）。在VM内执行以下SQL命令：

  -- MySQL 5.x及版本
  GRANT ALL PRIVILEGES ON <database>.* TO '<user>'@'127.0.0.1' IDENTIFIED BY '<password>';
  FLUSH PRIVILEGES;
  
  -- MySQL 8.0+版本
  CREATE USER '<user>'@'127.0.0.1' IDENTIFIED BY '<password>';
  GRANT ALL PRIVILEGES ON <database>.* TO '<user>'@'127.0.0.1';
  FLUSH PRIVILEGES;
  

• 排查Workbench的SSH配置细节
  确保Workbench中填写的SSH用户名、VM地址与命令行完全一致，无多余空格；若使用SSH密钥登录，需指定正确的私钥文件路径；若使用密码登录，确认密码输入无误。

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