カテゴリ: Java 更新日: 2026/09/05

JavaのThrowableクラスを初心者向けに完全解説!エラー処理の基本

Throwable
Throwable

先生と生徒の会話形式で理解しよう

生徒

「JavaのThrowableクラスって何ですか?」

先生

「Throwableクラスは、Javaの例外処理機構の基盤となるクラスで、エラーや例外を表現するために使われます。」

生徒

「エラーと例外の違いって何ですか?」

先生

「良い質問ですね。それについて詳しく説明していきます。Throwableクラスの仕組みも一緒に見てみましょう!」

1. Throwableクラスとは?

1. Throwableクラスとは?
1. Throwableクラスとは?

Javaでプログラムを動かしていると、入力ミスやネットワークの切断、メモリ不足など、さまざまな問題が発生することがあります。これらの「想定外の事態」をすべてまとめて管理しているのが、Throwable(スローアブル)クラスです。

名前の由来は、英語の「Throw(投げる)」と「able(〜できる)」を組み合わせたもので、「(エラーとして)投げることができる」という意味を持っています。Javaの世界では、何か問題が起きたときにこのThrowableオブジェクトが「ポイッ」と投げられ、それを私たちがキャッチして対処する仕組みになっています。

Throwableクラスは、大きく分けてエラー(Error)例外(Exception)の2つの子供(サブクラス)を持っています:

  • Throwable(すべての親)
    • Error:プログラムの外側で起きる、自分ではどうしようもない致命的な問題(例:パソコンのメモリが足りない)
    • Exception:プログラムの中で起きる、対処可能な問題(例:読み込むファイルが見つからない)

プログラミング未経験の方でもイメージしやすいように、簡単な「例外を投げる」サンプルコードを見てみましょう。ここでは、わざと例外を発生させて、それがThrowableとして扱われる様子を確認します。


public class ThrowableIntro {
    public static void main(String[] args) {
        try {
            // 「新しい例外」を作成して、わざと投げます
            Throwable myProblem = new Throwable("プログラムで何かが起きました!");
            throw myProblem;

        } catch (Throwable t) {
            // 投げられた問題(Throwable)をここでキャッチします
            System.out.println("キャッチした内容: " + t.getMessage());
        }
    }
}

このコードでは、new Throwableで問題の情報を詰め込んだ箱を作り、throwで投げ、catchで受け取っています。Throwableは、Javaにおける「トラブル対応の窓口」のような存在だと覚えておきましょう。

2. Throwableの主なメソッド

2. Throwableの主なメソッド
2. Throwableの主なメソッド

プログラムで予期せぬトラブルが発生した際、その原因を突き止めるために不可欠なのがThrowableクラスに用意されたメソッドです。これらのメソッドを使いこなすことで、「どこで」「何が」起きたのかを正確に把握できるようになります。

初心者の方がまず覚えるべき、重要度の高い3つのメソッドをご紹介します。

メソッド名 役割と特徴
getMessage() エラーの内容を説明する短いメッセージを取得します。ユーザーへの通知などに適しています。
toString() 例外のクラス名とメッセージを合わせた「概要」を文字列として返します。
printStackTrace() エラーが発生するまでのプログラムの実行経路(履歴)をすべてコンソールに表示します。デバッグの際に最も重宝します。

それでは、これらのメソッドが実際にどのような情報を出力するのか、未経験の方でも分かりやすいシンプルなサンプルコードで確認してみましょう。


public class ThrowableMethodDemo {
public static void main(String[] args) {
try {
// わざと「0での割り算」をして、算術例外を発生させます
int result = 10 / 0;

    } catch (Throwable t) {
        // 1. エラーメッセージだけを表示
        System.out.println("1. getMessageの結果: " + t.getMessage());

        // 2. 例外の型とメッセージを表示
        System.out.println("2. toStringの結果: " + t.toString());

        // 3. エラーの発生源を詳しく表示(スタックトレース)
        System.out.println("3. printStackTraceの実行:");
        t.printStackTrace();
    }
}
}

このプログラムを実行すると、getMessage()では「/ by zero」という直接的な原因が表示され、printStackTrace()では何行目でエラーが起きたかという詳細なレポートが表示されます。

ポイント: 開発現場では、まずprintStackTrace()でエラーの場所を特定し、getMessage()を使ってログに記録したり、画面にエラー内容を表示したりするのが一般的な流れです。これらは「エラーを解決するための手がかり」を見つけるための大切なツールなのです。

3. Throwableを使うケース

3. Throwableを使うケース
3. Throwableを使うケース

Javaのプログラミングにおいて、通常はException(例外)を個別にキャッチして処理するのが基本です。しかし、フレームワークの開発やログ出力の共通基盤など、「どんなトラブルが起きても、まずは漏らさずログに記録したい」という特殊な場面では、あえて全ての親であるThrowableを直接キャッチすることがあります。

未経験の方に向けて、この仕組みを「病院の受付」に例えて解説します。病院には「内科(Exception)」や「外科(Error)」などの専門科がありますが、Throwableはそれらを一括で受け入れる総合総合案内窓口のような役割を果たします。

上記のサンプルコードでは、instanceofという命令を使って、窓口に届いたトラブルが「Error(自力で解決できない致命的な故障)」なのか「Exception(コードの修正や対策で解決できる問題)」なのかを仕分けています。このように、Throwableを扱うことで、種類を問わずあらゆる異常事態を一度に捕まえることができるのです。

注意点: 全てをキャッチできるのは便利ですが、本来なら即座に停止すべき「メモリ不足」などの致命的なエラー(Error)まで自分のプログラムで止めてしまう危険性もあります。そのため、初心者のうちは「基本はException、特別な理由があるときだけThrowable」と使い分けるのが、安全なプログラムを書くための第一歩です。

4. Throwableを使用する際の注意点

4. Throwableを使用する際の注意点
4. Throwableを使用する際の注意点

Throwableを直接キャッチして処理することは、通常のシステム開発では「禁じ手」に近い扱いを受けることがあります。その最大の理由は、「本来止めるべき重大なトラブルまで隠してしまう」リスクがあるからです。

Javaのトラブルには、プログラムの書き換えで直る「例外(Exception)」と、パソコンのメモリ不足など自分ではどうしようもない「エラー(Error)」の2種類があると学びました。Throwableをキャッチするということは、この両方をひとまとめに捕まえてしまうことを意味します。

なぜThrowableを避けるべきなのか?

  • 復旧不可能なエラーを放置してしまう: メモリ不足(OutOfMemoryError)のような致命的な問題が発生しても、プログラムが無理やり動き続けてしまい、データが壊れるなどの二次被害を招く恐れがあります。
  • 原因の特定が難しくなる: 「何でも受け付ける窓口」にしてしまうと、後からログを見返したときに、それが単純な入力ミスなのか、深刻なシステム故障なのかが判別しにくくなります。

未経験の方でも分かりやすいように、間違った使い方(アンチパターン)をシミュレーションしてみましょう。


public class ThrowableCautionDemo {
    public static void main(String[] args) {
        try {
            // 本来はException(対処可能)だけを想定すべき場所で...
            String data = null;
            System.out.println(data.length()); // ここで問題発生!

        } catch (Throwable t) {
            // 【注意】何でもThrowableで受けてしまうと
            // 致命的な「Error」が起きても気づかずに処理が進んでしまう危険がある
            System.out.println("何かのトラブルを検知しました。");
        }
        
        System.out.println("プログラムを強制継続します(これが危険な場合があります)");
    }
}

このように、Throwableは守備範囲が広すぎるため、予期せぬ動作を引き起こす可能性があります。特別なフレームワークを作ったり、システムの根幹で全ログを記録したりする目的がない限り、基本的にはExceptionやその子クラスを狙い撃ちしてキャッチするのが、安全で高品質なコードを書くための鉄則です。

5. エラーと例外の違いを具体例で理解する

5. エラーと例外の違いを具体例で理解する
5. エラーと例外の違いを具体例で理解する

ErrorはJVMや実行環境の深刻な異常(OutOfMemoryErrorStackOverflowErrorなど)を表し、通常は復旧を試みません。一方、Exceptionはプログラム内で想定しうる異常(IOExceptionSQLExceptionなど)で、適切に処理・再試行・通知が可能です。

  • Error の例:メモリ不足、クラスロード失敗など(原則キャッチしない)
  • Exception の例:ファイル未存在、ネットワーク切断、形式不正など(状況に応じて処理)

// Errorは原則キャッチしない方針(例としてのアンチパターン)
try {
    // ここでJVM由来の重大なErrorが発生したとしても...
} catch (Error e) {
    // 問題の根本解決にならない可能性が高い
    System.err.println("致命的: " + e); 
    throw e; // 上位へ伝播させるのが基本
}

6. チェック例外と実行時例外(RuntimeException)の違い

6. チェック例外と実行時例外(RuntimeException)の違い
6. チェック例外と実行時例外(RuntimeException)の違い

チェック例外はメソッド宣言にthrowsが必要で、呼び出し側に対処を促す設計です。実行時例外RuntimeException)はプログラミング上のバグや事前条件違反を表し、throwsは不要です。


import java.io.*;
import java.nio.charset.StandardCharsets;
import java.nio.file.*;

public class ReadSample {
    // チェック例外: 呼び出し側に対処(try-catch or throws)を強制
    public static String readFirstLine(Path path) throws IOException {
        try (BufferedReader br = Files.newBufferedReader(path, StandardCharsets.UTF_8)) {
            return br.readLine();
        }
    }

    // 実行時例外: 事前条件(非null等)を満たさないと発生し得る
    public static int lengthOf(String s) {
        // sがnullならNullPointerException(実行時例外)
        return s.length();
    }
}
  • 外部要因(I/O、DB、ネットワーク)=チェック例外で通知し、リトライや代替処理を検討。
  • プログラミングミス(NullPointerException等)=実行時例外。入力検証やテストで防止。

7. 原因(Cause)と例外チェーン:ラップと再スローのベストプラクティス

7. 原因(Cause)と例外チェーン:ラップと再スローのベストプラクティス
7. 原因(Cause)と例外チェーン:ラップと再スローのベストプラクティス

Throwableは「原因」を保持できます(getCause())。下位レイヤの例外を上位ドメインの文脈でラップして再スローすると、スタックトレースと意味の両方を保てます。


import java.sql.SQLException;

class UserRepository {
    void save(Object user) throws SQLException {
        throw new SQLException("DB接続に失敗");
    }
}

public class ServiceLayer {
    private final UserRepository repo = new UserRepository();

    public void register(Object user) {
        try {
            repo.save(user);
        } catch (SQLException e) {
            // ドメイン文脈を付与してラップ
            throw new IllegalStateException("ユーザー登録に失敗: 保存処理でエラー", e);
        }
    }

    public void rethrowExample() throws IOException {
        try {
            // I/O処理...
            throw new IOException("読み取り失敗");
        } catch (IOException e) {
            // ログ後にそのまま再スロー(スタックは保持)
            // Logger等で記録してから
            throw e;
        }
    }
}

古いAPIで原因を後付けする場合はinitCause()が使えます(ただし一度だけ)。ラップ時はメッセージにビジネス文脈を含め、causeで元例外を失わないようにしましょう。

8. try-with-resourcesとサプレッシド例外・スタックトレースの読み方

8. try-with-resourcesとサプレッシド例外・スタックトレースの読み方
8. try-with-resourcesとサプレッシド例外・スタックトレースの読み方

try-with-resourcesはリソースクローズ時の例外を「サプレッシド(抑制)例外」として保持します。getSuppressed()で補助情報を確認できます。スタックトレースは上から「直近の呼び出し」を読み、原因(getCause())へ辿るのがコツです。


import java.io.*;
import java.nio.file.*;
import java.nio.charset.StandardCharsets;

public class SuppressedDemo {
    public static void main(String[] args) {
        try {
            readAndFail(Paths.get("data.txt"));
        } catch (Exception ex) {
            System.err.println("主要な例外: " + ex);
            for (Throwable s : ex.getSuppressed()) {
                System.err.println("サプレッシド: " + s);
            }
            // 本番ではprintStackTrace()ではなくロガー出力が推奨
            ex.printStackTrace();
        }
    }

    static void readAndFail(Path p) throws Exception {
        try (BufferedReader br = Files.newBufferedReader(p, StandardCharsets.UTF_8)) {
            throw new RuntimeException("処理中に失敗");
        }
    }
}
  • 本番運用ではprintStackTrace()よりロガー(例:java.util.loggingやSLF4J)で記録。
  • fillInStackTrace()は重い処理のため多用しない(パフォーマンスに注意)。
  • スタックトレースは「発生箇所 → 呼び出し元」の順で上から読むと理解しやすい。

まとめ

まとめ
まとめ

JavaのThrowableクラスは、エラー処理の基本を支える非常に重要なクラスです。このクラスを理解することで、例外処理の仕組みや、ErrorExceptionの違いを正しく認識できるようになります。 Throwableを直接使用することは少ないものの、例外の基本構造を把握することは、安全で効果的なプログラミングに繋がります。

主に学んだポイントは次の通りです:

  • Throwableは、ErrorExceptionの共通の親クラスであること
  • Errorは通常、システムレベルの致命的な問題であり、回復は難しい
  • Exceptionはプログラム内で発生する例外であり、適切な処理で回復可能
  • Throwableの便利なメソッド(getMessage()printStackTrace()など)

以下は、まとめとしてThrowableを活用した例外のデバッグ例です:


public class ThrowableDebugExample {
    public static void main(String[] args) {
        try {
            causeError();
        } catch (Throwable t) {
            System.out.println("エラーの発生: " + t.toString());
            System.out.println("詳細なスタックトレース:");
            t.printStackTrace();
        }
    }

    private static void causeError() throws Exception {
        throw new Exception("意図的に発生させた例外");
    }
}

エラーの発生: java.lang.Exception: 意図的に発生させた例外
詳細なスタックトレース:
java.lang.Exception: 意図的に発生させた例外
    at ThrowableDebugExample.causeError(ThrowableDebugExample.java:9)
    at ThrowableDebugExample.main(ThrowableDebugExample.java:5)

このコードでは、例外が発生した際にThrowableの機能を活用し、エラーの詳細情報を出力しています。

先生と生徒の振り返り会話

生徒

「Throwableクラスの役割がだいぶ理解できました!けど、Errorをキャッチするのは本当にダメなんですね?」

先生

「そうですね。Errorはシステム全体に関わる致命的な問題なので、無理にキャッチしても解決にならないことがほとんどです。通常はExceptionだけをキャッチして適切に対処しましょう。」

生徒

「例外の詳細を出力するprintStackTrace()がとても便利そうです!」

先生

「その通りです。エラーの発生箇所や原因を特定するための強力なツールなので、デバッグ時にはぜひ活用してくださいね。」

この記事を読んだ人からの質問

この記事を読んだ人からの質問
この記事を読んだ人からの質問

プログラミング初心者からのよくある疑問/質問を解決します

JavaのThrowableクラスとは何ですか?

Throwableクラスは、Javaの例外処理機構の基盤となるクラスで、エラー(Error)や例外(Exception)を表現するために使われます。すべてのエラーや例外はThrowableを継承しており、例外処理の基本を理解する上で重要なクラスです。

ErrorとExceptionの違いは何ですか?

Errorは、通常プログラムの回復が難しい致命的な問題(例えばメモリ不足やJVMのクラッシュ)を表します。一方、Exceptionはプログラム内で発生する例外であり、適切に処理すれば回復可能です。

Throwableクラスの主なメソッドには何がありますか?

主なメソッドには、エラーや例外のメッセージを取得するgetMessage()、スタックトレースを出力するprintStackTrace()、例外情報を文字列で取得するtoString()などがあります。

Throwableクラスを直接使うことはありますか?

通常のプログラムでは、Throwableを直接使うことは少なく、Exceptionやそのサブクラスを使って例外処理を行います。ただし、特定の状況ではThrowableをキャッチしてエラーと例外を区別することもあります。

printStackTrace()メソッドはどのようなときに使うべきですか?

printStackTrace()メソッドは、エラーや例外が発生したときに、その発生箇所や原因を特定するために使います。デバッグ時に非常に役立つメソッドで、例外の発生元を調べるのに便利です。

Throwableクラスを使うメリットは何ですか?

Throwableを使うことで、エラーや例外の詳細情報を取得できるため、デバッグやログ出力に役立ちます。また、ExceptionとErrorを区別する処理が可能になります。

try-catch文でThrowableをキャッチするのは問題がありますか?

基本的に、Throwableをキャッチするのは推奨されません。なぜなら、Errorをキャッチしても適切に処理できるとは限らないためです。通常はExceptionクラスをキャッチするのが適切です。

JavaではErrorをキャッチしないほうが良いのはなぜですか?

Errorはシステムレベルの深刻な問題を表しており、通常のプログラムでは回復が難しいため、無理にキャッチすることは推奨されません。適切な例外処理を行うためには、Exceptionのみをキャッチする方が良いでしょう。

Throwableを継承した独自の例外クラスを作成できますか?

はい、可能ですが、通常はExceptionまたはRuntimeExceptionを継承した独自の例外クラスを作成するのが一般的です。Throwableを直接継承することは稀です。

Javaの例外処理において、チェック例外と非チェック例外の違いは何ですか?

チェック例外(Checked Exception)は、コンパイル時に処理が強制される例外で、IOExceptionなどが該当します。一方、非チェック例外(Unchecked Exception)は、RuntimeExceptionを継承する例外であり、コンパイル時に処理が強制されません。NullPointerExceptionなどが該当します。

Errorが発生した場合、アプリケーションはどのように振る舞うべきですか?

基本は「Fail-Fast」です。重大障害を検知したら速やかにログと監視通知を行い、プロセスを安全に停止します。無理に継続するとデータ破損や更なる不整合を招くため避けます。

Exceptionでも致命的と判断して停止すべきケースはありますか?

ドメイン整合性が失われた場合や、代替手段が無く継続で被害が拡大する場合は停止すべきです。例:トランザクション不整合、暗号鍵の読み込み失敗など。

ネットワーク障害はErrorですか、それともExceptionですか?

通常はException(例:IOException、SocketTimeoutException)として扱います。リトライやフォールバック、サーキットブレーカーなどの回復策を検討します。
カテゴリの一覧へ
新着記事
New1
Thymeleaf
Thymeleafの#mapsユーティリティとは?初心者向けマップ操作ガイド
更新記事
New2
Thymeleaf
Thymeleafの#arraysユーティリティとは?初心者向け配列操作ガイド
更新記事
New3
Thymeleaf
Thymeleafの#strings.sizeメソッドとは?初心者向け文字列の長さ取得ガイド
更新記事
New4
Thymeleaf
Thymeleafの#datesユーティリティとは?初心者向け日付操作ガイド
更新記事
人気記事
No.1
Java&Spring記事人気No1
Java
Javaのクラスとインスタンス化、コンストラクタの使い方完全ガイド!初心者でもわかるオブジェクト指向の基礎
No.2
Java&Spring記事人気No2
JSP
JSPの基本タグ一覧と使い方まとめ!実務で使えるタグを紹介
No.3
Java&Spring記事人気No3
Spring
Spring BootとJavaの互換性一覧!3.5/3.4/3.3はJava 21・17に対応してる?
No.4
Java&Spring記事人気No4
Java
JavaのDateクラスの使い方を完全ガイド!初心者でもわかる日付操作
No.5
Java&Spring記事人気No5
Java
JavaのExceptionクラスを完全解説!初心者でも理解できる例外処理の基本
No.6
Java&Spring記事人気No6
Java
Java開発環境「Eclipse(Pleiades)」のインストール方法とメリットを初心者向けに解説
No.7
Java&Spring記事人気No7
Thymeleaf
Thymeleafのth:hrefの使い方を全解説。初心者でも完璧に理解できるガイド
No.8
Java&Spring記事人気No8
Thymeleaf
Thymeleafのth:valueの使い方を解説!フォーム入力値を保持したり動的に表示する方法