発生した事象

Laravel sail を使用していたところ、DB接続時に以下のエラーが表示され接続できない事象が発生した。

SQLSTATE[HY000] [1045] Access denied for user 'sail'@' ~

エラー内容を確認するとsailユーザーにアクセス権がないようなので、sailユーザーが存在していることやアクセス権周りを確認する。

調査した内容

まず、mysqlコンテナに接続しsailユーザが作成されているか確認する。

$ mysql -h 127.0.0.1 -u root -P 3306
mysql> use mysql;
mysql> SELECT User, Host FROM mysql.user;
+------------------+-----------+
| User             | Host      |
+------------------+-----------+
| root             | %         |
| healthchecker    | localhost |
| mysql.infoschema | localhost |
| mysql.session    | localhost |
| mysql.sys        | localhost |
| root             | localhost |
+------------------+-----------+
6 rows in set (0.00 sec)

ユーザ一覧を確認したところ、sailユーザーが作成されていないことが判明。ということは、mysqlイメージ構築時に正常にユーザ等が作成されていないと判断。

イメージ構築時に関連ありそうなdocker-compose.ymlと、同階層の.envファイルを確認する。

mysql:
        image: 'mysql/mysql-server:8.0'
        ports:
            - '${FORWARD_DB_PORT:-3306}:3306'
        environment:
            MYSQL_ROOT_PASSWORD: '${DB_PASSWORD}'
            MYSQL_ROOT_HOST: "%"
            MYSQL_DATABASE: '${DB_DATABASE}'
            MYSQL_USER: '${DB_USERNAME}'
            MYSQL_PASSWORD: '${DB_PASSWORD}'
            MYSQL_ALLOW_EMPTY_PASSWORD: 1
        volumes:
            - 'sail-mysql:/var/lib/mysql'
            - './vendor/laravel/sail/database/mysql/create-testing-database.sh:/docker-entrypoint-initdb.d/10-create-testing-database.sh'

DB_CONNECTION=mysql
DB_HOST=mysql
DB_PORT=3306
DB_DATABASE=laravel
DB_USERNAME=sail
DB_PASSWORD=sercret

Docker MysqlのドキュメントよりMYSQL_USERに設定されているユーザがイメージ開始時に、作成されるはずだが、作成されていない。

docker-composeのconfigを確認しても、環境変数は反映されていて問題なさそう。。

$ docker-compose config
mysql:
    environment:
      MYSQL_ALLOW_EMPTY_PASSWORD: 1
      MYSQL_DATABASE: laravel
      MYSQL_PASSWORD: sercret
      MYSQL_ROOT_HOST: '%'
      MYSQL_ROOT_PASSWORD: sercret
      MYSQL_USER: sail

原因

結論からいうと、DBをVolumuesで永続化しているのが原因でした。

なのでdown時に-vオプションを使用してVolumesを削除し、buildし直すことで事象が解消されました。

$ docker-compose down -v
$ docker-compose up -d --build

参考文献