如何从GCE实例连接Cloud SQL？遇-bash: mysql: command not found错误

核心原因 #

-bash: mysql: command not found说明系统无法定位到MySQL客户端的可执行文件，大概率是未正确安装MySQL客户端包，或者安装后路径未加入系统环境变量。

分步解决 #

1. 确认并安装MySQL客户端包

根据GCE实例的操作系统类型，执行对应安装命令：

• Debian/Ubuntu 系列：

  sudo apt update
  sudo apt install mysql-client -y
  

• RHEL/CentOS/Rocky Linux 系列：

  sudo dnf install mysql -y
  

2. 验证安装并定位命令路径

安装完成后，执行以下命令确认mysql命令是否可被系统识别：

which mysql

如果返回类似/usr/bin/mysql的路径，说明安装成功，直接重新执行连接命令即可：

mysql -u root -p --host 127.0.0.1 --port 3306

3. 若仍无法识别，手动添加环境变量

如果which mysql无输出，先找到mysql可执行文件的位置：

find / -name mysql -type f -executable

假设找到的路径是/usr/local/mysql/bin/mysql，临时将该路径加入环境变量：

export PATH=$PATH:/usr/local/mysql/bin

执行后再次尝试连接命令。若要永久生效，将上述export语句添加到~/.bashrc文件末尾，然后执行source ~/.bashrc刷新配置。

4. 临时替代方案：使用完整路径执行命令

如果不想修改环境变量，直接用找到的完整路径执行连接命令，例如：

/usr/bin/mysql -u root -p --host 127.0.0.1 --port 3306

额外注意 #

• 确保Cloud SQL代理始终处于运行状态（你已确认代理启动成功，这一步没问题）
• 连接时输入的root密码是Cloud SQL实例设置的密码，而非GCE实例的系统密码

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