萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

MySQL 4.1+ 升級後「Client does not support authentication protocol」錯誤解決方案

錯誤原因

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:升級客戶端庫 (根治)
  • PHP: 改用 mysqli / PDO_MySQL + mysqlnd (PHP 5.3+ 內建)
  • 命令列: 升級 MySQL Client 套件
  • 連接器: Connector/J, Connector/NET, Connector/ODBC 升級最新版
支援新式雜湊、SSL、預處理、多查詢、完整功能需修改程式碼/重新編譯/重新部署**所有新專案、可維護窗口的舊專案**
方案 C:MySQL 伺服端設定 default_authentication_plugin=mysql_native_password (MySQL 8.0+) [mysqld]
default_authentication_plugin=mysql_native_password
不改密碼、不改客戶端即可相容僅相容 mysql_native_password (SHA-1),非最新 caching_sha2_passwordMySQL 8.0 過渡期專用

PHP 具體遷移步驟 (方案 B 推薦)

<?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 享受最佳安全性能。

copyright © 萬盛學電腦網 all rights reserved