MySQLのwait_timeoutとinteractive_timeoutを設定する方法|「MySQL server has gone away」エラーを根本解消する接続管理の実践手順

運営:リナックスマスター.JP(代表 宮崎智広)
HOME > Linux技術 リナックスマスター.JP(Linuxマスター.JP) > Linuxtips > データーベース管理 > MySQLのwait_timeoutとinteractive_timeoutを設定する方法|「MySQL server has gone away」エラーを根本解消する接続管理の実践手順
「アプリが突然エラーを出した。ログを見ると "MySQL server has gone away" と書いてある。」
接続を確立したはずなのに、しばらく使わないでいると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 より短くする


「このままじゃマズい」と感じていませんか?
参考書を開く気力もない、同年代に取り残される不安——
でも安心してください。プロのエンジニアはコマンドを暗記していません。
「現場で使える型」を効率よく使いこなしているだけです。
姓・名・メールの3つだけ/30秒/解除は3秒 / 詳細はこちら

「MySQL server has gone away」エラーの仕組みと発生条件

MySQL は接続ごとにタイムアウト管理を行っています。
アイドル状態(クエリも通信も発生していない状態)が続くと、サーバー側から接続を切断します。

この切断後にアプリが古い接続を使ってクエリを発行しようとすると、次のエラーが出ます。

ERROR 2006 (HY000): MySQL server has gone away

エラーコード 2006 が "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時間)
アプリケーションからの接続には wait_timeout が適用されます。
手動でログインした 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 | +-----------------------------+----------+

wait_timeout が 28800(8時間)になっていれば、デフォルト設定のままです。

2. SHOW PROCESSLIST でスリープ接続を確認する

スリープ状態(アイドル)の接続が多ければ、wait_timeout の調整が必要な状況です。

# 現在の接続一覧を確認する(Command 列が "Sleep" の行がアイドル接続) mysql> SHOW PROCESSLIST;

Command 列が "Sleep" になっている行が多い場合、wait_timeout が長すぎてアイドル接続が蓄積しています。

OS レベルで MySQL の接続状態を確認するには ss コマンドも活用できます(Linux ポート確認の全コマンド)。

# TCP 3306番ポートへの接続状態を確認する ss -tnp | grep ':3306'

ESTABLISHED の行数が多い場合、接続が蓄積しています。

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

RHEL 9系~10系では /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 | +---------------+-------+

Value が設定した値になっていれば、永続設定の完了です。

動的変更(再起動なし)で即座に反映する

サービスを止められない場合は、SET GLOBAL コマンドで動的に変更できます。

# root でログインして動的に変更する mysql -u root -p mysql> SET GLOBAL wait_timeout = 300; mysql> SET GLOBAL interactive_timeout = 300; # 変更が反映されたことを確認する mysql> SHOW VARIABLES LIKE '%timeout%';

GLOBAL に設定した値は、新しく作成される接続から適用されます。
既存のアイドル接続には即時には適用されず、次の接続から有効になります。

注意: 動的変更は再起動すると元の値(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 を延ばす
wait_timeout の変更は、アプリ側の接続プールの設定(idle-timeout・keepalive)と合わせて実施することが重要です。
サーバー側のタイムアウト値よりも、接続プール側のアイドルタイムを短く設定しておくことで "gone away" エラーを防げます。
現場で通用する安全なLinuxサーバー構築の「型」を体系的に身につけたい方へ、
MySQL などのデータベース運用も含めた2日間のハンズオンで基礎から学べます。
>>【初心者向けLinuxセミナー(2日間ハンズオン)】

無料メルマガで学習を続ける

Linuxの実践スキルをメールで毎週お届け。
登録は30秒、解除もいつでも可。

登録無料・いつでも解除できます

暗記不要・1時間後にはサーバーが動く

3,100名以上が実践した「型」を無料で公開中

プロのエンジニアはコマンドを暗記していません。
「現場で使える型」を効率よく使いこなしているだけです。
その「型」を図解60Pにまとめた入門マニュアルを、完全無料でプレゼントしています。

姓・名・メールの3つだけ/30秒/解除は3秒 / 詳細はこちら

Linux無料マニュアル(図解60P) 名前とメールで30秒登録

運営

リナックスマスター.JP(代表 宮崎智広)

株式会社イーネットマーキュリーが運営するLinux教育サイトです。代表の宮崎智広は現役のLinuxサーバー管理者として20年以上の実務経験を持ち、累計3,100名以上のエンジニアを指導してきました。実践型のLinuxセミナーや無料マニュアルの配布を通じてLinux人材の育成に取り組んでいます。