Spring Data JPA 的衍生查询(如 findByUsername)默认防 SQL 注入,因其在编译期解析方法名生成固定 JPQL,参数通过 PreparedStatement 的 setParameter() 绑定,不参与 SQL 拼接。

Spring Data JPA 的衍生查询(如 findByUsername、findAllByStatusAndRoleIn)默认就是防 SQL 注入的,无需额外处理。它不依赖你写 SQL 字符串,而是由框架在编译期解析方法名,生成固定结构的 JPQL,再交由 Hibernate 转为 PreparedStatement 执行——用户输入只进参数槽位,不参与 SQL 拼接。
衍生查询为什么不会被注入
- 方法签名中的参数(如
String username)全部走setParameter()绑定,底层调用的是setString()、setLong()等,不是字符串插值 - 查询结构(WHERE 字段、AND/OR 逻辑、IN 范围)由方法名决定,运行时不可变;
username的值永远不会变成列名或操作符 - 即使传入恶意字符串如
"admin' OR '1'='1",它也只会被当做一个普通字符串参数,最终等价于:WHERE u.username = 'admin'' OR ''1''=''1'
不会改变 SQL 语法树
哪些衍生查询写法是安全的
-
findByEmail(String email):单参数,安全 -
findByStatusAndRole(String status, String role):多参数 AND,安全 -
findByRoleIn(Collection<string> roles)</string>:集合参数自动展开为等长?占位符,安全 -
findByCreatedAtBetween(Date start, Date end):时间范围,安全 -
existsByUsername(String username):存在性判断,同样走参数绑定,安全
注意:Like 类型需谨慎——findByUsernameContaining(String keyword) 是安全的,但如果你手动拼 % 符号,必须确保 % 是硬编码,而非来自用户输入:
- ✅ 安全:
cb.like(root.get("name"), "%" + keyword + "%")(%写死在代码里) - ❌ 危险:
cb.like(root.get("name"), keyword)且用户传入"%admin% OR 1=1"——虽然仍不触发注入,但语义失控,属业务逻辑漏洞,非 SQL 注入
容易误以为“衍生查询也能破防”的场景
- 把衍生查询和
@Query混淆:有人写@Query("SELECT u FROM User u WHERE u.username = ?1")却误以为这是“衍生”,其实这是手写 JPQL,虽仍安全,但已脱离衍生机制 - 在 Service 层用
StringBuilder拼方法名再反射调用(如"findBy" + field + "AndStatus"),这不属于 Spring Data JPA 的衍生查询范畴,是自研动态调用,完全不安全 - 使用
ExampleMatcher或Example时传入未校验的字段名:虽然参数值仍安全,但字段名若来自用户(如前端传sortField=role;DROP TABLE user;),可能引发其他问题(如排序字段注入),这不是衍生查询的问题,而是你没校验字段白名单
真正需要警惕的从来不是衍生查询本身,而是你以为在用衍生查询,实际却绕开了它:比如用原生 SQL、字符串拼接、SpEL 表达式、动态表名/排序方向,或者把用户输入当字段名用。这些行为和 findByXXX 没半点关系,别让它背锅。

















