JavaでIndexOutOfBoundsExceptionになるListと配列の境界を解説する記事のアイキャッチ。

実装・エラー解決

JavaでIndexOutOfBoundsExceptionになる原因|Listと配列の確認ポイント

AIによる要約

Listや配列の有効な添字は0から要素数-1までです。sizeやlengthと同じ値を指定すると範囲外になります。固定位置のget、空リストの先頭取得、ループ条件の<=、CSV列不足、ページング計算が主な原因です。例外をcatchして無視するのではなく、データ件数を確認し、固定位置へ依存しないAPIや事前検証を使い、境界値テストを追加します。

新人SE
新人SE
Listに3件あるのにget(3)で例外になりました。3件目ではないんですか?
ポンコツSE
ポンコツSE
添字は0から始まるので、3件のListで使えるのは0、1、2です。

IndexOutOfBoundsExceptionは、指定した位置がコレクションや文字列の範囲外であるときに起きます。原因は単純に見えますが、CSVの列不足、検索0件、ページ番号、APIレスポンス変更など、入力データ側の変化で初めて表面化します。

例外行へifを1つ足すだけでは、なぜ件数が足りなかったのかを隠すことがあります。固定位置を使う設計が妥当か、0件を正常とするか、外部データ不正として止めるかを確認します。

この記事のポイント

  • 有効な添字は0からsize-1まで
  • ループ条件の<=は範囲外になりやすい
  • 空Listへget(0)は使えない
  • 固定列や固定位置を使う前に件数を検証する
  • 例外をcatchして処理継続せずデータ契約を確認する

リストと配列の添字、ページ番号の境界を試す

ページ番号を変換する PageIndex.java、リスト・配列・ページ番号を確かめる IndexBoundariesTest.java、pom.xml の全文を収録しています。JDK 17とMaven 3.9系を用意し、ZIPを展開したフォルダで mvn test を実行します。検索RepositoryとCSVのコードは本文の説明用の抜粋です。

添字は0から始まる

3要素のListの添字は0、1、2です。size()は要素数3を返すため、そのままgetへ渡すと範囲外になります。配列も同じで、lengthが3なら最後は添字2です。array[3]では、IndexOutOfBoundsExceptionのサブクラスであるArrayIndexOutOfBoundsExceptionが出ます。

List<String> names = List.of("A", "B", "C");

System.out.println(names.get(0)); // A
System.out.println(names.get(2)); // C
System.out.println(names.get(3)); // IndexOutOfBoundsException

『3件目』と『添字3』を混同しないよう、変数名をindex、position、rowNumberで分けます。画面の1始まりの行番号を添字へ変換する場合も境界で明示します。

ループ条件はi < size

添字で走査するfor文では、条件をi <= list.size()とすると最後にsizeと同じ値へ到達して例外になります。

for (int i = 0; i < names.size(); i++) {
    System.out.println(names.get(i));
}

要素だけが必要なら拡張forを使う方が添字ミスを避けられます。前後要素との比較、行番号の出力など、添字が必要な理由がある場合だけ通常forを使います。

空Listの先頭を無条件に取らない

検索結果の先頭をget(0)で取るコードは、0件時に失敗します。検索0件が正常か異常かを決め、戻り値の契約に合う方法を使います。

List<User> users = repository.findByEmail(email);
if (users.isEmpty()) {
    throw new UserNotFoundException(email);
}
User user = users.get(0);

1件だけを期待する検索なら、Repositoryの戻り値をOptionalにする、DBの一意制約を設定するなど、Listの先頭へ依存しない設計を検討します。2件以上も異常なら件数検証が必要です。

CSVの列不足で発生する

CSVを分割した配列から固定添字で値を取る処理は、末尾空項目や不正行で列数が足りないと失敗します。

String[] columns = line.split(",", -1);
if (columns.length != 5) {
    throw new InvalidCsvException(
            "期待列数=5, 実際=" + columns.length);
}
String userId = columns[0];
String email = columns[4];

引用符を含むCSVはsplitだけで解析できません。ライブラリで列を解析した後でも、必須列数とヘッダーを検証し、何行目が不正か利用者へ返します。

ページング計算の境界

画面のページ番号が1始まりで、内部の検索が0始まりなら、画面の1は内部の0、画面の2は内部の1へ変換します。減算してから負の値かを調べるコードでは、Integer.MIN_VALUE(-2,147,483,648)から1を引くと、intの範囲を超えて2,147,483,647になり、負数の判定をすり抜けます。入力が1以上かを先に確認する PageIndex.java の全文が以下です。

package example.paging;

public final class PageIndex {
    private PageIndex() {}

    public static int toZeroBased(int requestedPage) {
        if (requestedPage < 1) {
            throw new IllegalArgumentException("ページ番号は1以上を指定してください");
        }
        return requestedPage - 1;
    }
}

PageIndex が検証するのは、ページ番号の下限です。たとえば検索結果が25件で1ページ10件なら、4ページ目は下限を通ります。その要求に空の結果を返すか、入力エラーにするかは検索の仕様で決めます。ページサイズ0や、検索条件を変えた直後に前のページ番号が送られる場面も別に確認します。Java言語仕様の整数演算

subListとsubstringも終端に注意

subList(from, to)やsubstring(begin, end)は、開始位置を含み終了位置を含まない半開区間です。終了位置にはsizeやlengthを指定できますが、開始と終了の大小関係も必要です。

List<String> firstTwo = names.subList(0, 2); // A, B
String text = "ABCDE";
String part = text.substring(1, 3); // BC

境界ルールが混在する自作APIを増やさず、Java標準の半開区間に合わせると読み手の予測が安定します。

catchして空値を返さない

範囲外例外をcatchし、空文字やnullを返すと、データ不正や実装バグが正常値に見えます。事前に件数を確認し、仕様に応じたエラーへ変換します。

// 避けたい例
try {
    return columns[4];
} catch (IndexOutOfBoundsException e) {
    return "";
}

欠損列を空文字として補完する仕様なら、catchではなく列数検証と明示的な補完処理にします。意図がコードとログに残ります。

JUnitで0・1・最大・最大超過を確認する

空Listには先頭がなく、1件だけなら添字0だけが使えます。3件のListでは末尾の2を取得でき、-1とsize()は範囲外です。配列では末尾の2と範囲外のlengthを確かめます。ページ番号の変換は、1・2・Integer.MAX_VALUEを受け付け、0・-1・Integer.MIN_VALUEを拒否します。以下はZIPに入っている IndexBoundariesTest.java の全文です。Java SE 17のList.get仕様

package example.paging;

import static org.junit.jupiter.api.Assertions.assertEquals;
import static org.junit.jupiter.api.Assertions.assertThrows;

import java.util.List;

import org.junit.jupiter.api.Test;
import org.junit.jupiter.params.ParameterizedTest;
import org.junit.jupiter.params.provider.CsvSource;
import org.junit.jupiter.params.provider.ValueSource;

class IndexBoundariesTest {
    @Test
    void emptyListHasNoFirstElement() {
        assertThrows(IndexOutOfBoundsException.class, () -> List.of().get(0));
    }

    @Test
    void singletonAcceptsZeroButRejectsSize() {
        List<String> values = List.of("A");
        assertEquals("A", values.get(0));
        assertThrows(IndexOutOfBoundsException.class, () -> values.get(values.size()));
    }

    @Test
    void threeItemsAcceptTheLastIndexButRejectNegativeAndSize() {
        List<String> values = List.of("A", "B", "C");
        assertEquals("C", values.get(values.size() - 1));
        assertThrows(IndexOutOfBoundsException.class, () -> values.get(-1));
        assertThrows(IndexOutOfBoundsException.class, () -> values.get(values.size()));
    }

    @Test
    void arrayAcceptsLastIndexButRejectsLength() {
        String[] values = {"A", "B", "C"};
        assertEquals("C", values[values.length - 1]);
        assertThrows(ArrayIndexOutOfBoundsException.class, () -> {
            String ignored = values[values.length];
        });
    }

    @ParameterizedTest
    @CsvSource({"1, 0", "2, 1", "2147483647, 2147483646"})
    void convertsPositivePageBeforeSearching(int requestedPage, int expectedIndex) {
        assertEquals(expectedIndex, PageIndex.toZeroBased(requestedPage));
    }

    @ParameterizedTest
    @ValueSource(ints = {0, -1, Integer.MIN_VALUE})
    void rejectsNonPositivePageBeforeSubtracting(int requestedPage) {
        IllegalArgumentException error = assertThrows(IllegalArgumentException.class,
                () -> PageIndex.toZeroBased(requestedPage));
        assertEquals("ページ番号は1以上を指定してください", error.getMessage());
    }
}

mvn test で10件が成功します。PageIndex を「1を引いてから負数か調べる」順番に戻すと、Integer.MIN_VALUE を拒否する1件が失敗します。0と-1だけのテストではこの誤りを検出できません。

現場レビューでよくある指摘

範囲外例外のレビューでは、添字を1減らす修正だけでなく、件数不足が正常か異常か、固定位置依存が必要かを確認します。

// レビューコメント例
Listの有効な添字は0からsize-1です。
ループ条件をi < sizeへ変更してください。

// レビューコメント例
検索0件でget(0)が失敗します。0件を業務エラーにするか、
Optionalを返すRepositoryへ変更するか確認してください。

// レビューコメント例
CSV列数不足をIndexOutOfBoundsExceptionで検知しています。
固定位置へアクセスする前に期待列数を検証し、行番号付きエラーを返してください。

正常データで再実行して終わらず、0件や列不足を作って修正を確認します。外部入力なら、利用者へ何を直せばよいか返せるエラーにします。

提出前のセルフチェック

レビュー前に確認すること

  • 添字が0始まりであることを確認したか
  • 最大有効値がsize-1か
  • ループ条件がi < sizeか
  • 空Listへget(0)していないか
  • 固定列へアクセス前に列数を検証したか
  • 画面のページ番号を1以上と確認してから内部の0始まりへ変換したか
  • 例外をcatchして空値で隠していないか
  • 0・1・最大・最大超過をテストしたか

Javaの配列とコレクションを復習する参考書

添字、List、配列、ループの基本を一度まとめて確認すると、外部データやページングで起きる境界値の問題を切り分けやすくなります。

書籍「スッキリわかるJava入門 第5版」の表紙
商品画像:Amazon.co.jp
PR Java初学者向け

スッキリわかるJava入門 第5版

中山 清喬 (著), 国本 大悟 (著), 株式会社フレアリンク (監修)

変数・条件分岐から、クラスの基本まで学ぶ一冊。

豊富な図とサンプルで、変数、条件分岐、クラス、例外処理まで順番に学べます。Javaの最初の教科書を探している人向けです。

  • Javaを基礎から体系的に学びたい
  • Java 25 LTS対応の入門書を選びたい

当サイトはAmazonアソシエイト・プログラムの参加者です。価格・在庫・配送条件はAmazonでご確認ください。

この記事とあわせて読みたい

関連記事JavaのList.remove(1)で値ではなく添字が消える理由|Integerを削除する方法 Listの添字とInteger値が混ざる別の落とし穴を解説します。 記事を読む 関連記事JavaのArrays.asListにaddできない原因|List.of・ArrayListとの違い Listの生成方法と変更可否を基本から比較します。 記事を読む 関連記事Spring BootのRepositoryでよくある戻り値の扱い 検索0件・1件・複数件をListやOptionalで表す判断基準を整理します。 記事を読む

まとめ

Listや配列の有効な添字は0から要素数-1までです。sizeと同じ添字、空Listのget(0)、ループ条件の<=、列不足がIndexOutOfBoundsExceptionの代表的な原因です。

例外をcatchして空値へ変えず、アクセス前に件数とデータ契約を検証します。0件、1件、最後の有効位置、範囲外をテストし、固定位置依存が本当に必要か確認してください。

-実装・エラー解決
-,