Laravel MySQL SQLSTATE[HY000] [1049] Unknown database が出た時に確認すること

目的

• 自分がよくやらかすミスなので確認する内容をまとめる

実施環境

• ハードウェア環境

項目	情報
OS	macOS Catalina(10.15.3)
ハードウェア	MacBook Pro (16-inch ,2019)
プロセッサ	2.6 GHz 6コアIntel Core i7
メモリ	16 GB 2667 MHz DDR4
グラフィックス	AMD Radeon Pro 5300M 4 GB Intel UHD Graphics 630 1536 MB

• ソフトウェア環境

項目	情報	備考
PHP バージョン	7.4.3	Homwbrewを用いて導入
Laravel バージョン	7.0.8	commposerを用いて導入
MySQLバージョン	8.0.19 for osx10.13 on x86_64	Homwbrewを用いて導入

エラー内容

• Laravelアプリのマイグレート時やアプリからのDBアクセス時にターミナルやブラウザ情に下記エラーが表示される。
  -「SQLSTATE[HY000] [1049] Unknown database 'データベース名'」

解決方法その1 MySQLの再起動

1. 下記コマンドを実行してMySQLの再起動を実施する。

   $ mysql.serve restart
   

解決方法その2 データベース名の記載の確認

1. 下記コマンドを実行してMySQLのターミナルを開く。(MySQLのrootユーザのパスワードがわからなくなってしまった方はこちら→MySQL 8.0.18 のrootパスワードを忘れた時のリセット方法)

   $ mysql -u root -p
   

2. 下記コマンドを実行して現在存在するデータベース名を出力する。

   mysql> show databases;
   

3. 別のターミナルを開き、アプリ名ディレクトリで下記コマンドを実行する。

   vi .env
   

4. 「.env」のDB_DATABASE=の後に記載しているデータベース名が先にコマンドshow databases;で出力されたものと一致しているか確認する。

5. 別のターミナルを開き、アプリ名ディレクトリで下記コマンドを実行する。

   $ vi config/database.php
   

6. 「config/database.php」の「mysql」の'database' => env('DB_DATABASE', 'データベース名'),のデータベース名部分の記載が、先にコマンドshow databases;で出力されたものと一致しているか確認する。

確認方法その3 MySQLのユーザ名とパスワードの確認

1. アプリ名ディレクトリで下記コマンドを実行して「.env」ファイルを開く

   $ vi .env
   

2. 「DB_USERNAME=」「DB_PASSWORD=」の後に記載されている内容に誤りがない事を確認する。

3. アプリ名ディレクトリで下記コマンドを実行して「config/database.php」ファイルを開く。

   $ vi config/database.php
   

4. 「'username' =>」「'password' =>」の後に記載されている内容に誤りがない事を確認する。