解決 Linux 下 "mysql: command not found" 環境變量問題

解決 Linux 下 "mysql: command not found" 環境變量問題

編譯安裝或二進制包安裝 MySQL 後，直接輸入 mysql 提示命令未找到，本質是 **MySQL `bin` 目錄未加入當前 Shell 的 `PATH` 環境變量**。

快速定位 MySQL 安裝路徑

find / -name mysql -type f 2>/dev/null | grep '/bin/mysql$'
# 典型輸出：/usr/local/mysql/bin/mysql

方案一：創建軟鏈接（臨時/單用戶生效）

ln -s /usr/local/mysql/bin/mysql /usr/bin/mysql
# 或鏈接整個 bin 目錄
ln -s /usr/local/mysql/bin /usr/bin/mysql-bin

優點： 即時生效，無需重新登錄。
缺點： 系統升級/重裝可能覆蓋 /usr/bin；僅解決 mysql 客戶端，mysqldump、mysqladmin 等工具仍需單獨鏈接。

方案二：配置環境變量（永久/全局生效，推薦）

1. 當前用戶永久生效（~/.bash_profile 或 ~/.bashrc）

echo 'export PATH=/usr/local/mysql/bin:$PATH' >> ~/.bash_profile
source ~/.bash_profile

2. 所有用戶永久生效（/etc/profile）

echo 'export PATH=/usr/local/mysql/bin:$PATH' >> /etc/profile
source /etc/profile

3. 專用配置文件（模塊化管理，最佳實踐）

cat > /etc/profile.d/mysql.sh <<'EOF'
export MYSQL_HOME=/usr/local/mysql
export PATH=$MYSQL_HOME/bin:$PATH
EOF
chmod +x /etc/profile.d/mysql.sh
source /etc/profile.d/mysql.sh

驗證： which mysql 應輸出 /usr/local/mysql/bin/mysql；mysql --version 正常顯示版本。

Docker/容器環境特殊處理

若在容器中構建鏡像，直接在 Dockerfile 中設置：

ENV MYSQL_HOME=/usr/local/mysql
ENV PATH=$MYSQL_HOME/bin:$PATH

或使用多階段構建從官方鏡像複製二進制文件。

常見坑點排查

• 路徑寫錯： 確認是 bin 目錄而非安裝根目錄。
• 權限問題： chmod +x /usr/local/mysql/bin/* 確保可執行權限。
• 多版本共存： 使用 update-alternatives 管理優先級，或在啟動腳本中顯式指定完整路徑。
• 非交互式 Shell： cron、systemd、ssh 遠程命令 不加載 .bash_profile，需在腳本頭部 source /etc/profile 或使用完整路徑 /usr/local/mysql/bin/mysql。

配置好 /etc/profile.d/mysql.sh 並 source 後，所有交互式/登錄 Shell 均可直接使用 MySQL 全套工具，一勞永逸。