[mysql] mysql_native_password に切り替える必要があるとき

Tech
[mysql] mysql_native_password に切り替える必要があるとき

古いアプリケーションを動かすときにぶつかることがあるので。

症状

MySQL 8.0 に、古い PHP や古いクライアントライブラリから接続しようとすると、こういうエラーが出ることがあります。

The server requested authentication method unknown to the client
Authentication plugin 'caching_sha2_password' cannot be loaded

MySQL 8.0 から、ユーザーのデフォルトの認証方式が mysql_native_password から caching_sha2_password に変わりました。新しい方式に対応していないクライアントは、そもそもログインできません。

今の認証方式を確認する

確認はこれ。

SELECT user, host, plugin FROM mysql.user;

plugin 列が caching_sha2_password になっているユーザーが対象です。

切り替える: ALTER USER を使う

ALTER USER 'user'@'%' IDENTIFIED WITH mysql_native_password BY 'パスワード';

認証方式とパスワードを、同時に設定し直します。

⚠️ 以前この記事では UPDATE mysql.user SET plugin = 'mysql_native_password' ... と書いていましたが、MySQL 8.0 でこの方法を使うと、保存されているパスワードの形式と認証方式が食い違ってログインできなくなることがあります。システムテーブルを直接書き換えるのは避けて、ALTER USER で変更してください。

'user'@'%' の % の部分は、SELECT で確認した host 列の値に合わせます。

新規ユーザーのデフォルトを変える(MySQL 8.0)

my.cnf にこれを記載しておけば、新規発行したユーザーは mysql_native_password になる。

[mysqld]
default_authentication_plugin=mysql_native_password

Docker の mysql:8.0 イメージなら、compose ファイルの command で渡すのがよく見る書き方です。

services:
  db:
    image: mysql:8.0
    command: --default-authentication-plugin=mysql_native_password

MySQL 8.4 以降での注意

ここは2020年当時から事情が変わっています。

バージョンmysql_native_password の扱い
8.0使える(8.0.34 で非推奨)
8.4 LTSデフォルトで無効。使うにはサーバー設定で明示的に有効化が必要。default_authentication_plugin も廃止
9.0 以降削除

8.4 でどうしても使う場合は、my.cnf の [mysqld] に mysql_native_password=ON を書いて有効化します。

つまり、mysql_native_password への切り替えはその場しのぎです。長く使うなら、アプリ側のクライアント(PHP なら 7.4 以降の mysqlnd など)を caching_sha2_password に対応したものに上げるのが本筋です。

まとめ

  • MySQL 8.0 の認証エラーは、デフォルトの認証方式が変わったのが原因
  • 切り替えは ALTER USER ... IDENTIFIED WITH mysql_native_password BY ...(UPDATE で直接書き換えない)
  • 8.4 で無効化、9.0 で削除。根本対策はクライアント側を新しくすること

DB とユーザーの作り方はDB作成、ユーザー発行、権限付与にまとめています。

mysql