JdbcTemplate通过参数化查询(PreparedStatement)防止SQL注入,核心是用“?”占位符配合参数数组或命名参数Map,由JDBC驱动自动转义绑定,杜绝字符串拼接;但动态表名、列名等SQL结构需白名单校验。

在Java中使用JdbcTemplate实现参数化查询,是防止SQL注入最直接有效的方式。核心在于绝不拼接SQL字符串,而是通过占位符(?)配合参数数组或对象,由JDBC驱动自动转义和绑定值。
使用?占位符 + 参数数组
这是最基础、最安全的写法。JdbcTemplate会将参数原样传给PreparedStatement,数据库底层完成类型检查与特殊字符转义。
- SQL语句中所有动态值都用
?代替,不能出现在表名、列名、排序字段等位置 - 参数顺序必须严格对应
?出现的顺序 - 支持基本类型、String、Date、BigDecimal等,也支持
null(需指定类型)
String sql = "SELECT * FROM user WHERE status = ? AND age > ?";
List<User> users = jdbcTemplate.query(sql,
new BeanPropertyRowMapper<>(User.class),
"ACTIVE", 18);使用命名参数(NamedParameterJdbcTemplate)
比问号更易读、可复用、支持同名参数多次出现,适合复杂查询。
- 用
:paramName代替?,参数用Map<string object></string>或自定义类传入 - 推荐用
BeanPropertySqlParameterSource从对象自动映射,避免手写Map - 不支持动态表名/列名——这些仍需白名单校验或硬编码
String sql = "SELECT * FROM user WHERE name LIKE :namePattern AND dept_id = :deptId";
Map<String, Object> params = Map.of("namePattern", "%张%", "deptId", 101);
List<User> users = namedJdbcTemplate.query(sql, params, new BeanPropertyRowMapper<>(User.class));批量操作也必须参数化
批量插入、更新同样要避免循环拼SQL。JdbcTemplate提供专门方法,内部仍走PreparedStatement批处理。
立即学习“Java免费学习笔记(深入)”;
- 用
batchUpdate(String sql, List<object> batchArgs)</object>,每个数组是一组参数 - 或用
BatchPreparedStatementSetter精细控制每条语句的参数设置逻辑 - 即使数据来自用户输入,只要进的是参数列表,就不会触发注入
String sql = "INSERT INTO log (msg, level) VALUES (?, ?)";
List<Object[]> batch = Arrays.asList(
new Object[]{"login success", "INFO"},
new Object[]{"failed attempt", "WARN"}
);
jdbcTemplate.batchUpdate(sql, batch);哪些地方仍需额外防护?
参数化只保护“值”,不保护SQL结构本身。以下场景需配合其他手段:
- 动态表名/列名/ORDER BY字段:只能通过白名单校验(如枚举限定可选字段),不可直接拼接
-
IN子句变长参数:不能写
WHERE id IN (?),需动态生成对应数量的?,再传入参数列表 -
LIKE模糊匹配:通配符(
%、_)应由代码加在参数值里,而非SQL中拼接
String ids = String.join(",", Collections.nCopies(paramIds.size(), "?"));
String sql = "SELECT * FROM user WHERE id IN (" + ids + ")";
jdbcTemplate.query(sql, new BeanPropertyRowMapper<>(User.class), paramIds.toArray());


















