Parameter index out of rangeの直し方｜JDBC

Parameter index out of range (2 > number of parameters, which is 1). は、PreparedStatement の setInt・setString で指定した番号が、SQL の ? の数より大きい（または 0 以下）ときのエラーです。 この形は MySQL Connector/J のメッセージで、MySQL のバグ票にも同じ形（Parameter index out of range (4 > number of parameters, which is 2).）が載っています。

ドライバによって、同じ間違いでもエラー文が違います。 確認環境では次のように表示されました。

PostgreSQL のドライバは、?（パラメータ）のことも「column」と表示します。 number of columns: 0 は「この SQL には ? が1つも無い」という意味です。

確認環境：OpenJDK 21、PostgreSQL 16.15 と pgJDBC 42.7.2、MySQL 8.0.46 と MariaDB Connector/J 2.7.6 で再現しました。MySQL Connector/J は手元で使えなかったため、そのメッセージは MySQL のバグ票の記載を示しています（確認日 2026年10月11日）。

番号は 1 から数える

PreparedStatement ps = con.prepareStatement(
    "SELECT name FROM j_users WHERE id = ?");
ps.setInt(1, 1);            // 1つ目の ? は 1

Java の公式ドキュメント（PreparedStatement）では、parameterIndex は「最初のパラメータが 1、2番目が 2」と説明され、SQL の ? に対応しない番号では SQLException になると書かれています。配列やリストのつもりで 0 から数えると、エラーになります。

'?' を引用符で囲むと、? として扱われない

// 間違い
con.prepareStatement("SELECT name FROM j_users WHERE name = '?'");
// 正しい
con.prepareStatement("SELECT name FROM j_users WHERE name = ?");

'?' は「? という文字」になり、パラメータではなくなります。 SQL の中の ? が0個になるので、setString(1, ...) が「範囲外」になりました。値を入れるのはドライバの仕事なので、文字列の値でも引用符は書きません。

LIKE の % はどこに書くか

% は、SQL ではなく、渡す値の側に付けます。 値に %・_ が含まれる可能性があるときは、エスケープも必要です。

取り出すとき（getString）の番号の間違い

ResultSet から値を取り出すときも、番号の間違いで似たエラーになります。

PostgreSQL のドライバでは、setString の間違いも getString の間違いも、同じ The column index is out of range でした。 スタックトレースの行番号で、set と get のどちらで起きたかを確かめます。列は名前で取り出す（rs.getString("name")）と、SELECT の列の順番を変えても壊れません。

? の数を数える方法

SQL を文字列の連結で組み立てていると、? の数と set の数がずれやすくなります。

String sql = "UPDATE j_users SET name = ?, email = ? WHERE id = ?";
long count = sql.chars().filter(c -> c == '?').count();   // 3

条件によって AND x = ? を足す SQL は、番号を変数で数えながら set すると、ずれを防げます。

List<Object> params = new ArrayList<>();
StringBuilder sql = new StringBuilder("SELECT * FROM j_users WHERE 1 = 1");
if (name != null)  { sql.append(" AND name LIKE ?"); params.add("%" + name + "%"); }
if (email != null) { sql.append(" AND email = ?");   params.add(email); }
try (PreparedStatement ps = con.prepareStatement(sql.toString())) {
    for (int i = 0; i < params.size(); i++) ps.setObject(i + 1, params.get(i));
    ...
}

確認の手順（チェックリスト）

よくある質問

Q. JDBC で MySQL につなぐ基本の書き方は。 A. 既存の記事「Java JDBCでMySQL接続｜PreparedStatementとCRUD」で扱っています。

Q. ドライバ自体が見つからないエラーは。 A. 関連記事の「No suitable driver foundの原因と直し方｜Java JDBC」で扱っています。

まとめ

• set の番号が、SQL の ? の数と合っていないエラー
• 番号は 1 から。0 から数えるとエラー
• '?'・LIKE '%?%' は ? にならない。% は値の側に付ける
• PostgreSQL のドライバは The column index is out of range と表示し、get の間違いでも同じ文
• 条件で ? が増える SQL は、パラメータをリストで管理する

参考・出典

確認日はいずれも 2026年10月11日です。

• Java SE 21 API「PreparedStatement」：https://docs.oracle.com/en/java/javase/21/docs/api/java.sql/java/sql/PreparedStatement.html
• MySQL Bugs「Bug #117294 Updatable ResultSet fails with 'Parameter index out of range'」：https://bugs.mysql.com/bug.php?id=117294

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