Docker中mariadb容器执行mysql命令提示‘command not found’的排查与解决需求

报错原因 #

1. mysql命令不在当前Shell的PATH环境变量中：官方MariaDB镜像中mysql客户端默认存在，但可能因容器启动时的环境变量配置，导致当前Shell无法直接定位到该命令的路径。
2. 镜像未预装mysql客户端：部分精简版MariaDB镜像（如基于Alpine的极小镜像）可能未包含客户端工具，需要手动安装。

解决办法 #

方法1：使用mysql命令的绝对路径执行 #

先在容器内查找mysql可执行文件的位置：

find / -name mysql -type f

通常会返回类似/usr/bin/mysql的路径，直接用绝对路径执行命令：

/usr/bin/mysql -u root -p

输入密码后即可进入MariaDB交互终端。

方法2：不进入容器，直接通过docker exec调用mysql #

跳过进入bash的步骤，直接执行：

docker exec -it mariadb mysql -u root -p

此命令会直接启动MariaDB客户端，输入密码后即可正常使用。

方法3：安装mysql客户端（适用于精简版镜像） #

如果上述方法都找不到mysql命令，说明镜像未预装客户端，根据镜像系统类型安装：

• Debian/Ubuntu系镜像：

apt update && apt install -y mariadb-client

• Alpine系镜像：

apk add --no-cache mariadb-client

安装完成后即可直接执行mysql -u root -p。

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