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


SQL文字列連結は、コード量が少なく、テストデータでは動くため混入しやすい問題です。しかし、入力値がSQLの一部として解釈されると、検索条件を変えられたり、想定以上の行を取得・更新したりする可能性があります。
「画面のプルダウンだから安全」「ログイン後だけだから安全」ではありません。改修で入力経路が増えることもあり、内部利用者の誤入力でも構文エラーになります。値をSQLから分離することを実装ルールにします。
この記事のポイント
- 入力値をSQLへ文字列連結しない
- 値はプレースホルダーとバインド変数で渡す
- エスケープ処理の自作を対策にしない
- ORDER BY列などの識別子は許可リストから選ぶ
- 正常値だけでなく引用符や境界値もテストする
Xのコードレビュー画像で問題点を確認する

画像はレビュー対象の元の断片です。次の配布用不良例は、修正版と同じ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条件そのものを変更される可能性があります。

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());
}
}| テスト | 渡す値 | 確認する結果 |
|---|---|---|
| S01 | Alice | 連結版・バインド版ともU002 |
| S02 | O'Brien | 連結版はSQL例外、バインド版はU001 |
| S03 | ' OR '1'='1 | 連結版5件、バインド版0件 |
| S04 | 同じ引用符・条件式を生JDBCへ | U001・0件 |
| S05〜S06 | ACTIVE/2026-05-02、条件式風status | 位置指定と名前付きとも3件、条件式風は0件 |
| S07〜S11 | Brien / % / _ / 条件式風 / 空文字 | 部分一致1件 / 5件 / 5件 / 0件 / LIKE5件 |
| S12 | 64文字を保存、未登録の65文字を検索 | 64文字はU006、65文字は0件 |
| S13〜S14 | name・createdAt、不明値/null | 固定列の指定順、不明値/nullはid順 |
| S15〜S16 | 重複/未登録ID、空List | U001/U003だけ、空は0件かつ接続取得0 |
| S17 | null8入力 | NullPointerException、接続取得0 |
| S18〜S19 | 未知status/最終日翌日、生JDBCのnull | 0件、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版
動くSQLの先にある、設計上の失敗パターンを知る。
テーブル設計やクエリで繰り返される問題を、原因と改善策から学べます。基礎SQLを終えた後の一冊です。
- SQLレビューの観点を増やしたい
- DB設計の失敗例から学びたい
当サイトはAmazonアソシエイト・プログラムの参加者です。価格・在庫・配送条件はAmazonでご確認ください。
この記事とあわせて読みたい
まとめ
入力値をSQLへ文字列連結すると、通常の引用符でも構文が壊れ、入力がSQL構造として解釈されるSQLインジェクションの原因になります。
値はPreparedStatement、JdbcTemplate、NamedParameterJdbcTemplateのプレースホルダーへ渡します。列名などプレースホルダーにできない部分は許可リストから選び、特殊文字と境界値を含むテストで安全な契約を確認しましょう。



