解決「Mysql version can not be less than 4.1」版本檢查誤報錯誤

應用啟動時報錯 Mysql version can not be less than 4.1，直覺以為是資料庫版本過低，實際上 MySQL 5.0/5.5/5.6 均滿足需求。經排查，**真正原因是應用設定檔未正確指向資料庫連線資訊**，導致版本檢查邏輯讀取到空值或預設值，誤判版本不符。

錯誤場景重現

# 應用啟動日誌
ERROR: Mysql version can not be less than 4.1
# 但實際資料庫版本
mysql> SELECT VERSION();
+-----------+
| VERSION() |
+-----------+
| 5.6.10    |
+-----------+

根因分析

應用啟動時會執行版本相容性檢查（如 SELECT VERSION() 解析主版本號），若**資料庫連線參數錯誤**（主機、埠、帳號、密碼、資料庫名任一不符），連線失敗或連到錯誤實例，檢查邏輯捕獲異常後拋出預設錯誤訊息「版本過低」，實為**連線配置錯誤的誤導性提示**。

解決步驟

1. 定位應用設定檔（常見路徑）：
   • PHP：config.inc.php、config/db.php、.env
   • Java：jdbc.properties、application.yml、db.properties
   • Python：settings.py、config.yaml
   • .NET：web.config、appsettings.json
2. 核對並修正關鍵參數：

   # 典型 PHP 設定檔範例
   $dbHost = "localhost";      # 或實際 DB IP
   $dbName = "my_database";    # 確切資料庫名稱
   $dbUser = "app_user";       # 具備權限的帳號
   $dbPass = "correct_pass";   # 正確密碼
   $dbPort = 3306;             # 非預設埠必須指定

3. 若 Web 伺服器與 DB 伺服器分離，確認 $dbHost 為 DB 伺服器內網 IP，非 localhost。
4. 重啟應用服務（PHP-FPM、Tomcat、Gunicorn、IIS 等）驗證。

其他可能原因（較少見）

• 資料庫確實為 4.0 或更早版本（極罕見）。
• 連線驅動程式版本過舊，無法正確解析新版 MySQL 回傳的版本字串（如 JDBC 5.1.38 以前版本）。
• 中間件（ProxySQL、MaxScale）版本檢查邏輯缺陷。

快速驗證指令

# 命令列直接測試連線與版本
mysql -h $dbHost -P $dbPort -u $dbUser -p$dbPass -e "SELECT VERSION();"

# 若成功顯示版本號，說明應用設定檔參數有誤

最佳實踐

• 將資料庫連線參數外部化至環境變數或設定中心（Consul、Nacos、Apollo），避免硬編碼與環境不一致。
• 應用啟動時執行 健康檢查：實際建立連線、執行 SELECT 1、檢查版本，失敗時輸出詳細錯誤（主機不可達、認證失敗、權限不足），而非通用版本錯誤。
• 使用連線池庫（HikariCP、Druid、Pool2）內建驗證查詢 connectionInitSql=SELECT 1 提前發現問題。