JavaでStringIndexOutOfBoundsExceptionが出る原因と解決策を解説

2026年3月10日2026年5月5日

例外処理・デバッグ

Javaでプログラミングを行っている際、実行時に突然プログラムが停止し、コンソールにStringIndexOutOfBoundsExceptionというエラーメッセージが表示されて困った経験はないでしょうか。

この例外は、Javaの文字列操作において非常に頻繁に遭遇するトラブルの一つです。

しかし、その発生理由は明確であり、適切な知識と対処法を身につければ、未然に防ぐことも修正することも決して難しくありません。

本記事では、この例外が発生する根本的な原因から、具体的なコード例を用いた解決策、そして開発現場で役立つ予防策まで、プロの視点で徹底的に解説します。

目次 [ close ]

java.lang.StringIndexOutOfBoundsExceptionとは何か

java.lang.StringIndexOutOfBoundsExceptionは、Javaの実行時例外（RuntimeException）の一種であり、java.lang.IndexOutOfBoundsExceptionのサブクラスです。

この例外は、Stringクラスのメソッドにおいて、指定したインデックスが不正な範囲にある場合にスローされます。

Javaの文字列（String）は、内部的に文字の配列のように管理されており、各文字には0から始まる「インデックス」が割り当てられています。

例えば、”Hello”という5文字の文字列がある場合、インデックスは0番目の’H’から始まり、4番目の’o’で終わります。

このとき、インデックスに負の値（-1など）を指定したり、文字列の長さ以上の値（5以上など）を指定してアクセスしようとすると、プログラムは「指定された場所に文字は存在しない」と判断し、この例外を投げます。

この例外は非チェック例外であるため、コンパイル時にはエラーにならず、プログラムを実行して初めて問題が表面化するのが特徴です。

そのため、文字列処理を記述する際には、常に境界条件を意識したコーディングが求められます。

例外が発生する主な原因

StringIndexOutOfBoundsExceptionが発生する主な原因は、大きく分けて以下の3つのパターンに集約されます。

1. 文字列の長さを超えるインデックスへのアクセス

最も一般的な原因は、文字列の末尾を超えたインデックスを指定することです。

Javaのインデックスは0から始まるため、文字列の長さをnとした場合、有効なインデックスの範囲は0からn - 1までとなります。

初心者がよく陥るミスとして、文字列の長さ（length）と同じ値をインデックスに指定してしまうケースがありますが、これは範囲外となります。

2. 負のインデックスの指定

JavaのStringクラスでは、Pythonなどの一部の言語のように「後ろから数える」ための負のインデックス指定をサポートしていません。

インデックスに-1などを渡すと、即座にこの例外が発生します。

計算式によってインデックスを動的に算出している場合に、計算結果が負になってしまうケースが考えられます。

3. substringメソッドでの不適切な範囲指定

substringメソッドを使用する際、開始インデックスが終了インデックスよりも大きい場合や、終了インデックスが文字列の長さを超えている場合に発生します。

また、空文字に対して操作を行おうとした際も、インデックス指定を誤ると容易に発生します。

具体的なコード例と修正方法

ここでは、実際に例外が発生するコードとその修正案を、代表的なメソッドごとに紹介します。

charAtメソッドでの発生例

charAt(int index)は、指定した位置の文字を1文字取得するメソッドです。

Java

public class CharAtExample {
    public static void main(String[] args) {
        String text = "Java";
        // textの長さは4。有効なインデックスは0から3まで。
        // ここでインデックス4（長さと同じ値）を指定すると例外が発生する。
        try {
            char ch = text.charAt(4); 
            System.out.println("文字: " + ch);
        } catch (StringIndexOutOfBoundsException e) {
            System.err.println("例外発生: " + e.getMessage());
        }
    }
}

実行結果

例外発生: String index out of range: 4

修正のポイント： アクセスする前に、インデックスが0以上、かつlength()未満であることを確認する必要があります。

Java

if (index >= 0 && index < text.length()) {
    char ch = text.charAt(index);
    // 処理を続行
}

substringメソッドでの発生例

substring(int beginIndex, int endIndex)は、部分文字列を抽出します。

Java

public class SubstringExample {
    public static void main(String[] args) {
        String str = "Programming";
        
        // ケース1: 終了インデックスが文字列の長さを超えている
        // StringIndexOutOfBoundsExceptionが発生する
        String sub = str.substring(0, 20); 
        
        System.out.println(sub);
    }
}

実行結果

Exception in thread "main" java.lang.StringIndexOutOfBoundsException: begin 0, end 20, length 11

修正のポイント： substringを利用する際は、終了インデックスをMath.min(targetLength, desiredEndIndex)のように制御するか、事前に長さをチェックするロジックを挟むのが安全です。

ループ処理におけるオフバイワン・エラー

ループの継続条件を間違えることで、最後の繰り返しで範囲外にアクセスしてしまうケースです。

Java

public class LoopExample {
    public static void main(String[] args) {
        String data = "Hello";
        
        // 継続条件を i <= data.length() としてしまうと、
        // 最後の i = 5 の時に範囲外アクセスが発生する。
        for (int i = 0; i <= data.length(); i++) {
            System.out.println(data.charAt(i));
        }
    }
}

実行結果

H
e
l
l
o
Exception in thread "main" java.lang.StringIndexOutOfBoundsException: String index out of range: 5

修正のポイント

ループの条件式は常にi < data.length()と記述する習慣をつけましょう。

現場で役立つ例外回避のテクニック

プログラムの堅牢性を高めるためには、例外が発生してから対処するのではなく、発生させない設計が重要です。

1. 事前条件のチェック（バリデーション）

文字列操作を行う前に、対象の文字列がnullでないか、あるいは空文字（””）でないかをチェックします。

また、操作対象のインデックスが動的に変わる場合は、必ず境界値チェックを導入してください。

2. Apache Commons Lang などのライブラリ活用

Java標準のStringメソッドは、範囲外に対して厳格に例外を投げます。

一方で、Apache Commons LangライブラリのStringUtilsクラスに含まれるメソッド（例えばsubstringなど）は、範囲外のインデックスが指定されても例外を投げず、可能な範囲で結果を返したり、空文字を返したりする安全な設計になっています。

3. 正規表現やScannerクラスの利用

文字列から特定のパターンを抽出したい場合、インデックスを直接計算してsubstringを行うとミスが起きやすくなります。

正規表現（Pattern/Matcher）やScanner、あるいはString.split()を利用することで、インデックスを意識せずに安全に分割処理を行うことが可能です。

デバッグ方法：スタックトレースの読み方

もし例外が発生してしまったら、まずはコンソールに出力されたスタックトレースを冷静に読み解きましょう。

項目	内容の読み取り方
例外名	`java.lang.StringIndexOutOfBoundsException`であることを確認。
メッセージ	`String index out of range: 10` のように、どの数値が原因でエラーになったかが表示されます。
発生箇所	スタックトレースの最上部にある自作クラスの行番号を確認し、その行のどのメソッドが原因かを特定します。

例えば、メッセージに「range: -1」とあれば、インデックスを計算するロジックで負の値が算出されていることが分かります。

また、「length 5, index 5」のような詳細メッセージが出る場合（Javaのバージョンによります）は、境界値のミスであると即座に判断できます。