MySQL 4.1 引入新雜湊演算法 (41 字元十六進位),舊版客戶端庫 (PHP mysql 擴充、舊版 libmysqlclient) 僅支援舊 16 字元雜湊,導致驗證失敗。
Client does not support authentication protocol requested by server;
consider upgrading MySQL client
| 方案 | 操作 | 優點 | 缺點 | 適用場景 |
|---|---|---|---|---|
| 方案 A:降級密碼雜湊 (官方文件標準解法) |
SET PASSWORD FOR 'user'@'host' = OLD_PASSWORD('newpwd');或 UPDATE mysql.user SET Password=OLD_PASSWORD('newpwd') WHERE User='user' AND Host='host'; FLUSH PRIVILEGES;
| 即時生效、無需升級客戶端 | 安全性降低 (舊雜湊易暴力破解)、MySQL 5.7+ 已移除 OLD_PASSWORD | 舊專案無法升級 PHP/驅動的緊急過渡 |
| 方案 B:升級客戶端庫 (根治) |
| 支援新式雜湊、SSL、預處理、多查詢、完整功能 | 需修改程式碼/重新編譯/重新部署 | **所有新專案、可維護窗口的舊專案** |
方案 C:MySQL 伺服端設定 default_authentication_plugin=mysql_native_password (MySQL 8.0+) |
[mysqld]
| 不改密碼、不改客戶端即可相容 | 僅相容 mysql_native_password (SHA-1),非最新 caching_sha2_password | MySQL 8.0 過渡期專用 |
<?php
// 舊寫法 (mysql 擴充 - 已移除)
$link = mysql_connect('localhost', 'user', 'old_hashed_pass');
mysql_select_db('db');
// 新寫法 (mysqli 物件導向 + mysqlnd)
$mysqli = new mysqli('localhost', 'user', 'plaintext_password', 'db');
$mysqli->set_charset('utf8mb4');
// 或 PDO (推薦,支援多資料庫)
$pdo = new PDO('mysql:host=localhost;dbname=db;charset=utf8mb4', 'user', 'plaintext_password', [
PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
PDO::ATTR_EMULATE_PREPARES => false, // 真實預處理
]);
// 預處理語句範例
$stmt = $pdo->prepare('SELECT * FROM users WHERE email = ? AND status = 1');
$stmt->execute([$email]);
$user = $stmt->fetch();
mysql> SHOW VARIABLES LIKE 'have_%';
+----------------+-------+
| Variable_name | Value |
+----------------+-------+
| have_innodb | YES |
| have_ssl | YES |
| have_symlink | YES |
+----------------+-------+
重點確認 have_openssl、have_ssl 為 YES,確保加密連線可用。
「降級密碼」只是止血,**升級客戶端庫才是根治**。MySQL 5.7 (2023 EOL) 、8.0 (2026 EOL) 已移除 OLD_PASSWORD,所有專案應在 2024 年完成遷移至 mysqli/PDO + mysqlnd 或更高版本連接器,並啟用 caching_sha2_password 享受最佳安全性能。