IntelliJ IDEAで解決する『難解なスレッドダンプ』！並行処理エラーを可視化して解析する裏技
こんにちは。システム開発の現場で、一度ハマるとなかなか抜け出せないのが「並行処理のバグ」です。ログには何も出力されないのに、アプリケーションが突然フリーズする。あるいは、特定の条件でデータが不整合を起こす。
これらは「デッドロック」や「競合状態（Race Condition）」が原因であることがほとんどですが、数百のスレッドが飛び交うJavaアプリケーションのスタックトレースをテキストで追いかけるのは、熟練エンジニアにとっても苦行です。
今日は、IntelliJ IDEAが隠し持っている「Analyze Thread Dump」という強力な武器を使って、この悪夢を可視化し、解決する技術を伝授します。
—
1. なぜ「Analyze Thread Dump」なのか？
通常のログ出力（`System.out`や`log4j`）は、時系列に沿った「出来事の記録」に過ぎません。しかし、スレッドダンプは「システムが凍結したその瞬間の、全スレッドの脳内（スタックトレース）」そのものです。
IntelliJ IDEAの解析機能は、単なるテキスト表示ではありません。
- グラフ化: どのスレッドがどのオブジェクトのロックを待機しているかを相関図として可視化。
- デッドロック自動検知: 循環参照によるデッドロックを瞬時にハイライト。
- 状態のフィルタリング: `RUNNABLE`, `BLOCKED`, `WAITING` などの状態を一瞬で絞り込み。
これを使いこなせば、数時間かかるデバッグを数分に短縮できます。
—
2. 実践：解析のための「HelloWorld」的な準備
まずは、意図的にデッドロックを起こし、それを解析する環境を整えましょう。以下のコードをIntelliJのメインクラスに貼り付けてみてください。
public class DeadlockSimulator {
// 競合させるための共有リソース
private static final Object lockA = new Object();
private static final Object lockB = new Object();
public static void main(String[] args) {
// スレッド1: Aを掴んでBを待つ
new Thread(() -> {
synchronized (lockA) {
System.out.println(“Thread 1: lockA取得”);
sleep(100);
synchronized (lockB) { System.out.println(“Thread 1: lockB取得”); }
}
}).start();
// スレッド2: Bを掴んでAを待つ（デッドロックの発生源）
new Thread(() -> {
synchronized (lockB) {
System.out.println(“Thread 2: lockB取得”);
sleep(100);
synchronized (lockA) { System.out.println(“Thread 2: lockA取得”); }
}
}).start();
}
private static void sleep(int ms) {
try { Thread.sleep(ms); } catch (InterruptedException e) { e.printStackTrace(); }
}
}
手順：スレッドダンプの取得と解析
1. 上記を実行し、コンソールに `lockA取得`、`lockB取得` が出たまま止まったら成功です（デッドロック発生）。
2. IntelliJのターミナルで `jps` コマンドを打ち、実行中のPIDを確認します。
3. `jstack
4. ここが魔法の瞬間です： IntelliJで `Help` -> `Edit Custom VM Options` を開く必要はありません。単純にメニューバーの `Analyze` -> `Analyze Stack Trace or Thread Dump…` を選択してください。
5. コピーした内容を貼り付けて `OK` を押します。
—
3. IntelliJが魅せる「驚愕の可視化」
解析が完了すると、IDEの画面が以下のように変化します。
- 階層ツリー: 各スレッドが今どこで止まっているかが、メソッド呼び出しの深い階層まで展開されます。
- ロック競合の可視化: 待機中のスレッドをクリックすると、「誰がそのロックを保持しているか」へのリンクが自動生成されます。これこそが、並行処理デバッグにおける最大の利益です。
現場で役立つ「フィルタリング」の極意
画面上部のアイコンから、以下のフィルタを必ず活用してください。
- `Show Waiting Threads`: 実行待ち状態のスレッドだけを表示します。正常に動いている数多くのスレッドを隠し、問題児だけを特定するのに必須です。
- `Group by monitor`: ロックオブジェクト（`lockA`など）ごとにスレッドをまとめます。リソースの奪い合いが一目で分かります。
—
4. 最後に：なぜこれが開発効率を爆上げするのか
初心者のうちは、デッドロックが起きると「コードを全部見直す」という非効率な方法をとってしまいがちです。しかし、このツールを使えば「どの行の、どの変数のロックが原因か」が、文字通り指先一つで特定できます。
IntelliJ IDEAを単なるエディタとして使うのは、フェラーリを近所のコンビニへの買い物に使うようなものです。この「スレッドダンプ解析機能」を習得することで、あなたはどんな複雑なマルチスレッド環境の障害も、冷静かつ論理的に鎮圧できる「アーキテクト」の視座を手に入れることができます。
次は、ぜひ本番環境のダンプファイル（`.hprof`や`.txt`）を読み込ませてみてください。画面の向こう側に、システムが停止した瞬間の「真実」が映し出されるはずです。
毎日のコーディングが、少しでも「謎解き」の楽しさに満ちたものになりますように。応援しています！