Java 例外一覧｜種類・原因・対処の早見表と使い分け

Javaの例外は、Throwableを頂点に「検査例外（Exceptionの子孫）」「非検査例外（RuntimeExceptionの子孫）」「Error」の3種類に分かれ、どれに属するかで「try-catchかthrowsが必須かどうか」と「直し方の方向」が決まります。 検査例外はファイルやネットワークなどプログラムの外側の事情で起きるもの、非検査例外は主にコードの誤りで起きるもの、ErrorはJVM自体の深刻な状態を表します。

この記事では、よく出る例外39種を、再現できる最小コードと、実際に表示されたメッセージつきの一覧表にまとめました。さらに、自分で例外を投げるときに迷いやすいIllegalArgumentException・IllegalStateException・NullPointerException・UnsupportedOperationExceptionの使い分けを、判断フローとコードで示します。Throwableの階層図、Java 14で加わった詳細なNullPointerExceptionメッセージ、try-with-resourcesとマルチキャッチの書き方も載せています。

確認環境：OpenJDK 21.0.10（Linux x64）。記事中の出力はすべてこの環境で実際に表示されたものです。

Java例外の早見表（3種類の違い）

Java 21のAPIドキュメント（Throwable）にも、「Throwableとそのサブクラスのうち、RuntimeExceptionとErrorのどちらのサブクラスでもないものが検査例外として扱われる」と書かれています。

出会うことの多い10個を先に見たい方向けの逆引きです。 メッセージは実際に表示されたものです。

Throwableの階層図

graph TD
  T[Throwable] --> E[Exception 検査例外]
  T --> ER[Error]
  E --> RT[RuntimeException 非検査例外]
  E --> IO[IOException]
  E --> SQL[SQLException]
  E --> ROE[ReflectiveOperationException]
  E --> IE[InterruptedException]
  IO --> FNF[FileNotFoundException]
  IO --> FSE[FileSystemException]
  FSE --> NSF[NoSuchFileException]
  ROE --> CNF[ClassNotFoundException]
  RT --> NPE[NullPointerException]
  RT --> IAE[IllegalArgumentException]
  IAE --> NFE[NumberFormatException]
  RT --> ISE[IllegalStateException]
  RT --> IOOB[IndexOutOfBoundsException]
  IOOB --> AIOOB[ArrayIndexOutOfBoundsException]
  RT --> UOE[UnsupportedOperationException]
  ER --> VME[VirtualMachineError]
  VME --> SOE[StackOverflowError]
  VME --> OOM[OutOfMemoryError]
  ER --> LE[LinkageError]
  LE --> NCDF[NoClassDefFoundError]

階層を知っておくと役に立つのは、catchの書き方を決めるときです。catch (IOException e) と書けば FileNotFoundException も NoSuchFileException もまとめて受け取れます。逆に catch (Exception e) は RuntimeException まで受け取るので、コードの誤りまで包み隠してしまうことがあります。

非検査例外の一覧（RuntimeExceptionの子孫）20種

「再現コード」は後述の確認用プログラムでそのまま動かしたものです。番号（U01など）は実行結果と対応しています。

U03は List.of で作ったリストの出力です。ArrayList で同じことをすると「Index 2 out of bounds for length 2」と、文面が少し変わります（こちらも実行して確認しました）。同じ例外でも、投げているクラスによってメッセージの形が違うことがあります。

検査例外の一覧（try-catchかthrowsが必須）14種

C05のメッセージの後半（Name or service not known）はOSが返す文面なので、Windowsなどでは異なります（今回確認したのはLinuxのみです）。

Errorの一覧 5種

E03とE04はセットで覚えると調べやすくなります。 staticフィールドの初期化で例外が起きると1回目は ExceptionInInitializerError、2回目以降は NoClassDefFoundError（Could not initialize class）になります。ログに後者だけが見えているときは、もっと前の時刻に前者が出ています。

一覧表の再現コードと実行結果（コピーして動かせます）

上の3つの表は、次のプログラムの出力を元にしています。ExceptionList.java として保存し、javac ExceptionList.java のあと java ExceptionList で実行できます。

import java.io.*;
import java.net.*;
import java.nio.file.*;
import java.sql.*;
import java.text.*;
import java.time.*;
import java.util.*;
import java.util.concurrent.*;

public class ExceptionList {
    interface Code { void run() throws Throwable; }

    static void show(String no, Code code) {
        try {
            code.run();
            System.out.println(no + " 例外なし");
        } catch (Throwable e) {
            String kind = e instanceof Error ? "Error"
                        : e instanceof RuntimeException ? "非検査" : "検査";
            System.out.println(no + " [" + kind + "] 親="
                + e.getClass().getSuperclass().getSimpleName() + " / " + e);
        }
    }

    static int deep(int n) { return deep(n + 1); }
    static class Config { static int size = Integer.parseInt("x"); }

    public static void main(String[] args) {
        // ---- 非検査例外（RuntimeException の子孫）
        show("U01", () -> { String s = null; s.length(); });
        show("U02", () -> { int[] a = new int[3]; a[3] = 1; });
        show("U03", () -> { List.of(1, 2).get(2); });
        show("U04", () -> { "abc".substring(5); });
        show("U05", () -> { Object o = "abc"; Integer i = (Integer) o; });
        show("U06", () -> { Integer.parseInt("12a"); });
        show("U07", () -> { Thread.sleep(-1); });
        show("U08", () -> { var st = List.of(1, 2).stream(); st.count(); st.count(); });
        show("U09", () -> { List.of(1, 2).add(3); });
        show("U10", () -> { int x = 1 / 0; });
        show("U11", () -> { List<Integer> l = new ArrayList<>(List.of(1, 2, 3));
                            for (Integer i : l) if (i == 1) l.remove(i); });
        show("U12", () -> { Optional.empty().get(); });
        show("U13", () -> { new Scanner("abc").nextInt(); });
        show("U14", () -> { LocalDate.parse("2026/10/03"); });
        show("U15", () -> { LocalDate.of(2026, 2, 30); });
        show("U16", () -> { int[] a = new int[-1]; });
        show("U17", () -> { Object[] o = new String[1]; o[0] = 1; });
        show("U18", () -> { CompletableFuture.supplyAsync(() -> 1 / 0).join(); });
        show("U19", () -> { new Object().notify(); });
        show("U20", () -> { String.format("%d", "a"); });
        // ---- 検査例外（Exception の子孫で RuntimeException 以外）
        show("C01", () -> { var r = new StringReader("a"); r.close(); r.read(); });
        show("C02", () -> { new FileInputStream("/no/such/file.txt"); });
        show("C03", () -> { Files.readString(Path.of("/no/such/file.txt")); });
        show("C04", () -> { new DataInputStream(new ByteArrayInputStream(new byte[1])).readInt(); });
        show("C05", () -> { InetAddress.getByName("no-such-host.invalid"); });
        show("C06", () -> { new Socket("127.0.0.1", 8499); });
        show("C07", () -> { DriverManager.getConnection("jdbc:nodb://x"); });
        show("C08", () -> { Class.forName("com.example.NoSuch"); });
        show("C09", () -> { String.class.getMethod("nope"); });
        show("C10", () -> { Thread.currentThread().interrupt(); Thread.sleep(10); });
        show("C11", () -> { CompletableFuture.supplyAsync(() -> 1 / 0).get(); });
        show("C12", () -> { new CompletableFuture<Integer>().get(10, TimeUnit.MILLISECONDS); });
        show("C13", () -> { new SimpleDateFormat("yyyy-MM-dd").parse("x"); });
        show("C14", () -> { new URI("http://a b"); });
        // ---- Error
        show("E01", () -> { deep(0); });
        show("E02", () -> { long[] big = new long[Integer.MAX_VALUE]; });
        show("E03", () -> { int x = Config.size; });
        show("E04", () -> { int x = Config.size; });
        show("E05", () -> { throw new AssertionError("ここには来ない想定"); });
    }
}

実行結果（OpenJDK 21.0.10。全39行のうち代表的な行を抜粋。残りの行のメッセージは上の表のとおりです）：

U01 [非検査] 親=RuntimeException / java.lang.NullPointerException: Cannot invoke "String.length()" because "<local0>" is null
U03 [非検査] 親=RuntimeException / java.lang.IndexOutOfBoundsException: Index: 2 Size: 2
U05 [非検査] 親=RuntimeException / java.lang.ClassCastException: class java.lang.String cannot be cast to class java.lang.Integer (java.lang.String and java.lang.Integer are in module java.base of loader 'bootstrap')
U09 [非検査] 親=RuntimeException / java.lang.UnsupportedOperationException
C02 [検査] 親=IOException / java.io.FileNotFoundException: /no/such/file.txt (No such file or directory)
C11 [検査] 親=Exception / java.util.concurrent.ExecutionException: java.lang.ArithmeticException: / by zero
E03 [Error] 親=LinkageError / java.lang.ExceptionInInitializerError
E04 [Error] 親=LinkageError / java.lang.NoClassDefFoundError: Could not initialize class ExceptionList$Config

「/」より右側が e.toString() の内容で、catchしなかった場合はこの前に Exception in thread "main" が付いたものがスタックトレースの1行目になります。U01の <local0> という表示については、次の次の章で説明します。

スタックトレースの読み方

例外をcatchしないと、次のようなスタックトレースが表示されます。

import java.util.*;
public class St {
    static int total(List<String> prices) {
        int sum = 0;
        for (String p : prices) sum += toInt(p);
        return sum;
    }
    static int toInt(String s) { return Integer.parseInt(s.trim()); }
    public static void main(String[] args) {
        System.out.println(total(List.of("100", "2OO", "300")));
    }
}

Exception in thread "main" java.lang.NumberFormatException: For input string: "2OO"
    at java.base/java.lang.NumberFormatException.forInputString(NumberFormatException.java:67)
    at java.base/java.lang.Integer.parseInt(Integer.java:662)
    at java.base/java.lang.Integer.parseInt(Integer.java:778)
    at St.toInt(St.java:8)
    at St.total(St.java:5)
    at St.main(St.java:10)

「1行目でクラスとメッセージを読み、自分のクラスが出る最初のat行を開く」 が基本の手順です。

Java 14以降の詳細なNullPointerExceptionメッセージ

Java 14で、NullPointerExceptionのメッセージに「何がnullだったか」を表示する機能が加わりました（JEP 358）。JEPの文面では、Java 14の時点では既定で無効で、-XX:+ShowCodeDetailsInExceptionMessages を付けると有効になるとされています。今回のJava 21では、何も指定しなくても詳細なメッセージが表示されました。

import java.util.*;
public class Npe {
    record Address(String city) {}
    record User(String name, Address address) {}
    static String title;
    public static void main(String[] args) {
        User user = new User("sato", null);
        int[] counts = null;
        Map<String, Integer> stock = new HashMap<>();
        Runnable[] cases = {
            () -> System.out.println(user.address().city().length()),
            () -> System.out.println(title.trim()),
            () -> System.out.println(counts[0]),
            () -> { int n = stock.get("pen"); System.out.println(n); },
            () -> { String s = args.length > 5 ? "x" : null; System.out.println(s.length()); },
        };
        for (int i = 0; i < cases.length; i++) {
            try { cases[i].run(); }
            catch (NullPointerException e) { System.out.println((i + 1) + ": " + e.getMessage()); }
        }
        String local = null;
        local.isEmpty();
    }
}

javac -g Npe.java でコンパイルして実行した結果：

1: Cannot invoke "Npe$Address.city()" because the return value of "Npe$User.address()" is null
2: Cannot invoke "String.trim()" because "Npe.title" is null
3: Cannot load from int array because "counts" is null
4: Cannot invoke "java.lang.Integer.intValue()" because the return value of "java.util.Map.get(Object)" is null
5: Cannot invoke "String.length()" because "s" is null
Exception in thread "main" java.lang.NullPointerException: Cannot invoke "String.isEmpty()" because "local" is null
    at Npe.main(Npe.java:23)

1のようにメソッドを続けて呼ぶ行でも、どの部分がnullだったかがわかるのがこの機能の利点です。4は「Mapに無いキーを get して int に入れた」ときの典型で、getOrDefault("pen", 0) にすると解消します。

ローカル変数名が local1 のように表示されるとき

同じコードを -g なしの javac Npe.java でコンパイルすると、3・5と最後の行は次のように変わりました。

3: Cannot load from int array because "<parameter1>" is null
5: Cannot invoke "String.length()" because "<local1>" is null
Exception in thread "main" java.lang.NullPointerException: Cannot invoke "String.isEmpty()" because "<local5>" is null

ローカル変数や引数の名前は、クラスファイルにデバッグ情報（javac -g）が入っているときだけ表示されます。 入っていないと <local5> のような番号になります。フィールド名やメソッド名は -g がなくても表示されます（1・2・4は同じ出力でした）。MavenやGradleは、通常の設定ではデバッグ情報つきでコンパイルするのが一般的ですが、今回はビルドツール経由の確認は行っていません（未実行）。

-XX:-ShowCodeDetailsInExceptionMessages を付けて実行すると、メッセージは null（1行目は java.lang.NullPointerException だけ）に戻ることも確認しました。

IllegalArgument・IllegalState・NullPointer・UnsupportedOperationの使い分け

自分でメソッドを書くとき、「前提が満たされていない」ことを知らせる例外はこの4つが中心です。

判断フロー

flowchart TD
  A[前提が満たされていない] --> B{その操作自体を<br>このオブジェクトは提供しているか}
  B -- 提供していない --> UOE[UnsupportedOperationException]
  B -- 提供している --> C{引数が原因か}
  C -- はい --> D{引数がnullか}
  D -- はい --> NPE[NullPointerException<br>Objects.requireNonNull]
  D -- いいえ --> E{添字の範囲外か}
  E -- はい --> IOOB[IndexOutOfBoundsException<br>Objects.checkIndex]
  E -- いいえ --> IAE[IllegalArgumentException]
  C -- いいえ 引数が正しくても呼べない --> ISE[IllegalStateException]

見分け方のコツは「誰が何を直せば成功するか」 です。引数を直せば成功するなら IllegalArgumentException、呼ぶタイミングを直せば成功するなら IllegalStateException、どう呼んでも成功しないなら UnsupportedOperationException です。nullの引数に NullPointerException を使うのは、JDK標準の Objects.requireNonNull がそうしているためで、標準ライブラリと動きがそろいます。

具体例（実行結果つき）

import java.util.*;
public class Which {
    static class Task {
        private final String title;
        private boolean started, done;
        Task(String title) {
            this.title = Objects.requireNonNull(title, "title は必須です");
            if (title.isBlank()) throw new IllegalArgumentException("title は空にできません");
        }
        void setPriority(int p) {
            if (p < 1 || p > 5)
                throw new IllegalArgumentException("priority は 1〜5 で指定してください: " + p);
        }
        void start() { started = true; }
        void finish() {
            if (!started) throw new IllegalStateException("start() の前に finish() は呼べません");
            done = true;
        }
    }
    static class ReadOnlyTask extends Task {
        ReadOnlyTask(String t) { super(t); }
        @Override void setPriority(int p) {
            throw new UnsupportedOperationException("読み取り専用のタスクは変更できません");
        }
    }
    interface T { void run(); }
    static void t(T b) { try { b.run(); } catch (RuntimeException e) { System.out.println(e); } }
    public static void main(String[] a) {
        t(() -> new Task(null));
        t(() -> new Task("  "));
        t(() -> new Task("資料作成").setPriority(9));
        t(() -> new Task("資料作成").finish());
        t(() -> new ReadOnlyTask("資料作成").setPriority(3));
        t(() -> Objects.checkIndex(5, 3));
    }
}

実行結果：

java.lang.NullPointerException: title は必須です
java.lang.IllegalArgumentException: title は空にできません
java.lang.IllegalArgumentException: priority は 1〜5 で指定してください: 9
java.lang.IllegalStateException: start() の前に finish() は呼べません
java.lang.UnsupportedOperationException: 読み取り専用のタスクは変更できません
java.lang.IndexOutOfBoundsException: Index 5 out of bounds for length 3

メッセージには「何が」「どういう条件で」「実際の値は何だったか」を入れると、ログを見た人がすぐ動けます（priority は 1〜5 で指定してください: 9 のように）。

try-with-resourcesとマルチキャッチの書き方

1つのコードで動きを確認する

import java.io.*;
import java.nio.file.*;
import java.time.*;
import java.time.format.*;

public class Trw {
    static class Res implements AutoCloseable {
        final String name;
        Res(String name) { this.name = name; System.out.println("open " + name); }
        void use(boolean boom) {
            if (boom) throw new IllegalStateException(name + " の処理中に問題発生");
        }
        @Override public void close() throws IOException {
            System.out.println("close " + name);
            if (name.equals("B")) throw new IOException(name + " を閉じるときに問題発生");
        }
    }

    static Object parse(String s) {
        try {
            if (s.contains("-")) return LocalDate.parse(s);
            return Integer.parseInt(s);
        } catch (NumberFormatException | DateTimeParseException e) {   // マルチキャッチ
            System.out.println("変換できない入力: " + s + " (" + e.getClass().getSimpleName() + ")");
            return null;
        }
    }

    public static void main(String[] args) {
        try (Res a = new Res("A"); Res b = new Res("B")) {            // try-with-resources
            b.use(true);
        } catch (IllegalStateException | IOException e) {
            System.out.println("catch: " + e);
            for (Throwable s : e.getSuppressed()) System.out.println("  suppressed: " + s);
        } finally {
            System.out.println("finally");
        }

        System.out.println(parse("123") + " / " + parse("2026-10-03") + " / "
            + parse("12a") + " / " + parse("2026-13-01"));

        try {
            try {
                Files.readString(Path.of("/no/such/config.txt"));
            } catch (IOException e) {
                throw new UncheckedIOException("設定ファイルを読めません: config.txt", e);  // 包み直す
            }
        } catch (RuntimeException e) {
            System.out.println(e);
            System.out.println("Caused by: " + e.getCause());
        }
    }
}

実行結果：

open A
open B
close B
close A
catch: java.lang.IllegalStateException: B の処理中に問題発生
  suppressed: java.io.IOException: B を閉じるときに問題発生
finally
変換できない入力: 12a (NumberFormatException)
変換できない入力: 2026-13-01 (DateTimeParseException)
123 / 2026-10-03 / null / null
java.io.UncheckedIOException: 設定ファイルを読めません: config.txt
Caused by: java.nio.file.NoSuchFileException: /no/such/config.txt

• try-with-resources は、開いた順と逆の順（B → A）で自動的に閉じます。 閉じる処理はcatchやfinallyより先に実行されます。
• 本体の例外と close の例外が両方起きたときは、本体の例外が投げられ、close の例外は getSuppressed() で取り出せます。 元の原因が残るので調べやすくなります。
• マルチキャッチは | で区切って、同じ処理をする例外をまとめます。 変数 e は暗黙的にfinalで、再代入はできません。
• 検査例外を非検査例外に包み直すときは、第2引数に元の例外（cause）を渡します。 渡し忘れると Caused by: が出ず、根本の原因が追えなくなります。

マルチキャッチと検査例外のコンパイルエラー

次の3つは、実際に javac 21 で表示されたエラーです。

3つめが「検査例外はtry-catchかthrowsが必須」の正体です。非検査例外にはこのチェックがないので、何も書かなくてもコンパイルは通ります。

finallyとスレッドでの注意点（実行して確認）

例外への対処を決める判断表

よくある質問

Q. 検査例外と非検査例外は、どう見分けますか？ A. 継承元で決まります。RuntimeExceptionの子孫とErrorの子孫が非検査、それ以外のThrowableの子孫が検査例外です。迷ったら、try-catchもthrowsも書かずにコンパイルしてみると、検査例外なら「unreported exception ...; must be caught or declared to be thrown」と表示されます。

Q. IllegalArgumentExceptionとIllegalStateExceptionで迷ったら？ A. 「引数を変えれば成功するか」で考えます。成功するなら IllegalArgumentException、引数が正しくても今の状態では呼べない（順番や時期の問題）なら IllegalStateException です。引数がnullのときは Objects.requireNonNull を使い、NullPointerException にするとJDK標準とそろいます。

Q. catch (Exception e) でまとめて捕まえてもよいですか？ A. 処理の入口（リクエストの受け口やバッチの最上位）で1か所だけ、ログに記録する目的で使うのは一般的です。個々の処理の中で使うと、NullPointerExceptionのようなコードの誤りまで受け取ってしまい、原因に気づきにくくなります。対処できる例外だけを、種類を指定して捕まえるのがおすすめです。

Q. Errorはcatchしてもよいですか？ A. 文法上は書けますが、通常は捕まえません。OutOfMemoryErrorなどはJVMの状態そのものが不安定になっている合図で、処理を続けても別の場所で問題が出やすいためです。原因（データ量、再帰の深さ、static初期化の例外）を調べて直します。

まとめ

• 例外は「検査例外」「非検査例外」「Error」の3種類。 RuntimeExceptionとErrorの子孫以外が検査例外で、try-catchかthrowsが必須です。
• 非検査例外の多くはコードの誤りの合図です。捕まえて隠すより、スタックトレースで自分のクラスが最初に出る行を開いて直します。
• Java 21ではNullPointerExceptionのメッセージに「何がnullだったか」が表示されます。 ローカル変数名まで出すには javac -g のデバッグ情報が必要です。
• 引数を直せば成功するなら IllegalArgumentException、タイミングを直せば成功するなら IllegalStateException、どう呼んでも提供していないなら UnsupportedOperationException、nullの引数は NullPointerException を投げます。
• try-with-resources は逆順に自動で閉じ、close の例外は suppressed に残ります。 マルチキャッチは親子関係のない例外を | でまとめます。
• 包み直すときは cause を必ず渡すと、Caused by: から根本の原因をたどれます。
• ExceptionInInitializerError と NoClassDefFoundError（Could not initialize class）はセットで、先に出た前者の Caused by を直します。

参考・出典

• Java SE 21 API ドキュメント「Throwable」（検査例外の定義を確認） https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/Throwable.html
• JEP 358: Helpful NullPointerExceptions（Java 14で提供、フラグ名、ローカル変数名には javac -g が必要という記述を確認） https://openjdk.org/jeps/358

株式会社RJC ― SI事業・SES事業・AI駆動開発。RJCは一緒に成長を楽しめる会社です。