JavaのUncaughtExceptionHandlerでキャッチされない例外を処理する方法

UncaughtExceptionHandlerとは

UncaughtExceptionHandlerは、Threadクラス内に定義されたインターフェースです。メインスレッドがキャッチされない例外（未処理の例外）によって終了しようとするとき、JVM（Java仮想マシン）はそのスレッドに設定されたUncaughtExceptionHandlerを呼び出します。これにより、スレッドが強制終了される前に、例外情報をファイルにログとして記録する、あるいはログをサーバーへアップロードするといったエラーハンドリングを行うことが可能になります。

また、すべての未処理の例外に対して共通して呼び出されるデフォルト例外ハンドラーを設定することもできます。この機能はJava 5から導入されました。

デフォルトハンドラーの設定方法

デフォルトの例外ハンドラーは、java.lang.Threadクラスの以下の静的メソッドを使用して設定します。

public static void setDefaultUncaughtExceptionHandler(Thread.UncaughtExceptionHandler ueh)

設定するには、Thread.UncaughtExceptionHandlerインターフェースの実装を提供する必要があります。このインターフェースには、次のように単一のメソッドだけが定義されています。

構文

@FunctionalInterface
public interface UncaughtExceptionHandler {
    void uncaughtException(Thread t, Throwable e);
}

• t：例外が発生したスレッド
• e：発生した例外オブジェクト（Throwable）

なお、このインターフェースには@FunctionalInterfaceアノテーションが付与されているため、ラムダ式でも実装できます。

実装例

以下は、カスタムハンドラーを作成し、メインスレッドでスローされた例外を捕捉するサンプルコードです。

public class UncaughtExceptionHandlerTest {
    public static void main(String[] args) throws Exception {
        Thread.setDefaultUncaughtExceptionHandler(new MyHandler());
        throw new Exception("Test Exception");
    }
    private static final class MyHandler implements Thread.UncaughtExceptionHandler {
        @Override
        public void uncaughtException(Thread t, Throwable e) {
            System.out.println("The Exception Caught: " + e);
        }
    }
}

実行結果

The Exception Caught: java.lang.Exception: Test Exception

まとめ

UncaughtExceptionHandlerを活用することで、try-catchでは対応できない予期しない例外を一元的に捕捉できます。実務では、例外のスタックトレースをファイルに出力したり、監視サーバーへ通知したりする仕組みと組み合わせて使われることが多く、アプリケーションの障害解析や安定性向上に役立ちます。特にバックグラウンドスレッドでの例外を取りこぼしたくない場合に有効な手段です。