
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 mariadbMySQLなら、
systemctl status mysql確認したいのは、
active (running)になっているかどうかです。
もし、
failedや、
inactiveになっている場合は、DBサービス側の調査が必要です。
DBサービスのログを見る
MariaDBの場合は、
journalctl -u mariadb -n 100 --no-pagerMySQLなら、
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サーバーで、
topfree -hdf -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 mariadbss -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選』も公開しています。