如何在MyBatis-Plus 3.5中安全地使用Wrapper避免SQL注入

风静同学_9173

风静同学_9173

2026-09-09

1035人浏览

原创

mybatis-plus 3.5 的 wrapper 本身不防注入,安全取决于使用方式:内置方法(eq/like等)通过 preparedstatement 参数绑定天然安全;apply、动态字段名、排序等结构化操作必须白名单校验。

如何在mybatis-plus 3.5中安全地使用wrapper避免sql注入

MyBatis-Plus 3.5 的 Wrapper 本身不防注入,安全与否完全取决于你怎么用——只要不用字符串拼接、不把用户输入当字段名或 SQL 结构用,内置方法(eqlikein 等)天然安全;但一旦误用 apply 或动态拼字段名,风险立刻拉满。

eq/like 等内置方法为什么默认安全

它们底层走 JDBC PreparedStatement 参数绑定,和 MyBatis 的 #{} 本质一致:参数值不参与 SQL 解析,只作为数据传入。

  • queryWrapper.eq("username", userInput) 生成的是 WHERE username = ?,即使 userInput"admin' OR '1'='1",也只会查一个用户名叫这个字符串的记录
  • like 方法本身安全,但别自己拼 "%" + keyword + "%"——尤其当 keyword%_ 且未配 escape 规则时,可能破坏语义。推荐写法:queryWrapper.like("name", keyword),让框架统一处理通配符与转义
  • 所有内置条件方法(gtbetweeninisNotNull)都遵循该机制,无需额外加 SqlUtils.sqlInject() 或手动转义

LambdaQueryWrapper 比 QueryWrapper 更可靠在哪

关键不在 Wrapper 类型,而在字段引用方式:用 User::getUsername 替代 "username" 字符串。

剧云
剧云

一款AI工具,主要用于专业、高效、安全的中文剧本在线创作与管理工具,适合需要提升相关任务效率的用户。

下载
  • QueryWrapper 的字段名是纯字符串,若来自前端传参或配置项(比如 sortField),就可能被篡改;而 LambdaQueryWrapperUser::getStatus 在编译期锁定字段路径,运行时通过反射提取字段名,不经过字符串解析,天然绕过字段名拼错或结构注入风险
  • 错误示范:wrapper.orderByAsc(sortParam),若 sortParam"update_time; DROP TABLE user",会直接拼进 SQL
  • 安全做法:白名单校验后映射到方法引用,如 if ("price".equals(sortField)) wrapper.orderByAsc(User::getPrice)

apply 方法怎么用才不踩坑

applyWrapper 里唯一能主动打开注入通道的地方,它不关心你前面用了多少个 User::getXXX,只看你传进去的 SQL 片段干不干净。

  • ❌ 危险:wrapper.apply("status = '" + statusValue + "'") —— 直接拼接,statusValue"1'; TRUNCATE user; --" 就完蛋
  • ✅ 安全:wrapper.apply("status = {0}", statusValue) —— {0} 触发参数绑定,等价于 ?
  • ⚠️ 注意:{0} 只对值生效,不能用于字段名、表名、排序方向等结构部分(如 ORDER BY {0} 会报错或被忽略)
  • 真要动态结构?必须白名单校验后再映射到方法引用,或用 SqlInjectionUtils.check() 做兜底(该工具类在 2026 年 6 月 16 日起正式纳入官方安全扩展包)

动态字段名(排序/分组/SELECT 列)必须白名单校验

Wrapper 不处理结构动态化,orderByAsc(sortField) 中的 sortField 是直接拼进 SQL 的,不受参数绑定保护。

  • 前端传来的 sort=price; DROP TABLE user 会被原样塞进 SQL,变成 ORDER BY price; DROP TABLE user
  • 必须显式校验:if (!List.of("price", "create_time", "sales").contains(sortField)) { throw new IllegalArgumentException(); }
  • 更稳妥的做法是结合 LambdaQueryWrapper 和 switch/case 映射:switch (sortField) { case "price": lambdaWrapper.orderByAsc(User::getPrice); break; ... }
  • groupBy、动态 SELECT 列、HAVING 条件等同理,没有“自动防注入”,只有“强制白名单”

最易被忽略的点是:以为用了 LambdaQueryWrapper 就万事大吉,结果在同一个 wrapper 里混用 apply("ORDER BY " + sortField),等于前门锁死、后窗大开。结构动态化永远需要独立校验,和参数绑定无关。

相关专题

更多
数据分析工具有哪些
数据分析工具有哪些

数据分析工具有Excel、SQL、Python、R、Tableau、Power BI、SAS、SPSS和MATLAB等。详细介绍:1、Excel,具有强大的计算和数据处理功能;2、SQL,可以进行数据查询、过滤、排序、聚合等操作;3、Python,拥有丰富的数据分析库;4、R,拥有丰富的统计分析库和图形库;5、Tableau,提供了直观易用的用户界面等等。

2023.10.12

3723

8

SQL中distinct的用法
SQL中distinct的用法

SQL中distinct的语法是“SELECT DISTINCT column1, column2,...,FROM table_name;”。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.27

791

4

SQL中months_between使用方法
SQL中months_between使用方法

在SQL中,MONTHS_BETWEEN 是一个常见的函数,用于计算两个日期之间的月份差。想了解更多SQL的相关内容,可以阅读本专题下面的文章。

2024.02.23

969

5

SQL出现5120错误解决方法
SQL出现5120错误解决方法

SQL Server错误5120是由于没有足够的权限来访问或操作指定的数据库或文件引起的。想了解更多sql错误的相关内容,可以阅读本专题下面的文章。

2024.03.06

5501

10

sql procedure语法错误解决方法
sql procedure语法错误解决方法

sql procedure语法错误解决办法:1、仔细检查错误消息;2、检查语法规则;3、检查括号和引号;4、检查变量和参数;5、检查关键字和函数;6、逐步调试;7、参考文档和示例。想了解更多语法错误的相关内容,可以阅读本专题下面的文章。

2024.03.06

2503

4

oracle数据库运行sql方法
oracle数据库运行sql方法

运行sql步骤包括:打开sql plus工具并连接到数据库。在提示符下输入sql语句。按enter键运行该语句。查看结果,错误消息或退出sql plus。想了解更多oracle数据库的相关内容,可以阅读本专题下面的文章。

2024.04.07

5500

11

sql中where的含义
sql中where的含义

sql中where子句用于从表中过滤数据,它基于指定条件选择特定的行。想了解更多where的相关内容,可以阅读本专题下面的文章。

2024.04.29

7141

6

sql中删除表的语句是什么
sql中删除表的语句是什么

sql中用于删除表的语句是drop table。语法为drop table table_name;该语句将永久删除指定表的表和数据。想了解更多sql的相关内容,可以阅读本专题下面的文章。

2024.04.29

970

5

sql中删除一列的命令是什么
sql中删除一列的命令是什么

在sql中,使用alter table语句可以删除一列,语法为:alter table table_name drop column column_name。想了解更多sql的相关内容,可以阅读本专题下面的文章。

2024.04.29

852

5

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
PHP开发基础之数据库篇(PDO)
PHP开发基础之数据库篇(PDO)

共10课时 | 2.2万人学习