Javaで入力値をSQLへ文字列連結する危険とプレースホルダー対策を解説する記事のアイキャッチ。

実装・エラー解決

JavaのSQL文字列連結を直す|引用符で壊れる原因とバインドの実行例

AIによる要約

利用者の入力値をSQL文字列へ直接連結すると、引用符を含む名前でSQLが壊れるだけでなく、入力がSQL構造として解釈されるSQLインジェクションの原因になります。値はPreparedStatementやJdbcTemplateの?、NamedParameterJdbcTemplateの名前付きパラメータへ渡し、SQLとデータを分離します。ただしテーブル名やORDER BY列などの識別子はプレースホルダー化できないため、許可リストから選びます。

新人SE
新人SE
検索画面の名前をSQLへ連結しただけです。社内システムでも直す必要がありますか?
ポンコツSE
ポンコツSE
必要です。悪意がなくても、アポストロフィを含む値でSQLが壊れます。入力経路に関係なく値はプレースホルダーへ分離します。

SQL文字列連結は、コード量が少なく、テストデータでは動くため混入しやすい問題です。しかし、入力値がSQLの一部として解釈されると、検索条件を変えられたり、想定以上の行を取得・更新したりする可能性があります。

「画面のプルダウンだから安全」「ログイン後だけだから安全」ではありません。改修で入力経路が増えることもあり、内部利用者の誤入力でも構文エラーになります。値をSQLから分離することを実装ルールにします。

この記事のポイント

  • 入力値をSQLへ文字列連結しない
  • 値はプレースホルダーとバインド変数で渡す
  • エスケープ処理の自作を対策にしない
  • ORDER BY列などの識別子は許可リストから選ぶ
  • 正常値だけでなく引用符や境界値もテストする

Xのコードレビュー画像で問題点を確認する

利用者のnameをSELECT文へ文字列連結したJavaコードを示すAI生成コードのレビュー画像。
入力値nameがSQL文字列へ直接埋め込まれています。

画像はレビュー対象の元の断片です。次の配布用不良例は、修正版と同じid/name/emailを返せるよう列を揃えました。UnsafeUserRepositoryはローカル比較だけに使う意図的な不良例です。業務データや外部システムへ接続して試さないでください。

src/main/java/info/syachiku/sqlbinding/UnsafeUserRepository.javaのfindByNameを抜粋しています。

    public List<User> findByName(String name) {
        Objects.requireNonNull(name, "name");
        String sql = "SELECT id, name, email FROM users "
                + "WHERE name = '" + name + "' ORDER BY id";
        return jdbcTemplate.query(sql, UserRepository.USER_MAPPER);
    }

nameがAliceなら動きます。しかし値に'が含まれるとクォートの対応が崩れます。さらに、SQLの構文になる文字列を渡されると、WHERE条件そのものを変更される可能性があります。

JdbcTemplateのSQLへ疑問符プレースホルダーを使い、nameをバインド値として渡す修正版画像。
SQLには?を置き、nameは別の値としてJdbcTemplateへ渡します。

XのBefore投稿とAfter投稿も参照できます。

文字列連結が危険な2つの理由

通常の入力でもSQLが壊れる

人名、商品名、備考にはアポストロフィや記号が入ることがあります。利用者に攻撃意図がなくても、SQL文字列とデータの境界が崩れ、構文エラーになります。

この問題を「特定文字を置換する」で直すと、DB製品、文字コード、エスケープ規則、入力経路の違いを自前で管理することになります。値はドライバへ渡し、適切な方法でバインドさせます。

入力がSQL構造として解釈される

値を連結すると、入力文字列が単なる名前ではなく、演算子や条件式としてSQLへ混ざる可能性があります。これがSQLインジェクションです。SELECTだけでなく、UPDATEやDELETEで起これば影響行数が拡大します。

社内システムでも入力値を信用しない

入力元は画面だけとは限りません。CSV、外部API、バッチ引数、移行データ、別システムからの連携値もあります。将来の改修で境界が変わっても安全な実装にします。

JdbcTemplateでは?プレースホルダーを使う

src/main/java/info/syachiku/sqlbinding/UserRepository.javaのfindByNameを抜粋しています。

    public List<User> findByName(String name) {
        Objects.requireNonNull(name, "name");
        String sql = """
                SELECT id, name, email FROM users
                WHERE name = ? ORDER BY id
                """;
        return jdbcTemplate.query(sql, USER_MAPPER, name);
    }

配布のUserRepositoryはDataSourceをコンストラクタで受け取り、同じDBへ位置指定と名前付きの両方でアクセスします。全検索がid/name/emailの3列を返すため、共通のUSER_MAPPERが存在しない列を読んで失敗する例にはなっていません。全文と接続・初期データを次に示します。

UserRepository.javaの全文:接続先・行の読取り・各検索
package info.syachiku.sqlbinding;

import java.sql.Date;
import java.time.LocalDate;
import java.util.List;
import java.util.Objects;
import javax.sql.DataSource;
import org.springframework.jdbc.core.JdbcTemplate;
import org.springframework.jdbc.core.RowMapper;
import org.springframework.jdbc.core.namedparam.MapSqlParameterSource;
import org.springframework.jdbc.core.namedparam.NamedParameterJdbcTemplate;

public class UserRepository {
    static final RowMapper<User> USER_MAPPER = (rs, rowNum) -> new User(
            rs.getString("id"), rs.getString("name"), rs.getString("email"));

    private final JdbcTemplate jdbcTemplate;
    private final NamedParameterJdbcTemplate namedParameterJdbcTemplate;

    public UserRepository(DataSource dataSource) {
        this.jdbcTemplate = new JdbcTemplate(dataSource);
        this.namedParameterJdbcTemplate = new NamedParameterJdbcTemplate(dataSource);
    }

    public List<User> findByName(String name) {
        Objects.requireNonNull(name, "name");
        String sql = """
                SELECT id, name, email FROM users
                WHERE name = ? ORDER BY id
                """;
        return jdbcTemplate.query(sql, USER_MAPPER, name);
    }

    public List<User> findByStatusFrom(String status, LocalDate from) {
        Objects.requireNonNull(status, "status");
        Objects.requireNonNull(from, "from");
        String sql = """
                SELECT id, name, email FROM users
                WHERE status = ? AND created_at >= ? ORDER BY id
                """;
        return jdbcTemplate.query(sql, USER_MAPPER, status, Date.valueOf(from));
    }

    public List<User> findByStatusFromNamed(String status, LocalDate from) {
        Objects.requireNonNull(status, "status");
        Objects.requireNonNull(from, "from");
        String sql = """
                SELECT id, name, email FROM users
                WHERE status = :status AND created_at >= :from ORDER BY id
                """;
        MapSqlParameterSource params = new MapSqlParameterSource()
                .addValue("status", status)
                .addValue("from", Date.valueOf(from));
        return namedParameterJdbcTemplate.query(sql, params, USER_MAPPER);
    }

    public List<User> findByNameLike(String keyword) {
        Objects.requireNonNull(keyword, "keyword");
        String sql = """
                SELECT id, name, email FROM users
                WHERE name LIKE ? ORDER BY id
                """;
        String pattern = "%" + keyword + "%";
        return jdbcTemplate.query(sql, USER_MAPPER, pattern);
    }

    public List<User> findAllSorted(String sortKey, boolean ascending) {
        String orderBy = switch (sortKey == null ? "" : sortKey) {
            case "name" -> "name";
            case "createdAt" -> "created_at";
            default -> "id";
        };
        String direction = ascending ? "ASC" : "DESC";
        String sql = """
                SELECT id, name, email FROM users
                ORDER BY %s %s, id ASC
                """.formatted(orderBy, direction);
        return jdbcTemplate.query(sql, USER_MAPPER);
    }

    public List<User> findByIds(List<String> userIds) {
        Objects.requireNonNull(userIds, "userIds");
        userIds.forEach(id -> Objects.requireNonNull(id, "id"));
        if (userIds.isEmpty()) {
            return List.of();
        }
        String sql = """
                SELECT id, name, email FROM users
                WHERE id IN (:ids) ORDER BY id
                """;
        MapSqlParameterSource params = new MapSqlParameterSource("ids", userIds);
        return namedParameterJdbcTemplate.query(sql, params, USER_MAPPER);
    }
}
User.javaの全文:id/name/emailの受け皿
package info.syachiku.sqlbinding;

public record User(String id, String name, String email) {
}
SampleDatabase.javaの全文:H2と初期データを用意する
package info.syachiku.sqlbinding;

import java.util.UUID;
import javax.sql.DataSource;
import org.springframework.core.io.ClassPathResource;
import org.springframework.jdbc.datasource.DriverManagerDataSource;
import org.springframework.jdbc.datasource.init.ResourceDatabasePopulator;

public final class SampleDatabase {
    private SampleDatabase() {
    }

    public static DataSource create() {
        DriverManagerDataSource dataSource = new DriverManagerDataSource(
                "jdbc:h2:mem:sample_" + UUID.randomUUID() + ";DB_CLOSE_DELAY=-1", "sa", "");
        dataSource.setDriverClassName("org.h2.Driver");
        new ResourceDatabasePopulator(new ClassPathResource("schema.sql"),
                new ClassPathResource("data.sql")).execute(dataSource);
        return dataSource;
    }
}
schema.sqlの全文:表の列と型
CREATE TABLE users (
    id VARCHAR(10) PRIMARY KEY,
    name VARCHAR(64) NOT NULL,
    email VARCHAR(255) NOT NULL,
    status VARCHAR(16) NOT NULL,
    created_at DATE NOT NULL
);
data.sqlの全文:5行の架空データ
INSERT INTO users (id, name, email, status, created_at) VALUES
('U001', 'O''Brien', 'obrien@example.invalid', 'ACTIVE', DATE '2026-05-01'),
('U002', 'Alice', 'alice@example.invalid', 'ACTIVE', DATE '2026-05-02'),
('U003', 'Cara', 'cara@example.invalid', 'INACTIVE', DATE '2026-04-30'),
('U004', '100%Real', 'percent@example.invalid', 'ACTIVE', DATE '2026-05-03'),
('U005', 'A_B', 'underscore@example.invalid', 'ACTIVE', DATE '2026-05-04');
pom.xmlの全文:検証した依存の版とJUnit設定
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
  <modelVersion>4.0.0</modelVersion>
  <groupId>info.syachiku.samples</groupId><artifactId>sql-binding-1877</artifactId><version>1.0.0</version>
  <properties><maven.compiler.release>17</maven.compiler.release><project.build.sourceEncoding>UTF-8</project.build.sourceEncoding></properties>
  <dependencies>
    <dependency><groupId>org.springframework</groupId><artifactId>spring-jdbc</artifactId><version>6.2.19</version></dependency>
    <dependency><groupId>com.h2database</groupId><artifactId>h2</artifactId><version>2.3.232</version><scope>runtime</scope></dependency>
    <dependency><groupId>org.junit.jupiter</groupId><artifactId>junit-jupiter</artifactId><version>5.12.2</version><scope>test</scope></dependency>
  </dependencies>
  <build><plugins>
    <plugin><groupId>org.apache.maven.plugins</groupId><artifactId>maven-resources-plugin</artifactId><version>3.3.1</version></plugin>
    <plugin><groupId>org.apache.maven.plugins</groupId><artifactId>maven-compiler-plugin</artifactId><version>3.14.0</version></plugin>
    <plugin><groupId>org.apache.maven.plugins</groupId><artifactId>maven-surefire-plugin</artifactId><version>3.5.3</version></plugin>
  </plugins></build>
</project>

この教材のUserはrecordなので、IDの読み取りはuser.id()です。U001はO'Brien、U002はAlice、U003はCara、U004は100%Real、U005はA_Bです。nameをSQLに埋めず、SQL文字列を第1引数、USER_MAPPERを第2引数、値を第3引数へ渡している点を見てください。

SQL本体には?を置き、値はqueryの引数として渡します。JDBCドライバはSQL構造と値を分けて扱うため、name内の文字がWHERE句の構造として実行されません。

複数条件では、?の順序と引数の順序を揃えます。

src/main/java/info/syachiku/sqlbinding/UserRepository.javaのfindByStatusFromを抜粋しています。

    public List<User> findByStatusFrom(String status, LocalDate from) {
        Objects.requireNonNull(status, "status");
        Objects.requireNonNull(from, "from");
        String sql = """
                SELECT id, name, email FROM users
                WHERE status = ? AND created_at >= ? ORDER BY id
                """;
        return jdbcTemplate.query(sql, USER_MAPPER, status, Date.valueOf(from));
    }

statusは文字列、fromはLocalDateです。DATE列に対し>=なので指定当日も含み、Date.valueOf(from)でSQLの日付型へ渡します。ACTIVEと2026-05-02ならU002・U004・U005の3件です。不明な状態は0件、nullはDB接続前に拒否します。

PreparedStatementでも値をバインドする

src/main/java/info/syachiku/sqlbinding/PlainJdbcUserRepository.javaの全文です。接続を受け取るところから、結果3列をUserへ読み取って閉じるところまで含めています。

package info.syachiku.sqlbinding;

import java.sql.Connection;
import java.sql.PreparedStatement;
import java.sql.ResultSet;
import java.sql.SQLException;
import java.util.ArrayList;
import java.util.List;
import java.util.Objects;
import javax.sql.DataSource;

public class PlainJdbcUserRepository {
    private final DataSource dataSource;

    public PlainJdbcUserRepository(DataSource dataSource) {
        this.dataSource = dataSource;
    }

    public List<User> findByName(String name) throws SQLException {
        Objects.requireNonNull(name, "name");
        String sql = """
                SELECT id, name, email FROM users
                WHERE name = ? ORDER BY id
                """;
        List<User> users = new ArrayList<>();
        try (Connection connection = dataSource.getConnection();
             PreparedStatement statement = connection.prepareStatement(sql)) {
            statement.setString(1, name);
            try (ResultSet resultSet = statement.executeQuery()) {
                while (resultSet.next()) {
                    users.add(new User(resultSet.getString("id"),
                            resultSet.getString("name"), resultSet.getString("email")));
                }
            }
        }
        return users;
    }
}

JDBCを直接使う場合も同じです。PreparedStatementへSQLと値を別々に渡します。文字列だけでなく数値、日付、booleanも対応するsetメソッドで設定します。

名前付きパラメータで条件を読みやすくする

src/main/java/info/syachiku/sqlbinding/UserRepository.javaのfindByStatusFromNamedを抜粋しています。

    public List<User> findByStatusFromNamed(String status, LocalDate from) {
        Objects.requireNonNull(status, "status");
        Objects.requireNonNull(from, "from");
        String sql = """
                SELECT id, name, email FROM users
                WHERE status = :status AND created_at >= :from ORDER BY id
                """;
        MapSqlParameterSource params = new MapSqlParameterSource()
                .addValue("status", status)
                .addValue("from", Date.valueOf(from));
        return namedParameterJdbcTemplate.query(sql, params, USER_MAPPER);
    }

条件が増えると?と引数順の対応を間違えやすくなります。NamedParameterJdbcTemplateなら、SQL上の名前とJava側の値を対応させられます。案件で採用済みの方式へ揃えてください。

LIKE検索でも値は連結しない

src/main/java/info/syachiku/sqlbinding/UserRepository.javaのfindByNameLikeを抜粋しています。

    public List<User> findByNameLike(String keyword) {
        Objects.requireNonNull(keyword, "keyword");
        String sql = """
                SELECT id, name, email FROM users
                WHERE name LIKE ? ORDER BY id
                """;
        String pattern = "%" + keyword + "%";
        return jdbcTemplate.query(sql, USER_MAPPER, pattern);
    }

このサンプルはワイルドカードを利用する部分一致です。BrienならU001だけ、%と_はそれぞれ全5行、空文字も%%となり全5行に一致します。A_Bは今回U005だけですが、ABCという行があればそれにも一致し得ます。「%という文字を含む名前だけ」を探す実装ではありません。バインドで防ぐSQL構造の変更と、検索範囲を広げるワイルドカードの仕様を混同しないでください。

%をJava側で値へ付けても、SQL構造自体は連結していません。ただし利用者が入力した%や_をワイルドカードとして扱うか、文字として検索するかは仕様です。文字扱いならDBに合ったエスケープとESCAPE句を共通処理で実装します。

ORDER BYの列名はプレースホルダーにできない

SELECT id, name
FROM users
ORDER BY ?

これは列名を値として渡せないことを説明するSQLです。採用したH2 2.3.232でnameをバインドすると、DataIntegrityViolationExceptionを観測しました。DBによっては値や定数として扱われるため、すべてのDBが同じ例外を返すという意味ではありません。列を切り替える実装には、次の固定候補を使います。

プレースホルダーは値を渡す仕組みです。列名、テーブル名、ASC・DESCなどのSQL識別子や構文は値としてバインドできません。画面からソート項目を受ける場合は、入力値をそのまま連結せず、許可リストへ変換します。

src/main/java/info/syachiku/sqlbinding/UserRepository.javaのfindAllSortedを抜粋しています。

    public List<User> findAllSorted(String sortKey, boolean ascending) {
        String orderBy = switch (sortKey == null ? "" : sortKey) {
            case "name" -> "name";
            case "createdAt" -> "created_at";
            default -> "id";
        };
        String direction = ascending ? "ASC" : "DESC";
        String sql = """
                SELECT id, name, email FROM users
                ORDER BY %s %s, id ASC
                """.formatted(orderBy, direction);
        return jdbcTemplate.query(sql, USER_MAPPER);
    }

sortKeyがnameならname列、createdAtならcreated_at列です。不明値とnullはid列へ戻し、方向はbooleanからASC/DESCだけを選びます。たとえばname DESC; DROP TABLE usersという値を渡しても、SQLへその文字列は入りません。テストではid昇順の5件が返ることを確認します。同じ値が並んだ場合は第2条件のid昇順で順番を固定しています。

連結・埋め込みしている文字列は、サーバー側で定義した候補だけです。利用者入力そのものはSQLへ入りません。項目が多い場合はenumで管理すると、画面値とDB列名の対応をまとめられます。

IN句はフレームワークの展開機能を使う

src/main/java/info/syachiku/sqlbinding/UserRepository.javaのfindByIdsを抜粋しています。

    public List<User> findByIds(List<String> userIds) {
        Objects.requireNonNull(userIds, "userIds");
        userIds.forEach(id -> Objects.requireNonNull(id, "id"));
        if (userIds.isEmpty()) {
            return List.of();
        }
        String sql = """
                SELECT id, name, email FROM users
                WHERE id IN (:ids) ORDER BY id
                """;
        MapSqlParameterSource params = new MapSqlParameterSource("ids", userIds);
        return namedParameterJdbcTemplate.query(sql, params, USER_MAPPER);
    }

ID一覧をカンマ区切り文字列へして連結しないでください。空Listの扱いはライブラリやDBで異なるため、0件なら検索せず空Listを返すなど、事前条件を決めます。

ログへ完成SQLを出そうとして連結しない

調査用に「値を埋め込んだSQL」を手作りすると、そのコードが実行用へ流用される危険があります。ログはSQLテンプレートと必要なパラメータを分け、個人情報や秘密情報を出さないようにします。

excerpts/logging.java.txtの説明用抜粋です。実案件の既存loggerへ書く例であり、今回の実行対象Javaファイルには含めません。

log.debug(
        "ユーザー検索を実行します status={}, from={}",
        status,
        from);

パスワード、トークン、全文の個人情報はログへ出しません。SQL調査はDataSource ProxyやDB側の監査機能など、案件標準の方法も確認します。

引用符と境界値を含むテストを書く

src/test/java/info/syachiku/sqlbinding/UserRepositoryTest.javaの全文です。S17だけはnull入力8種類を繰り返すため、S01〜S19で計26件になります。各ケースで独立した初期DBを作り、別テストのinsertを混ぜません。

UserRepositoryTest.javaの全文:入力・期待ID・例外・接続取得
package info.syachiku.sqlbinding;

import java.time.LocalDate;
import java.util.Arrays;
import java.util.List;
import java.util.function.Consumer;
import java.util.stream.Stream;
import javax.sql.DataSource;
import org.junit.jupiter.api.BeforeEach;
import org.junit.jupiter.api.Test;
import org.junit.jupiter.params.ParameterizedTest;
import org.junit.jupiter.params.provider.Arguments;
import org.junit.jupiter.params.provider.MethodSource;
import org.springframework.dao.DataAccessException;
import org.springframework.jdbc.core.JdbcTemplate;
import static org.junit.jupiter.api.Assertions.*;

class UserRepositoryTest {
    private DataSource database;
    private CountingDataSource counting;
    private UserRepository repository;

    @BeforeEach
    void setUp() {
        database = SampleDatabase.create();
        counting = new CountingDataSource(database);
        repository = new UserRepository(counting);
    }

    static List<String> ids(List<User> users) {
        return users.stream().map(User::id).toList();
    }

    @Test
    void S01_通常名は連結版もバインド版も同じ1行() {
        assertEquals(List.of("U002"), ids(new UnsafeUserRepository(database).findByName("Alice")));
        assertEquals(List.of("U002"), ids(repository.findByName("Alice")));
    }

    @Test
    void S02_引用符は連結版で例外となりバインド版はU001() {
        assertThrows(DataAccessException.class,
                () -> new UnsafeUserRepository(database).findByName("O'Brien"));
        assertEquals(List.of("U001"), ids(repository.findByName("O'Brien")));
        assertEquals("obrien@example.invalid", repository.findByName("O'Brien").get(0).email());
    }

    @Test
    void S03_条件式風入力は連結版で全5行となりバインド版は0行() {
        String input = "' OR '1'='1";
        assertEquals(List.of("U001", "U002", "U003", "U004", "U005"),
                ids(new UnsafeUserRepository(database).findByName(input)));
        assertTrue(repository.findByName(input).isEmpty());
    }

    @Test
    void S04_生JDBCも引用符と条件式を値として扱う() throws Exception {
        PlainJdbcUserRepository plain = new PlainJdbcUserRepository(counting);
        assertEquals(List.of("U001"), ids(plain.findByName("O'Brien")));
        assertTrue(plain.findByName("' OR '1'='1").isEmpty());
    }

    @Test
    void S05_日付は境界当日を含み名前付き版も同じ3行() {
        LocalDate from = LocalDate.of(2026, 5, 2);
        List<String> expected = List.of("U002", "U004", "U005");
        assertEquals(expected, ids(repository.findByStatusFrom("ACTIVE", from)));
        assertEquals(expected, ids(repository.findByStatusFromNamed("ACTIVE", from)));
    }

    @Test
    void S06_名前付き条件へ渡した条件式風statusは0行() {
        assertTrue(repository.findByStatusFromNamed("' OR '1'='1", LocalDate.of(2026, 1, 1)).isEmpty());
    }

    @Test
    void S07_LIKEは部分一致として扱う() {
        assertEquals(List.of("U001"), ids(repository.findByNameLike("Brien")));
    }

    @Test
    void S08_LIKEのパーセントは全5行に一致する() {
        assertEquals(5, repository.findByNameLike("%").size());
    }

    @Test
    void S09_LIKEのアンダースコアもワイルドカードになる() {
        assertEquals(5, repository.findByNameLike("_").size());
        assertEquals(List.of("U005"), ids(repository.findByNameLike("A_B")));
    }

    @Test
    void S10_LIKEでも条件式風入力はSQL条件にならない() {
        assertTrue(repository.findByNameLike("' OR '1'='1").isEmpty());
    }

    @Test
    void S11_空文字は完全一致0行でLIKE全5行() {
        assertTrue(repository.findByName("").isEmpty());
        assertEquals(5, repository.findByNameLike("").size());
    }

    @Test
    void S12_名前列上限の64文字を保存して検索できる() {
        String name = "a".repeat(64);
        new JdbcTemplate(database).update("INSERT INTO users VALUES (?, ?, ?, ?, ?)",
                "U006", name, "long@example.invalid", "ACTIVE", java.sql.Date.valueOf("2026-05-05"));
        assertEquals(List.of("U006"), ids(repository.findByName(name)));
        assertTrue(repository.findByName("a".repeat(65)).isEmpty());
    }

    @Test
    void S13_列名nameとcreatedAtは固定候補で並べる() {
        assertEquals(List.of("U004", "U005", "U002", "U003", "U001"), ids(repository.findAllSorted("name", true)));
        assertEquals(List.of("U005", "U004", "U002", "U001", "U003"), ids(repository.findAllSorted("createdAt", false)));
    }

    @Test
    void S14_不明なソート値とnullはid順へ戻す() {
        List<String> expected = List.of("U001", "U002", "U003", "U004", "U005");
        assertEquals(expected, ids(repository.findAllSorted("name DESC; DROP TABLE users", true)));
        assertEquals(expected, ids(repository.findAllSorted(null, true)));
        assertEquals(List.of("U005", "U004", "U003", "U002", "U001"), ids(repository.findAllSorted("unknown", false)));
    }

    @Test
    void S15_INは重複IDと未登録IDを含めても2行() {
        assertEquals(List.of("U001", "U003"), ids(repository.findByIds(List.of("U003", "U001", "U001", "NONE"))));
    }

    @Test
    void S16_空INは空結果で接続取得も0回() {
        assertTrue(repository.findByIds(List.of()).isEmpty());
        assertEquals(0, counting.connectionRequests());
    }

    static Stream<Arguments> nullInputs() {
        return Stream.of(
                Arguments.of("name", (Consumer<UserRepository>) r -> r.findByName(null)),
                Arguments.of("keyword", (Consumer<UserRepository>) r -> r.findByNameLike(null)),
                Arguments.of("status", (Consumer<UserRepository>) r -> r.findByStatusFrom(null, LocalDate.of(2026, 5, 2))),
                Arguments.of("from", (Consumer<UserRepository>) r -> r.findByStatusFrom("ACTIVE", null)),
                Arguments.of("named status", (Consumer<UserRepository>) r -> r.findByStatusFromNamed(null, LocalDate.of(2026, 5, 2))),
                Arguments.of("named from", (Consumer<UserRepository>) r -> r.findByStatusFromNamed("ACTIVE", null)),
                Arguments.of("ids", (Consumer<UserRepository>) r -> r.findByIds(null)),
                Arguments.of("id element", (Consumer<UserRepository>) r -> r.findByIds(Arrays.asList("U001", null))));
    }

    @ParameterizedTest(name = "S17 null {0}")
    @MethodSource("nullInputs")
    void S17_null入力を接続前に拒否(String label, Consumer<UserRepository> action) {
        assertThrows(NullPointerException.class, () -> action.accept(repository));
        assertEquals(0, counting.connectionRequests());
    }

    @Test
    void S18_不明な状態と最終登録より後の日付は0行() {
        assertTrue(repository.findByStatusFrom("", LocalDate.of(2026, 1, 1)).isEmpty());
        assertTrue(repository.findByStatusFromNamed("UNKNOWN", LocalDate.of(2026, 1, 1)).isEmpty());
        assertTrue(repository.findByStatusFromNamed("ACTIVE", LocalDate.of(2026, 5, 5)).isEmpty());
    }

    @Test
    void S19_生JDBCもnull名を接続前に拒否() {
        PlainJdbcUserRepository plain = new PlainJdbcUserRepository(counting);
        assertThrows(NullPointerException.class, () -> plain.findByName(null));
        assertEquals(0, counting.connectionRequests());
    }
}
テスト渡す値確認する結果
S01Alice連結版・バインド版ともU002
S02O'Brien連結版はSQL例外、バインド版はU001
S03' OR '1'='1連結版5件、バインド版0件
S04同じ引用符・条件式を生JDBCへU001・0件
S05〜S06ACTIVE/2026-05-02、条件式風status位置指定と名前付きとも3件、条件式風は0件
S07〜S11Brien / % / _ / 条件式風 / 空文字部分一致1件 / 5件 / 5件 / 0件 / LIKE5件
S1264文字を保存、未登録の65文字を検索64文字はU006、65文字は0件
S13〜S14name・createdAt、不明値/null固定列の指定順、不明値/nullはid順
S15〜S16重複/未登録ID、空ListU001/U003だけ、空は0件かつ接続取得0
S17null8入力NullPointerException、接続取得0
S18〜S19未知status/最終日翌日、生JDBCのnull0件、nullは接続取得前に拒否

nullを空検索へ読み替えない契約です。name・keyword・status・from・ID一覧とその要素のnullは接続前に拒否します。一方で空文字や未知の状態を独自の入力エラーにはしていません。名前列の保存上限は64文字であり、検索入力の長さ制限を追加した例ではありません。

空結果だけでは「SQLを実行しなかった」証明になりません。S16では新しいCountingDataSourceから取得した接続が0回であることもassertしています。このRepositoryには別の接続経路がないため、ここでの接続取得0はSQL実行0も意味します。SQLの総数をどんな環境でも測る万能カウンターではありません。

CountingDataSource.javaの全文:空INが接続を取らないことを測る
package info.syachiku.sqlbinding;

import java.sql.Connection;
import java.sql.SQLException;
import javax.sql.DataSource;
import org.springframework.jdbc.datasource.AbstractDataSource;

// テスト補助。接続取得0なら、このDataSource経由のSQL実行も0です。
final class CountingDataSource extends AbstractDataSource {
    private final DataSource delegate;
    private int connectionRequests;

    CountingDataSource(DataSource delegate) {
        this.delegate = delegate;
    }

    int connectionRequests() {
        return connectionRequests;
    }

    @Override
    public Connection getConnection() throws SQLException {
        connectionRequests++;
        return delegate.getConnection();
    }

    @Override
    public Connection getConnection(String username, String password) throws SQLException {
        connectionRequests++;
        return delegate.getConnection(username, password);
    }
}

ZIPを展開した場所で全ケースを実行します。最初に3入力だけ比べる場合は2行目を使ってください。

mvn clean test
mvn test '-Dtest=UserRepositoryTest#S01*+S02*+S03*'

S01〜S03と同じデータを観測用補助クラスでも確認した結果です。全文はsrc/test/java/info/syachiku/sqlbinding/ComparisonRun.javaにあります。読者は直上の3ケースで同じ違いを検証できます。

input=Alice concat=[U002] bind=[U002]
input=O'Brien concat=BadSqlGrammarException bind=[U001]
input=' OR '1'='1 concat=[U001, U002, U003, U004, U005] bind=[]
[INFO] Tests run: 26, Failures: 0, Errors: 0, Skipped: 0

テストが不具合を見つけるかも、検証用コピーで試せます。findByNameのreturnを不良例と同じ連結へ変えてS02だけ実行すると、引用符の検索が例外で失敗します。findByIdsの空Listガードだけを削ってS16を実行すると、結果が空でも接続取得expected 0 / actual 1で失敗します。手順はREADMEにあり、最後は変更を戻して全26件を成功へ戻します。

通常の英数字だけでなく、引用符、空文字、null、長い文字列、LIKEの%・_、空のIN条件を確認します。セキュリティ試験だけに任せず、Repositoryの単体・結合テストへ正常な特殊文字を含めます。

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

// レビューコメント例
画面入力のnameをSQLへ直接連結しているため、
プレースホルダーで値をバインドしてください。

// レビューコメント例
独自のreplaceで引用符を逃がしていますが、
DBごとの差異と抜け漏れを避けるためPreparedStatementへ任せてください。

// レビューコメント例
sortKeyをORDER BYへ直接連結しています。
許可する列をenumまたはswitchでサーバー側から選んでください。

// レビューコメント例
IN句のID一覧を文字列化しています。
NamedParameterJdbcTemplateのList展開を使用してください。

提出前のセルフチェック

  • 入力値をSQL文字列へ連結していないか
  • 値をプレースホルダーで渡したか
  • 独自エスケープへ依存していないか
  • ORDER BY列を許可リストから選んだか
  • LIKEのワイルドカード仕様を決めたか
  • IN句の空Listを扱ったか
  • ログへ機密情報を出していないか
  • 引用符と境界値をテストしたか

SQLアンチパターンを体系的に学ぶ参考書

SQLインジェクション対策に加え、読みづらい動的SQLやデータ設計の問題をレビューできるようにするには、アンチパターンを事例から学ぶ方法が役立ちます。

『SQLアンチパターン 第2版』は、「連結を?へ置き換える」先で、どこまでをSQL構造に含めてよいか判断したい人に向きます。今回の疑問には第21章から読み、動的な値のパラメータ化、入力とコードの隔離、引用符内のパラメータの扱いを確認すると、ORDER BYの固定候補と検索値のバインドを分けて考えられます。

書籍「SQLアンチパターン 第2版」の表紙
商品画像:Amazon.co.jp
PR SQL基礎を終えた若手向け

SQLアンチパターン 第2版

Bill Karwin (著)

動くSQLの先にある、設計上の失敗パターンを知る。

テーブル設計やクエリで繰り返される問題を、原因と改善策から学べます。基礎SQLを終えた後の一冊です。

  • SQLレビューの観点を増やしたい
  • DB設計の失敗例から学びたい

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

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

関連記事Spring Data JPAのRepository戻り値|検索0件・1件・複数件の違い 検索結果の未存在と複数件を区別し、Serviceで業務上の扱いを決める例を確認します。 記事を読む 関連記事Spring Data JPAでSQLが大量に発行される原因|N+1問題の確認方法と対策 安全性だけでなく、発行SQL数と性能を確認する方法を学べます。 記事を読む 関連記事Javaのログレベルはどう使い分ける?INFO・WARN・ERRORの現場ルール SQL調査に必要な情報と、ログへ出してはいけない値を確認できます。 記事を読む

まとめ

入力値をSQLへ文字列連結すると、通常の引用符でも構文が壊れ、入力がSQL構造として解釈されるSQLインジェクションの原因になります。

値はPreparedStatement、JdbcTemplate、NamedParameterJdbcTemplateのプレースホルダーへ渡します。列名などプレースホルダーにできない部分は許可リストから選び、特殊文字と境界値を含むテストで安全な契約を確認しましょう。

-実装・エラー解決
-, ,