MySQL 版本過低報錯「Mysql version can not be less than 4.1」排查與修復

錯誤現象

網站啟動報錯：Mysql version can not be less than 4.1，實際資料庫版本明顯高於 4.1（如 5.1、5.5、5.6）。

根因：配置檔與實際資料庫不匹配

程式讀取配置檔（如 config.inc.php）中的資料庫連線參數（主機、埠、用戶、密碼、資料庫名）與實際資料庫實例不一致，導致連線到錯誤實例或連線協商失敗，框架誤判為版本過低。

排查步驟

1. 確認實際資料庫版本：mysql -V 或 SELECT VERSION();
2. 檢查應用配置檔：
   database_address（通常 localhost 或 IP）
   database_username
database_tablename（資料庫名）
   database_password
3. 用相同參數手動測試連線：
   mysql -h -u -p
4. 若手動連線成功 → 配置檔參數錯誤（空格、編碼、大小寫）
5. 若手動連線失敗 → 資料庫服務未啟動、防火牆、權限、埠不對

常見配置錯誤

• 密碼含特殊字符未轉義（XML/JSON/PHP 雙引號嵌套）
• 資料庫名與用戶名混淆
• 連線埠非 3306 未在配置中指定
• Windows 下 localhost 解析為 IPv6 ::1 而資料庫僅綁定 IPv4，改用 127.0.0.1

修復清單

1. 修正配置檔參數與實際資料庫一致
2. 確保編碼為 UTF-8 無 BOM
3. 重啟應用服務（PHP-FPM、Tomcat、Nginx 等）
4. 驗證網站正常訪問

延伸：真正版本過低怎麼辦

• MySQL 4.1 發布於 2003 年，已停止維護 15+ 年
• 最低建議 5.7（2023 年 EOL）或 8.0 LTS
• 升級路徑：5.1 → 5.5 → 5.6 → 5.7 → 8.0，逐版本 mysql_upgrade
• 或邏輯遷移：mysqldump → 新版導入

遇到版本報錯先查配置，十之八九是參數對不上；真版本過低請規劃升級路徑，勿在舊版鑽研相容性。