接続を確立したはずなのに、しばらく使わないでいるとMySQLへの接続が切れてしまう。
再起動すると直ることもあるけれど、また同じエラーが出る。そんな繰り返しに悩んでいる人は多いです。
原因はほとんどの場合、MySQLの wait_timeout(または interactive_timeout)です。
一定時間アイドル状態の接続を、MySQLサーバー側から切断します。
その後にアプリが同じ接続を使ってクエリを発行しようとして、"gone away" エラーになります。
この記事では、RHEL 9系~10系/Ubuntu 24.04 LTS を想定環境として、タイムアウト設定の仕組みを理解したうえで、my.cnf への永続設定から動的変更まで手順を解説します。
この記事のポイント
・wait_timeout=アプリ接続に適用(デフォルト 28800 秒)
・interactive_timeout=対話接続(mysql CLI)に適用
・my.cnf の [mysqld] に追記して永続設定する(再起動が必要)
・接続プール側の idle-timeout を wait_timeout より短くする
でも安心してください。プロのエンジニアはコマンドを暗記していません。
「現場で使える型」を効率よく使いこなしているだけです。
「MySQL server has gone away」エラーの仕組みと発生条件
MySQL は接続ごとにタイムアウト管理を行っています。アイドル状態(クエリも通信も発生していない状態)が続くと、サーバー側から接続を切断します。
この切断後にアプリが古い接続を使ってクエリを発行しようとすると、次のエラーが出ます。
ERROR 2006 (HY000): MySQL server has gone away
発生しやすい典型的なケースをいくつか挙げます。
・夜間バッチの接続を確立したまま長時間待機してからクエリを実行した
・接続プールのアイドル接続がサーバー側の wait_timeout を超えて切断された
・1 つのクエリ実行中に net_read_timeout を超えたデータ送信が発生した
最も多い原因はアイドル接続の切断です。
これを制御しているのが wait_timeout と interactive_timeout です。
wait_timeout と interactive_timeout の違い
2 つの変数は、適用される接続の種類が異なります。| 変数 | 適用対象 | デフォルト値 |
|---|---|---|
| wait_timeout | 非インタラクティブ接続(PHP/Python/Java などのアプリ接続) | 28800秒(8時間) |
| interactive_timeout | インタラクティブ接続(mysql コマンドラインクライアントなど) | 28800秒(8時間) |
手動でログインした mysql クライアントには interactive_timeout が適用されます。
「アプリが gone away エラーになる」という問題であれば、変更が必要なのは wait_timeout です。
interactive_timeout を変更しても、アプリ側の接続には反映されません。
デフォルト値はどちらも 28800 秒(8時間)です。
一見すると長いように感じますが、接続プールのアイドルタイムがこの値より長く設定されていると、切断後の接続を再利用してエラーになります。
現在のタイムアウト設定を確認する
変更前に現在の値を確認します。1. SHOW VARIABLES で確認する
mysql コマンドラインクライアントにログインして実行します。# MySQL にログインする mysql -u root -p # タイムアウト関連の変数をすべて確認する mysql> SHOW VARIABLES LIKE '%timeout%';
+-----------------------------+----------+ | Variable_name | Value | +-----------------------------+----------+ | connect_timeout | 10 | | interactive_timeout | 28800 | | lock_wait_timeout | 31536000 | | net_read_timeout | 30 | | net_write_timeout | 60 | | wait_timeout | 28800 | +-----------------------------+----------+
2. SHOW PROCESSLIST でスリープ接続を確認する
スリープ状態(アイドル)の接続が多ければ、wait_timeout の調整が必要な状況です。# 現在の接続一覧を確認する(Command 列が "Sleep" の行がアイドル接続) mysql> SHOW PROCESSLIST;
OS レベルで MySQL の接続状態を確認するには ss コマンドも活用できます(Linux ポート確認の全コマンド)。
# TCP 3306番ポートへの接続状態を確認する ss -tnp | grep ':3306'
my.cnf で永続設定を変更する手順
再起動後も設定を維持するには、my.cnf(または my.cnf.d 配下のファイル)に記述します。1. 設定ファイルの場所を確認する
# MySQL が読み込む設定ファイルを確認する mysqld --verbose --help 2>/dev/null | grep -A 1 'Default options'
Default options are read from the following files in the given order: /etc/my.cnf /etc/mysql/my.cnf ~/.my.cnf
/etc/my.cnf または /etc/my.cnf.d/mysql-server.cnf が主な設定ファイルです。Ubuntu 24.04 LTS では
/etc/mysql/mysql.conf.d/mysqld.cnf を編集します。2. [mysqld] セクションにタイムアウト値を追記する
作業前に設定ファイルのバックアップを取ります。# 設定ファイルのバックアップ(RHEL 9系の例) cp /etc/my.cnf /etc/my.cnf.bak.$(date +%Y%m%d) # /etc/my.cnf を編集して [mysqld] セクションに追記する [mysqld] wait_timeout = 300 interactive_timeout = 300
・短すぎる値(30 秒未満)は正常な接続まで切断するリスクがあります
・一般的な Web アプリでは 300 秒(5 分)前後が使われることが多いです
・夜間バッチが長時間接続を維持する必要がある場合は、バッチ用の接続設定を別途検討します
3. mysqld を再起動して設定を反映する
# mysqld を再起動する systemctl restart mysqld # RHEL 9系・RHEL 10系 # または systemctl restart mysql # Ubuntu 24.04 LTS # 再起動後にタイムアウト値が反映されたことを確認する mysql -u root -p -e "SHOW VARIABLES LIKE 'wait_timeout';"
+---------------+-------+ | Variable_name | Value | +---------------+-------+ | wait_timeout | 300 | +---------------+-------+
動的変更(再起動なし)で即座に反映する
サービスを止められない場合は、SET GLOBAL コマンドで動的に変更できます。# root でログインして動的に変更する mysql -u root -p mysql> SET GLOBAL wait_timeout = 300; mysql> SET GLOBAL interactive_timeout = 300; # 変更が反映されたことを確認する mysql> SHOW VARIABLES LIKE '%timeout%';
既存のアイドル接続には即時には適用されず、次の接続から有効になります。
注意: 動的変更は再起動すると元の値(my.cnf の設定)に戻ります。
恒久的な変更には必ず my.cnf への記述と合わせて実施します。
アプリケーション側で接続を維持する設定
サーバー側の wait_timeout を延ばすだけでは解決しないケースもあります。接続プールを使っている場合、プール側のアイドルタイムを wait_timeout より短く設定することが重要です。
代表的な接続プール・ドライバの設定例を示します。
PHP(PDO)の場合
PDO には標準の自動再接続機能がありません。接続を切断された後にエラーが出た場合、例外処理の中で再接続する実装が必要です。
# PDO で接続確認と再接続を行う実装例(例示) try { $pdo->query('SELECT 1'); } catch (PDOException $e) { // 接続を再確立する $pdo = new PDO($dsn, $user, $pass, [PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION]); }
Java(HikariCP)の場合
HikariCP では次の設定でアイドル接続の有効期限をサーバー側より短く保つことができます。# HikariCP の設定例(application.properties) # idle-timeout は wait_timeout の 300 秒より短い 240 秒に設定する spring.datasource.hikari.idle-timeout=240000 # 60 秒ごとに keepalive クエリを発行して切断を防ぐ spring.datasource.hikari.keepalive-time=60000 spring.datasource.hikari.connection-test-query=SELECT 1
keepalive-time を設定すると、アイドル中の接続に定期的にクエリを発行して切断を防ぎます。Linuxサーバー上で自前DBを運用する際は、【初心者向けLinuxセミナー(2日間ハンズオン)】で、実機を使ったサーバー設定の基礎から学べます。
その他の関連タイムアウト変数
wait_timeout と interactive_timeout 以外にも、接続のライフサイクルに関わるタイムアウト変数があります。| 変数名 | 意味 | デフォルト値 |
|---|---|---|
| connect_timeout | 接続確立のタイムアウト(TCP ハンドシェイク後、認証完了まで) | 10秒 |
| net_read_timeout | クライアントからのデータ受信タイムアウト(INSERT・LOAD DATA 等) | 30秒 |
| net_write_timeout | クライアントへのデータ送信タイムアウト(大量データの SELECT 等) | 60秒 |
| lock_wait_timeout | ロック取得のタイムアウト(DDL 文が他のトランザクションのロック解放を待つ最大時間) | 31536000秒(約1年) |
net_read_timeout を延ばします。「SELECT の結果が大量で送信中に切断される」場合は
net_write_timeout を延ばします。wait_timeout と混同しやすいですが、net_read/write_timeout は「データ転送中のタイムアウト」でありアイドル接続とは別の概念です。本記事のまとめ
「MySQL server has gone away」エラーの原因と対処をまとめます。| やりたいこと | コマンド・設定 |
|---|---|
| 現在の wait_timeout を確認する | SHOW VARIABLES LIKE 'wait_timeout'; |
| 現在のアイドル接続を確認する | SHOW PROCESSLIST; |
| 動的に変更する(再起動なし) | SET GLOBAL wait_timeout = 300; |
| 永続設定(再起動後も有効) | my.cnf の [mysqld] に wait_timeout = 300 を追記 |
| 大量データ処理中の切断防止 | net_read_timeout または net_write_timeout を延ばす |
サーバー側のタイムアウト値よりも、接続プール側のアイドルタイムを短く設定しておくことで "gone away" エラーを防げます。
MySQL などのデータベース運用も含めた2日間のハンズオンで基礎から学べます。
>>【初心者向けLinuxセミナー(2日間ハンズオン)】
3,100名以上が実践した「型」を無料で公開中
プロのエンジニアはコマンドを暗記していません。
「現場で使える型」を効率よく使いこなしているだけです。
その「型」を図解60Pにまとめた入門マニュアルを、完全無料でプレゼントしています。
姓・名・メールの3つだけ/30秒/解除は3秒 / 詳細はこちら
- 前のページへ:MariaDB Galera Clusterでマルチマスターレプリケーションを構築する手順|3ノード同期構成のインストールから状態確認まで
- この記事の属するカテゴリ:データーベース管理へ戻る

無料メルマガで学習を続ける
Linuxの実践スキルをメールで毎週お届け。
登録は30秒、解除もいつでも可。
登録無料・いつでも解除できます