MySQL 8.0 への接続エラー：Client does not support authentication protocol requested by server

2024-04-02

エラーメッセージ：MySQL 8.0 - Client does not support authentication protocol requested by server; consider upgrading MySQL client

このエラーメッセージは、mysql クライアントが MySQL 8.0 サーバーが要求する認証プロトコルをサポートしていない場合に発生します。解決するには、以下のいずれかの方法を試してください。

原因

このエラーメッセージは、以下のいずれかの原因で発生します。

使用している mysql クライアントが古いバージョンである。
MySQL 8.0 サーバーで新しい認証プラグインが有効になっている。

解決方法

以下のいずれかの方法で解決できます。

mysql クライアントを最新バージョンにアップグレードする

mysql クライアントを最新バージョンにアップグレードすることで、最新の認証プロトコルに対応できます。

MySQL 8.0 サーバーでは、古い認証プラグインを有効にすることで、古いクライアントからの接続を受け付けることができます。

詳細

mysql クライアントをアップグレードするには、以下の手順に従ってください。

MySQL の公式ダウンロードページから、最新バージョンの mysql クライアントをダウンロードします。
ダウンロードしたファイルを解凍します。
解凍したフォルダに移動し、以下のコマンドを実行します。

./configure
make
sudo make install

MySQL サーバーの配置文件を開きます。

vim /etc/mysql/mysql.conf.d/mysqld.cnf

以下の行を追加します。

default_authentication_plugin=mysql_native_password

sudo service mysql restart

補足

上記の解決方法で問題が解決しない場合は、その他の原因が考えられます。詳細は、上記の参考資料を参照してください。
MySQL 8.0 サーバーで古い認証プラグインを有効にすることは、セキュリティ上のリスクを伴います。可能な限り、mysql クライアントを最新バージョンにアップグレードすることを推奨します。

const mysql = require('mysql');

const connection = mysql.createConnection({
  host: 'localhost',
  user: 'root',
  password: 'password',
  database: 'database'
});

connection.connect((err) => {
  if (err) {
    console.error(err);
    return;
  }

  console.log('Connected to MySQL server');

  connection.query('SELECT * FROM users', (err, results) => {
    if (err) {
      console.error(err);
      return;
    }

    console.log(results);

    connection.end();
  });
});

実行方法

上記のコードをファイルに保存します。
以下のコマンドを実行して、コードを実行します。

node filename.js

出力例

Connected to MySQL server

[
  {
    "id": 1,
    "name": "John Doe",
    "email": "[email protected]"
  },
  {
    "id": 2,
    "name": "Jane Doe",
    "email": "[email protected]"
  }
]

上記のコードは、mysql モジュールのバージョン 2.18.1 を使用しています。古いバージョンのモジュールを使用している場合は、コードを修正する必要があります。
上記のコードは、localhost 上の MySQL 8.0 サーバーに接続しています。異なるホスト上のサーバーに接続する場合は、host オプションを変更する必要があります。
上記のコードは、root ユーザーで接続しています。異なるユーザーで接続する場合は、user オプションと password オプションを変更する必要があります。