【Java】java.lang.NullPointerExceptionの原因と解決方法を徹底解説

Javaでアプリケーションを開発したことがある方なら、「NullPointerException」というエラーに一度は遭遇したことがあるのではないでしょうか。NullPointerExceptionは、Java開発において最も頻繁に発生する例外の一つです。多くの場合、人為的なミスが原因ですが、原因の特定に時間がかかることも少なくありません。単純な構文エラーではないため、問題箇所の特定が難しい場合がある点も厄介です。

本記事では、java.lang.NullPointerExceptionとは何か、なぜ発生するのか、どのように修正すればよいのか、そしてnullポインタに悩まされないためのベストプラクティスまで、順を追って詳しく解説します。

java.lang.NullPointerExceptionとは？

NullPointerExceptionは、Java言語がサポートする数ある例外の中の一つで、現在nullを参照している変数に対してアクセスしようとした際に発生します。

Javaでは、宣言時に初期化されていない変数には、デフォルト値として「null」が割り当てられます。以下の例を見てみましょう。まず、変数を次のように宣言します。

String str;

その後、この変数の内容を出力してみます。

System.out.println(str);
// => null

上記のコードを実行すると、出力には「null」と表示されます。これは、変数strが初期化されていないため、現時点でnullという値を保持していることを示しています。nullを参照する変数の問題点は、その変数が単なる参照であり、実際には何も指していないことにあります。nullを参照する変数に格納されたデータに対して何らかの操作を行おうとしても、システムはどう処理すべきか判断できません。変数には実際のデータが格納されておらず、空の実体を指しているためです。

java.lang.NullPointerExceptionの発生例

NullPointerExceptionのサンプルを作るのは簡単で、変数を初期化せずにアクセスしようとするだけで発生します。ここでは、文字列の生成や操作を扱うStringBuilderクラスを例に考えてみましょう。通常、このクラスを使って文字列を作成するコードは以下のようになります。

public class Test {
  public static void main(String[] args) {
    StringBuilder sb = new StringBuilder();

    sb.append("Hello ");
    sb.append("World!");

    String result = sb.toString();

    System.out.println(result);
    // => Hello World!
  }
}

このコードを実行すると、正常に動作します。次に、NullPointerExceptionが発生する修正版のコードを見てみましょう。

public class Test {
  public static void main(String[] args) {
    StringBuilder sb;

    sb.append("Hello ");
    sb.append("World!");

    String result = sb.toString();

    System.out.println(result);
  }
}

ご覧のとおり、このコードではStringBuilderクラスのインスタンスを宣言時に初期化していません。sb.append()の行が実行される時点で、変数sbは実際にはどのオブジェクトも参照しておらず、nullを指しています。ここでNullPointerExceptionがスローされ、例外が発生するため、JVMはそれ以降のステートメントを実行できません。

java.lang.NullPointerExceptionエラーの解決方法

NullPointerExceptionを引き起こすのは簡単ですが、それを回避・修正するのは少し手間がかかります。一部の統合開発環境（IDE）では、変数を初期化する前にアクセスした場合に警告を表示してくれますが、複数のメソッド呼び出しをまたいで変数が渡されるような複雑なケースでは、IDEでも検出できないことがほとんどです。NullPointerExceptionの正確な修正方法は状況やコードによって異なりますが、ここでは代表的なnullポインタへの対処法を紹介します。

コードの手入力ミスを確認する

NullPointerExceptionが発生する最大の原因は、人為的なミスです。まず、書いたプログラムが当初意図したロジック通りになっているかを確認しましょう。また、ソースコードを目視で見直し、ステートメントの記述漏れや変数名のスペルミスなどによって、変数に値が代入されていない箇所がないかもチェックしてください。

ロジックに沿ってコードが書かれていること、ステートメントの抜けがないこと、オブジェクトが誤った参照に代入されていないことを確認しましょう。経験則として、変数を使用する前に必ずオブジェクトで初期化されているかをチェックすると良いでしょう。

nullポインタが発生しうるコードに安全策を設ける

NullPointerExceptionの原因となるコード行が分かっていて、ロジック自体は正しいと確信できる場合は、try-catchブロックでそのコードを囲み、nullポインタをキャッチした際の挙動を定義する方法があります。具体的には以下のような形になります。

...
// 上部のコード

try {
  // 例外が発生しやすいコードをここに記述
} catch (NullPointerException npe) {
  // NPEをキャッチした際の処理を定義
}

// 下部のコード
...

この手法が有効なのは、ある参照変数がnullになる場合とならない場合の両方がありうるシチュエーションです。多くの場合、外部APIのレスポンスやデバイスインターフェースからの応答などがこれに該当します。結果やハードウェアの可用性によって、レスポンス変数がインスタンス化されたオブジェクトを参照する場合と、そうでない場合があります。こうした状況への対処には、安全策の設置が最適です。

アクセス前にnullチェックを行う

この方法はtry-catchによる方法と似ていますが、こちらは「if」ブロックを使って、変数にアクセスする前にnullかどうかをチェックします。先ほどのコードをifブロックで書き直すと、以下のようになります。

...
// 上部のコード

if (myVar != null) {
  // 正常時のロジックをここに記述
} else {
  // null値のハンドリングをここで行う
}

// 下部のコード
...

両者の最大の違いは、チェックの範囲です。if文による方法ではmyVar変数のみをnullチェックしますが、try-catchブロックではnullになりうるすべての変数をまとめてキャッチします。

このため、ifブロックの方がより的確でクリーンなアプローチと言えます。ただし、nullになりうる変数が複数存在する場合は、シンプルさの観点からtry-catchブロックを選ぶ方が良いでしょう。

まとめ

本記事では、JavaにおけるNullPointerExceptionとは何か、そしてこのエラーがどのように発生するのかを解説しました。さらに、実際にNullPointerExceptionを引き起こすコード例を通じて、実務でnullポインタがどのように生まれるのかを確認しました。最後に、NullPointerExceptionを修正するための主要な方法を紹介し、try-catchとnullチェックという2つの対処法の違いについても比較しました。

Javaプログラムを書くのであれば、NullPointerExceptionの修正方法は必ず押さえておきたい知識の一つです。この例外は非常に頻繁に発生するにもかかわらず、コードの構文や意味論とは直接関係しないため、原因の特定と修正が難しい問題の一つです。本記事のようなリファレンスを参考にすれば、トラブルシューティングの体験がよりスムーズになるはずです。