如何在MyBatis映射文件中正确使用foreach标签防止SQL注入?

梦敏小哥_9357

梦敏小哥_9357

2026-06-29

354人浏览

原创

mybatis的foreach标签本身不防sql注入,真正起防护作用的是循环体内使用的#{item}预编译机制;若混用${item}拼接字符串,即使仅一处也会导致整条sql失去防护,且空集合或collection名称不匹配将引发语法错误或bindingexception。

如何在mybatis映射文件中正确使用foreach标签防止sql注入?

foreach标签本身不防注入,安全靠#{item}预编译

MyBatis 的 foreach 标签只是生成 (?, ?, ?) 这类占位符结构的语法糖,它不校验、不转义、不拦截输入。真正防注入的是你在循环体内写的 #{id} —— 它触发 PreparedStatement 对每个元素单独绑定,数据库只把值当数据处理。

常见翻车点:<foreach collection="ids" item="id">#{id} OR id = ${id}</foreach>,后半句 ${id} 直接拼字符串,哪怕只有一处,整条 SQL 就失去防护。

  • 传入 List<string></string> 做模糊关键词搜索,必须每个都走 #{keyword},不能因为“是集合”就放松对单个元素的信任
  • CONCAT('%', #{kw}, '%') 是安全的;CONCAT('%', ${kw}, '%') 是高危的,哪怕 kw 来自 foreach 内部
  • 如果业务需要动态字段名(如 ORDER BY ${sortField}),foreach 无能为力,必须用白名单校验,和 foreach 安全机制无关

collection 和 item 必须严格匹配参数命名与类型

配错 collection 或 item 不会导致注入,但会让 SQL 生成失败或查出空结果,属于运行时错误,不是安全漏洞。

典型错误现象:BindingException: Parameter 'xxx' not found,或日志里出现 IN () 空括号。

彩云小梦
彩云小梦

彩云小梦是一款AI文本写作工具,Caiyun Technology 推出的智能 AI 故事写作工具。

下载
  • 接口方法是 UserMapper.selectByIds(@Param("userIds") List<long> ids)</long> → XML 中 collection="userIds",不是 "list" 或 "ids"
  • 传入的是数组 Long[],没加 @Param → collection="array",不是 "list"
  • item="uid",但内部写 #{userId} → OGNL 找不到变量,报错
  • 遍历 List<string></string> 却写 #{uid.name} → 运行时报 ognl.MethodFailedException

空集合或 null 必须用 显式兜底

foreach 遇到 null 或空集合时默认不输出任何内容,这会导致 SQL 语法断裂,比如 WHERE id IN 后直接跟 AND status = 1,抛 SQLSyntaxErrorException。

这不是注入问题,但会让查询崩掉,而且容易被忽略——因为没报 BindingException,日志里也看不出明显异常。

  • 必须写 <if test="ids != null and !ids.isEmpty()"></if> 包裹整个 foreach 块
  • 不要用 ids.size() > 0 替代 !ids.isEmpty(),OGNL 在某些版本对空集合调用 size() 可能抛 NPE
  • <where></where> 标签可自动去除首段 AND,但不能替代空集合判断逻辑

IN 子句只能用 foreach,不能用 #{ids} 直接传集合

JDBC 的 PreparedStatement 不支持把整个集合塞进一个 ? 占位符,WHERE id IN (#{ids}) 会尝试调用 setObject(1, list),要么报错,要么语义错误(比如把 List.toString() 当字符串匹配)。

foreach 是唯一正确解法:它在 MyBatis 解析阶段就展开成多个 ?,再由 JDBC 分别绑定每个元素。

  • 正确:<foreach collection="ids" item="id" open="(" separator="," close=")">#{id}</foreach>
  • 错误:IN (#{ids})、IN #{ids}、IN (${ids})
  • 排序字段、表名、列名等标识符无法用 foreach 参数化,这些地方永远不能依赖用户输入,必须走白名单或配置驱动
实际最易被忽略的,是空集合时 SQL 语法断裂和 collection 名称与 Java 层传参方式的隐式耦合——这两处不出错不报警,但一出就是线上故障。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

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

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

2023.10.12

4283

8

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

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

2023.10.27

891

4

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

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

2024.02.23

1109

5

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

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

2024.03.06

6201

10

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

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

2024.03.06

3043

4

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

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

2024.04.07

6160

11

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

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

2024.04.29

8341

6

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

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

2024.04.29

1130

5

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

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

2024.04.29

992

5

热门下载

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

精品课程

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

共10课时 | 2.3万人学习