できない.dev

MySQL「Client does not support authentication protocol」の原因と直し方

Client does not support authentication protocol は、クライアントやドライバを更新すれば直る。
MySQL 8 の既定認証 caching_sha2_password に古いクライアントが未対応なためである。

公開: 更新:

症状できない · exit 1
node old.js
ER_NOT_SUPPORTED_AUTH_MODE: Client does not support authentication protocol requested by server; consider upgrading MySQL client
解決後できた · exit 0
node old.js
connected with mysql 2.18.1

2026-10-11 に mysql:8.0(MySQL 8.0.46) で実際に打って取った出力。検証環境の詳細

要約

MySQL 8.0 は既定のパスワード認証プラグインが caching_sha2_password に変わった。

古い MySQL クライアントや一部の言語ドライバは、この方式に対応していない。
その場合、接続は「Client does not support authentication protocol requested by server; consider upgrading MySQL client」で弾かれる。

最初に選ぶ対処は、クライアント / ドライバの更新である。
更新が難しい場合だけ、ユーザー単位で従来の認証方式に切り替える。

実行例

MySQL 8.0.46 では新規ユーザーの認証プラグインが caching_sha2_password になっており、mysql 2.18.1 で接続すると ER_NOT_SUPPORTED_AUTH_MODE で終了コード 1 になった。
同じユーザーのまま mysql2 3.24.5 を使うと、接続できた。
ALTER USER で mysql_native_password に切り替えると、mysql 2.18.1 でも接続できた。

$ mysql -u root -t < plugin.sql
+------+-----------+-----------------------+
| user | host      | plugin                |
+------+-----------+-----------------------+
| app  | localhost | caching_sha2_password |
+------+-----------+-----------------------+
$ node old.js
ER_NOT_SUPPORTED_AUTH_MODE: Client does not support authentication protocol requested by server; consider upgrading MySQL client
$ echo $?
1
$ node new.js
connected with mysql2 3.24.5
$ echo $?
0
$ mysql -u root -v < alter.sql
--------------
ALTER USER 'app'@'localhost' IDENTIFIED WITH mysql_native_password BY 'yourpassword'
--------------
 
--------------
FLUSH PRIVILEGES
--------------
$ mysql -u root -t < plugin.sql
+------+-----------+-----------------------+
| user | host      | plugin                |
+------+-----------+-----------------------+
| app  | localhost | mysql_native_password |
+------+-----------+-----------------------+
$ node old.js
connected with mysql 2.18.1
$ echo $?
0

— 2026-10-11 時点の出力

検証環境MySQL 8.0.46 / 2026-10-11 検証
検証日
実行環境
mysql:8.0 Oracle Linux Server 9.7
バージョン
  • MySQL 8.0.46

この記事の「実行例」は、上記の環境で実際にコマンドを実行して得られた出力をそのまま掲載しています。 再現手順はリポジトリの検証スクリプトとして管理し、定期的に再実行して出力を更新しています。

解決策

1. クライアント / ドライバを更新する(推奨)

Node なら mysql2、Python なら新しい PyMySQL / mysqlclient を使うと caching_sha2_password に対応する。
恒久的に直すには、まずライブラリのバージョンを上げる。

2. ユーザーの認証方式を変更する

更新できない場合、そのユーザーだけ従来方式にする。

ALTER USER 'app'@'%' IDENTIFIED WITH mysql_native_password BY 'yourpassword';
FLUSH PRIVILEGES;

ただし mysql_native_password は、MySQL 8.4 では既定で無効である。
サーバーを --mysql-native-password=ON で起動しないと、上の ALTER USER は Plugin 'mysql_native_password' is not loaded で失敗する。
MySQL 9.0 では削除済みなので、この方法はあくまで 8.x 系での暫定策とする(MySQL 8.4 の Native Pluggable Authentication(新しいタブで開く))。
プラグインの詳細は MySQL 公式の caching_sha2_password 解説(新しいタブで開く) にある。

3. 新規構築なら作成時に指定する

CREATE USER 'app'@'%' IDENTIFIED WITH caching_sha2_password BY 'yourpassword';

接続を TLS にすれば caching_sha2_password でも安全に鍵交換できる。

よくある原因

  1. サーバ側が MySQL 8 で、既定の認証方式が caching_sha2_password になっている。
  2. クライアントやドライバが古く、caching_sha2_password に対応していない。
  3. アプリのライブラリが mysql_native_password 前提で組まれている。