node.jsでMySQLに接続したいが、"Access denied for user" とエラーが出る

Question

前提・実現したいこと

node.jsでMySQLに接続したいです。
しかし、npm run startで実行した時、以下のエラーメッセージが発生しました。

発生している問題・エラーメッセージ

Error: ER_ACCESS_DENIED_ERROR: Access denied for user 'root'@'localhost' (using password: YES)

該当のソースコード

const mysql = require('mysql');

const con = mysql.createConnection({
  host: "localhost",
  user: "root",
  password: "*****",
});

con.connect()

試したこと

mysql -u root -p

ターミナルでこちらのコマンドはしっかりとログインでき、MySQLにアクセスできます。
しかし、nodeで実行した場合アクセスが拒否されます。パスワードは合ってます。
新しくユーザを作成して同様なことをしてもアクセスできません。権限を付与することも試しました。

補足情報（FW/ツールのバージョンなど）

mysql Ver 8.0.19 for osx10.13 on x86_64 (Homebrew)
node v13.8.0

Answer 1

mysql Ver 8.0.19 for osx10.13 on x86_64

あー、これは知ってないと分からないと思います。
言いたいことは下記の参考記事に全部書いてあります。

参考記事: 【node.js】MySQL8.0に接続できない。Error: ER_NOT_SUPPORTED_AUTH_MODE

まぁ、要約するとMySQL8はパスワードの管理方式が変わって
古いモジュールのmysqlは追従出来ていません。

mysqlモジュールの作者はとっくの昔に、
mysql2に移行しており
そちらで開発・新機能追加を行っています。

Promiseなんかも使えるので、
今後async/await構文でぶいぶいNode.js開発がしたいならmysql2へ移行しましょう。
使い方はmysqlモジュールとほぼ同じ使い方が出来るはずです。

const mysql = require('mysql2'); // 使うモジュール名を変更しただけ

const con = mysql.createConnection({
  host: "localhost",
  user: "root",
  password: "*****",
});

con.connect()

---

開発用環境のMacにMySQLを入れるのは構築難易度が高く
権限周りの根深い問題だと思いますので、
ここはDockerを使ったMySQLサーバの構築法を案内します。
※最新のM1 MacだとまだDockerが使えないので環境構築を続ける必要がありますが……

Docker for Macを導入していなければ、
まず公式からダウンロードします。

DockerはCLIツールなので、
コンソールを開いて操作する必要があります。
端末を開くとdockerやdocker-composeのコマンドが追加されて使えるようになっているはずです。

$ docker -v 
Docker version xx.xx.x, build xxxxxxx

$ docker-compose -v
docker-compose version x.xx.x, build xxxxxxx

Dockerの動作原理は
Linuxはディストリビューションが異なるOS間でも、
コンパイルした実行ファイルのファイルフォーマットが同一なので、
仮想的なHDDをひっつけてディレクトリ構成を同じにしてやれば動くでしょ？を元にしています。

因みにMacOSはOSが根本から違うので対象から外れますが、
Docker for Macにより仮想Linuxマシンを立ち上げて、
その中でDockerを動作させる事で実現しています。

Docker社はDocker Hubという
Dockerのイメージファイルを配布するサイトも運営しています。

その中には「MySQLサーバーを使える状態に設定済み」のイメージもあり、
無料で配布されているので誰でもダウンロードして使う事が出来ます。
参考リンク: mysql - Docker Hub

Dockerではdocker runコマンドを使う事で、
このDockerイメージファイルを元にコンテナを1個起動する事ができます。
(これはmysqlの説明書きにあった実行するファイルです)

$ docker run --name some-mysql -e MYSQL_ROOT_PASSWORD=my-secret-pw -d mysql:tag

例えばこういうコマンドを--name some-mysqlのオプションを変えつつ3回実行すると、
MySQLサーバが3個作られて動作し始めます。

しかし、このコンテナというのはすぐ壊してまた起動し直すという思想で作られているので、
コンテナを作る度にdocker run ....を「じゅげむ」のように繰り返すわけです。
腱鞘炎になるわ。

そこで、コマンドをYAMLファイルに記述して保管しようという
Docker Composeをセットで利用します。
何も知識が無い所から設定するのは大変だと思うので、
私が最初から使える状態でdocker-compose.ymlファイルのテンプレートを用意しました。

仕様はとりまこんな感じです。

• イメージはmysql8の最新を利用
• ユーザ名root、パスワードpasswordで接続可能
• localhost:3306で接続可能(ただし、コンソールから繋ぐ場合はホスト名を127.0.0.1にすること)
• ファイルの永続化の為にvolumesに値を設定して、Macマシンからディレクトリを注入してそこにファイルを書かせる仕組みにしている
• おまけとしてphpMyAdminも併設、http://localhost:4000で閲覧出来る

version: "3.6"
services:
  db:
    image: mysql:8
    environment:
      MYSQL_ROOT_PASSWORD: password
    ports:
      - 3306:3306
    volumes:
      - mysql-db:/var/lib/mysql
  myadmin:
    image: phpmyadmin/phpmyadmin
    environment:
      PMA_HOST: db
      PMA_USER: root
      PMA_PASSWORD: password
    ports:
      - 4000:80

volumes:
  mysql-db:
    driver: local

まずこれをdocker-compose.ymlというファイルにして保存します。
同じディレクトリでdocker-composeコマンドを実行すると裏でYAMLファイルをロードして準備してくれるでしょう。

# 今の状態を確認する
# 何も起動していないので何も表示されない
$ docker-compose ps

# バックグランドモードでコンテナ達を起動する
# 初回はmysqlイメージのダウンロード等から始まるので時間がかかるはず
$ docker-compose up -d

$ docker-compose ps
       Name                     Command               State                 Ports              
-----------------------------------------------------------------------------------------------
database_db_1        docker-entrypoint.sh mysqld      Up      0.0.0.0:3306->3306/tcp, 33060/tcp
database_myadmin_1   /docker-entrypoint.sh apac ...   Up      0.0.0.0:4000->80/tcp

Comments

[miyabi-sun]

あれ、でも表示されているエラー名が違いますね。
まぁひとまずmysql2に差し替えてみてください。

[tokky08]

ありがとうございます。
mysql2に差し替えましたが、同じエラーを吐いてしまいますね、。

[miyabi-sun]

似たような質問見つけました。
https://www.366service.com/jp/qa/ad148008583c81d865e684e6978d0aa6

ベストアンサーはなんじゃそりゃ？な対応ですが、
パスワードの欄を空文字にして試してみてください。

無理ならDocker for Macを使った解決策を提示します。

[tokky08]

返信大変遅れてしまい申し訳ありません。
そちらも試しましたがダメのようです。
>無理ならDocker for Macを使った解決策を提示します。
こちらご教授いただきたいです。

[hentaiman]

portを明示的に指定したらどうなりますか？よかったら試して教えてください

Answer 2

結果的にmysqlを再インストールすることで解決しました。原因は謎です。。。

$ brew uninstall mysql
$ brew install mysql

このinstallする過程で色々エラーが出て、macOSのアップデートも行いました