DockerでFlask+MySQLを動かしたときのAccess deniedエラー


はじめに

DockerでFlaskとMySQLのコンテナを立てて、FlaskからMySQLに接続しようとするとFlaskがエラーを吐いて落ちてしまう状況に何度か遭遇した。対処方法として万人に有効かは分からないが、一応記録する。

出たエラー

ERROR 1045 (28000): Access denied for user 'root'@'localhost' (using password: YES)

解決方法

MySQLにマウントしているディレクトリを一旦消してからコンテナを立て直す。

解説

このエラーが出る原因のひとつは、MySQLの設定を変えてからコンテナを立て直したことである。自分の場合は、環境変数のMYSQL_ROOT_PASSWORDを別のものに書き換えたことが原因だった。
MySQLコンテナが初めて立ち上がる際には、MySQLサーバーの設定ファイル群が自動で作られる。これらは永続ボリュームに保存される。そのため、MySQLの設定を変えた場合は、設定ファイル群を作り直す必要があったのだ。
しかし、一度コンテナを立てると、設定を変えても作り直されることはないため、上記のようなエラーが出ることになる。なので、解決方法としてはボリュームの中身を削除するか、MySQLサーバーに入って設定をいじるということになる。
環境構築の段階で起きやすいエラーなので、作り直してしまった方が早そうである。

まとめ

コンテナ上のMySQLサーバーの設定を変更した場合は、コンテナだけでなくデータベースのディレクトリを作り直さないとエラーが出る場合がある。