メインコンテンツへスキップ
見出し画像

MariaDB・MySQLに接続できないときの確認7項目|Connection refused・Access deniedの切り分け方


    はじめに

    MariaDBやMySQLを使っていると、

    「アプリケーションからDBへ接続できない」
    「Connection refusedが出る」
    「Access deniedが出る」
    「Docker環境に変えたら接続できなくなった」

    といったトラブルに遭遇することがあります。

    DB接続エラーは、原因によって見る場所がかなり違います。

    たとえば、

    • DBサービスが停止している

    • 3306ポートが待受していない

    • 接続先ホスト名やIPが間違っている

    • ユーザー名やパスワードが違う

    • MySQLユーザーの接続元制限に引っかかっている

    • Dockerコンテナ間通信の設定が間違っている

    • DBが高負荷で応答できない

    などが考えられます。

    この記事では、MariaDB・MySQLに接続できないときに、現場SEが順番に確認したい7項目を整理します。


    まずエラーの種類を確認する

    最初に見るべきなのは、エラーメッセージです。

    代表的には、

    ERROR 2002 (HY000):
    Can't connect to MySQL server

    や、

    Connection refused

    があります。

    一方で、

    ERROR 1045 (28000):
    Access denied for user

    というエラーもあります。

    この2つは意味が違います。

    ざっくり言うと、

    Connection refused
    → DBまで接続できていない可能性が高い

    Access denied
    → DBまでは届いているが、認証や権限で拒否されている可能性が高い

    という違いがあります。


    1. MariaDB・MySQLサービスが起動しているか

    まずDBサービス自体が起動しているか確認します。

    MariaDBなら、

    systemctl status mariadb

    MySQLなら、

    systemctl status mysql

    確認したいのは、

    active (running)

    になっているかどうかです。

    もし、

    failed

    や、

    inactive

    になっている場合は、DBサービス側の調査が必要です。


    DBサービスのログを見る

    MariaDBの場合は、

    journalctl -u mariadb -n 100 --no-pager

    MySQLなら、

    journalctl -u mysql -n 100 --no-pager

    などで確認します。

    特に、

    • ERROR

    • failed

    • permission

    • disk

    • InnoDB

    • out of memory

    などに注目します。


    2. 3306ポートが待受しているか

    DBサービスが起動していても、必要なポートが待受していない場合があります。

    確認には、

    ss -tulnp | grep 3306

    を使います。

    例えば、

    LISTEN 0 80 0.0.0.0:3306

    のように表示されれば、3306ポートで待受しています。

    何も表示されない場合は、

    • DBが起動していない

    • 別ポートで起動している

    • bind-address設定

    • 設定ファイル不備

    などを疑います。


    localhostだけで待受していないか

    例えば、

    127.0.0.1:3306

    だけで待受している場合、別サーバーや別コンテナから接続できないことがあります。

    ここでは、

    • どのIPにbindしているか

    • 外部接続が必要な構成か

    を確認します。

    ただし、本番環境では安易に 0.0.0.0 に変更しないでください。

    セキュリティ設計とセットで判断する必要があります。


    3. 接続先ホスト・ネットワークを確認する

    次に、アプリケーションが正しいDBサーバーへ接続しようとしているか確認します。

    例えば、

    DB_HOST=192.168.1.100
    DB_PORT=3306

    なら、その接続先が本当に正しいか確認します。

    まず、

    ping 192.168.1.100

    で疎通確認します。

    ただし、pingを禁止している環境もあるので、応答がないだけで断定はできません。


    ポート疎通を確認する

    例えば、

    nc -vz 192.168.1.100 3306

    で確認できます。

    成功すれば、

    succeeded

    などが表示されます。

    接続できなければ、

    • DBサービス停止

    • ポート未待受

    • Firewall

    • ルーティング

    • 接続先IP間違い

    などを切り分けます。


    4. ユーザー名・パスワードを確認する

    ネットワーク的にはDBへ届いていて、

    Access denied

    が出ている場合は、認証情報を確認します。

    例えば、

    mysql -h <DBサーバー> -u <ユーザー> -p

    を実行します。

    パスワードはコマンドラインに直接書かず、-p だけ指定して入力する方が安全です。


    Access deniedの例

    例えば、

    ERROR 1045 (28000):
    Access denied for user 'appuser'@'192.168.1.20'

    なら、

    appuser

    というユーザーが、

    192.168.1.20

    から接続しようとして拒否されています。

    ここで重要なのが、

    MySQL/MariaDBでは「ユーザー名」と「接続元ホスト」の組み合わせで権限管理される

    ことです。


    5. ユーザーの権限・接続元制限を確認する

    管理権限がある場合、例えば、

    SELECT User, Host
    FROM mysql.user;

    などでユーザーと接続元を確認できます。

    例えば、

    appuser | localhost

    しか登録されていない場合、

    別サーバーから、

    appuser@192.168.1.20

    として接続しようとしても拒否される可能性があります。


    GRANTを確認する

    例えば、

    SHOW GRANTS FOR 'appuser'@'localhost';

    などで確認します。

    ただし、障害調査中にいきなり、

    GRANT ALL PRIVILEGES

    を実行するのはおすすめしません。

    まず、

    • 本来どの接続元を許可する設計か

    • 必要な権限は何か

    • 現在の権限は何か

    を確認します。


    6. Docker環境では localhost に注意

    Dockerを使っている場合、非常によくあるのが localhost の勘違いです。

    例えばAPIコンテナの設定が、

    DB_HOST=localhost

    になっているとします。

    この場合の localhost は、基本的にAPIコンテナ自身です。

    MariaDBが別コンテナなら、そこには接続できません。


    Docker Composeならサービス名を使う

    例えば、

    services:
      api:
      db:

    という構成なら、APIからDBへ接続するときは、

    DB_HOST=db

    のようにサービス名を使う構成が一般的です。

    ポートなら、

    DB_PORT=3306

    です。


    Docker Composeの状態確認

    docker compose ps

    を確認します。

    さらに、

    docker compose logs db --tail 100

    でDBコンテナのログを確認します。

    API側も、

    docker compose logs api --tail 100

    を確認します。


    コンテナが同じネットワークにいるか

    必要に応じて、

    docker network ls

    や、

    docker inspect <コンテナ名>

    でネットワーク設定も確認します。


    7. タイムアウト・DB高負荷を確認する

    接続自体はできるものの、

    Connection timed out

    になる場合は、

    • DB高負荷

    • 接続数上限

    • スロークエリ

    • ネットワーク遅延

    • ロック

    • ストレージI/O遅延

    なども考えます。


    CPU・メモリを確認する

    DBサーバーで、

    top
    free -h
    df -h

    を確認します。

    特にDBでは、ディスクI/Oも重要です。


    接続数を見る

    権限がある場合は、

    SHOW STATUS LIKE 'Threads_connected';

    や、

    SHOW VARIABLES LIKE 'max_connections';

    などで確認できます。

    接続数が上限付近なら、新しい接続が失敗する可能性があります。


    長時間クエリを見る

    必要に応じて、

    SHOW PROCESSLIST;

    や、

    SHOW FULL PROCESSLIST;

    で確認します。

    ここでも、いきなりプロセスをKILLするのではなく、まず状態を確認します。


    Connection refused と Access denied の違い

    切り分けを簡単にすると、次のようになります。

    Connection refused

    まず確認するもの:

    • DBサービス

    • 3306待受

    • 接続先IP

    • Firewall

    • Dockerネットワーク

    • bind-address

    つまり、

    DBまで通信できているか

    を確認します。


    Access denied

    まず確認するもの:

    • ユーザー名

    • パスワード

    • 接続元ホスト

    • GRANT

    • 認証方式

    つまり、

    DBへは到達しているが、認証・権限で拒否されていないか

    を確認します。


    よくある失敗例

    1. 接続できないのでDBをすぐ再起動する

    Connection refusedだからといって、いきなり再起動する必要はありません。

    まず、

    systemctl status mariadb
    ss -tulnp | grep 3306

    を確認します。


    2. Access deniedだからパスワードを変える

    実際にはパスワードではなく、

    'user'@'host'

    のHost部分が原因の場合があります。

    認証エラーは、ユーザー名と接続元をセットで見ます。


    3. Dockerでlocalhostを使う

    APIコンテナからDBコンテナへ接続する場合、localhostではないケースが多いです。

    Composeのサービス名を確認します。


    4. とりあえずGRANT ALLする

    必要以上の権限を付与するのはセキュリティ上おすすめできません。

    必要な接続元と権限を確認してから設定します。


    おすすめの確認順序

    DBへ接続できない場合は、私は次の順番がおすすめです。

    1. エラー内容確認
    ↓
    2. DBサービス状態
    ↓
    3. 3306待受確認
    ↓
    4. 接続先IP・ホスト確認
    ↓
    5. ネットワーク疎通
    ↓
    6. ユーザー・接続元・権限確認
    ↓
    7. Docker・負荷・タイムアウト確認

    この順番なら、

    通信できない問題なのか、認証問題なのか

    を早い段階で分けられます。


    ChatGPTに調査させるプロンプト

    例えば、次のように使えます。

    MariaDB / MySQLへの接続障害を調査しています。
    
    【エラー】
    ここにエラーを貼る
    
    【構成】
    例:
    APIサーバー → MariaDBサーバー
    
    または
    
    Docker Compose
    APIコンテナ → DBコンテナ
    
    【DBサービス状態】
    ここに systemctl status または docker ps の結果
    
    【3306待受】
    ここに ss -tulnp の結果
    
    【接続試験】
    ここに nc -vz 等の結果
    
    【認証エラー】
    あればここに記載
    
    以下の順番で整理してください。
    
    1. 現在確認できる事実
    2. Connection refused系かAccess denied系か
    3. 原因候補
    4. 可能性が高い順
    5. 次に確認する項目
    6. 読み取り中心で安全な確認コマンド
    
    重要:
    ・パスワードや秘密情報の入力を要求しない
    ・原因を断定しない
    ・事実と推測を分ける
    ・DBサービス再起動を最初の対策にしない
    ・GRANTや設定変更を勝手に提案しない

    ChatGPTに次の1手だけ決めてもらう

    情報が多くなってきたら、

    現在の情報から、
    次に確認する項目を1つだけ選んでください。
    
    条件:
    ・DBデータを変更しない
    ・サービスを停止しない
    ・設定変更しない
    ・パスワード変更しない
    ・結果によって原因候補を大きく絞れるもの
    
    確認コマンドと、その理由を示してください。

    という使い方もおすすめです。


    現場用チェックリスト

    サービス

    • MariaDB/MySQLが起動している

    • 起動失敗ログがない

    ポート

    • 3306がLISTEN

    • 正しいIPで待受している

    ネットワーク

    • 接続先IPが正しい

    • 名前解決が正しい

    • 3306へ疎通できる

    認証

    • ユーザー名が正しい

    • パスワードが正しい

    • 接続元Hostが許可されている

    権限

    • 必要なGRANTがある

    • 必要以上の権限を付けていない

    Docker

    • DBコンテナがUp

    • localhostを誤用していない

    • サービス名が正しい

    • コンテナネットワークが正しい

    負荷

    • CPU異常なし

    • メモリ異常なし

    • ディスク逼迫なし

    • 接続数上限ではない

    • スロークエリ等を確認


    まとめ

    MariaDB・MySQLへ接続できない場合は、最初に、

    Connection refused系なのか
    それとも
    Access denied系なのか

    を分けて考えると切り分けしやすくなります。

    Connection refusedなら、

    サービス・ポート・ネットワーク

    を中心に確認します。

    Access deniedなら、

    ユーザー・パスワード・接続元・権限

    を中心に確認します。

    Docker環境ではさらに、

    localhostとコンテナ名の違い

    にも注意します。

    DB障害でも、

    いきなり再起動や権限変更をするのではなく、まず事実を確認する

    という基本は同じです。


    DB接続障害を含め、Linux・Docker環境で「次に何を確認するか」をまとめた『現場SE向け Linux・Docker障害対応チェックリスト完全版』と、障害調査でそのまま使える『ChatGPT障害調査プロンプト30選』も公開しています。

     
     
    現場SE向けに、ChatGPTを使ったLinux・Docker・AWS・C#・障害調査・自動化の実践例を紹介しています。 AIの使い方だけでなく、「現場でどう使うか」「どう検証するか」を重視してまとめます。

    あなたへのおすすめ