JavaのNullPointerExceptionの原因と対処法【初心者向け解説】

NullPointerExceptionはJava初心者の「あるある」エラー

Javaを学び始めてしばらくすると、ほぼ必ず一度は遭遇するエラーがあります。

Exception in thread "main" java.lang.NullPointerException

「何もないものを使おうとした」というエラーで、初心者はもちろん、ベテランエンジニアでも遭遇することがある定番のエラーです。

このエラーの仕組みを理解しておくと、原因の特定と修正がぐっと速くなります。

null とは、「何も参照していない状態」を表す特別な値です。

変数に null が入っているとき、その変数のメソッドを呼び出したりフィールドにアクセスしようとすると、Javaは「参照先がない」と判断してNullPointerExceptionを投げます。

String name;  // 宣言のみ、初期化していない
System.out.println(name.length());  // NullPointerException!

対処法： 宣言時に初期値を代入する。

String name = "";  // 空文字で初期化
System.out.println(name.length());  // OK → 0

public String getName() {
    return null;  // nullを返している
}

String name = getName();
System.out.println(name.length());  // NullPointerException!

対処法： 使う前にnullチェックをする。

String name = getName();
if (name != null) {
    System.out.println(name.length());
}

String[] names = new String[3];  // 要素はすべてnull
System.out.println(names[0].length());  // NullPointerException!

対処法： 配列の各要素に値を代入してから使う。

String[] names = new String[3];
names[0] = "田中";
System.out.println(names[0].length());  // OK → 2

List<String> list;  // 宣言のみ
list.add("Java");  // NullPointerException!

対処法： newでインスタンスを生成する。

List<String> list = new ArrayList<>();  // インスタンス化
list.add("Java");  // OK

NullPointerExceptionが出たとき、スタックトレースに注目しましょう。

Exception in thread "main" java.lang.NullPointerException
    at Main.main(Main.java:8)

Main.java:8 は「Main.javaの8行目で起きた」という意味です。まずその行を確認し、どの変数がnullになっているかを特定するのが解決への近道です。

Java 14から、NullPointerExceptionのメッセージがより詳しくなりました。

Cannot invoke "String.length()" because "name" is null

「nameがnullだからlength()を呼び出せない」と具体的に教えてくれます。Java 14以降を使っている場合は、このメッセージを手がかりに原因を特定しましょう。

最初はnullチェックを書くのを忘れがちですが、「この変数はnullになり得るか？」を意識する習慣をつけるだけで、NullPointerExceptionの発生頻度はぐっと減ります。

NullPointerExceptionのようなエラーは、Javaの基礎をしっかり理解することで格段に減らせます。

学びテック のJava基礎コースでは、変数・オブジェクト・例外処理といった基礎を、演習問題を解きながら体系的に学べます。