Dockerでローカル実行のMySQLデータベースに接続できない？「Access denied for user 'root'@'172.17.0.1'」エラーを解決しよう！

2024-04-11

Dockerでローカル実行のMySQLデータベースに接続できない？「Access denied for user 'root'@'172.17.0.1'」エラーを解決しよう！

ローカル環境でDockerを使ってMySQLデータベースを立ち上げたけど、いざ外部から接続しようとしたら...

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

接続できない！と焦る前に、落ち着いて原因を探っていきましょう。

原因

このエラーは、主に以下の2つの原因で発生します。

ユーザーとパスワードの設定ミス

Dockerで起動したMySQLデータベースは、デフォルトで外部からの接続を許可していないため、接続するにはユーザーとパスワードを設定する必要があります。設定が間違っていたり、忘れてしまったりすると、接続できずエラーが発生します。

ネットワークの設定ミス

Dockerは仮想環境を構築するため、外部からの接続にはネットワークの設定も必要です。設定が間違っていたり、ファイアウォールが接続を遮断していたりすると、エラーが発生します。

解決策

上記の原因を踏まえて、以下の手順で解決していきましょう。

まずは、ユーザーとパスワードの設定が正しいことを確認しましょう。

Dockerfile

Dockerfileでユーザーとパスワードを設定している場合は、設定内容に誤りがないか確認します。

環境変数

環境変数でユーザーとパスワードを設定している場合は、設定内容が正しく設定されていることを確認します。

パスワードの入力ミス

パスワードの入力ミスは意外と多いので、注意が必要です。コピー＆ペーストで入力すると、スペルミスを防ぐことができます。

次に、ネットワークの設定を確認しましょう。

Dockerのネットワーク設定

Dockerのネットワーク設定が正しく設定されていることを確認します。docker network inspectコマンドを実行して、ネットワークの設定を確認することができます。

ファイアウォールの設定

ファイアウォールが接続を遮断していないか確認します。必要に応じて、ファイアウォールの設定を変更する必要があります。

その他の確認事項

上記の設定を確認しても解決しない場合は、以下の点も確認してみてください。

MySQLのバージョン

古いバージョンのMySQLでは、このエラーが発生することがあるようです。MySQLのバージョンを最新版にアップデートすることで解決する場合があります。

Dockerのバージョン

上記の手順で解決できない場合は、エラーメッセージの内容や環境情報などを詳しく記載して、専門家に相談することをオススメします。

補足

上記の手順は、一般的な解決方法です。環境によっては、異なる解決方法が必要になる場合があります。
設定を変更する際は、事前にバックアップを取ることをオススメします。

サンプルコード：Dockerfileとdocker-compose.yml

FROM mysql:8.0

ENV MYSQL_ROOT_PASSWORD password

RUN echo "CREATE DATABASE my_database;" | mysql -u root -p$MYSQL_ROOT_PASSWORD

docker-compose.yml

version: '3.8'

services:
  mysql:
    image: 'mysql:8.0'
    environment:
      - MYSQL_ROOT_PASSWORD=password
    ports:
      - '3306:3306'
    volumes:
      - './data:/var/lib/mysql'

解説

上記のコードは、MySQL 8.0のDockerイメージをベースに、データベースとユーザーを作成するDockerfileと、MySQLコンテナを起動するためのdocker-compose.ymlファイルです。
Dockerfileでは、環境変数 MYSQL_ROOT_PASSWORD でパスワードを設定しています。
docker-compose.ymlでは、ポート 3306 を外部に公開し、ボリューム ./data をマウントしています。

注意事項