讲师中心 微信公众号
AI工具推荐 视频效率加速

MyBatis 3.x中动态SQL的foreach标签如何防止SQL注入?

酷晨同学_9450

酷晨同学_9450

发布时间:2026-06-16 14:12:24

|

721人浏览过

|

来源于php中文网

原创

MyBatis 的 foreach 标签本身不防注入,真正防注入的是坚持使用 #{item} 而非 ${item};空集合或 null 必须用 <if> 包裹,collection 值需严格匹配参数命名与包装方式。

mybatis 3.x中动态sql的foreach标签如何防止sql注入?

foreach 本身不防注入,防注入靠的是 #{}

MyBatis 的 foreach 标签本身不是“防注入工具”,它只是一个动态 SQL 遍历语法糖。真正防止 SQL 注入的,是你在 foreach 内部是否坚持用 #{item}——而不是 ${item} 或字符串拼接。

常见错误是以为用了 foreach 就安全了,结果写成:<foreach collection="ids" item="id">#{id} OR id = ${id}</foreach>,后半句 ${id} 直接把用户输入拼进 SQL,立刻引入注入风险。

  • foreach 只负责把集合展开成多个 #{} 占位符,底层仍是 PreparedStatement 批量绑定
  • 一旦混用 ${},哪怕只在一个 #{} 旁边加一个 ${item},整条 SQL 就失去防护
  • 传入的集合元素如果是用户可控字符串(比如前端传来的 String[] keywords),必须确保每个元素都走 #{},不能“信任”集合内容已清洗

collection 和 item 配错会导致 SQL 错误,但不等于注入

配错 collection 或 item 名,最常表现为 BindingException: Parameter 'xxx' not found 或生成空的 IN (),这类问题会报错或查不到数据,但不会导致注入——因为根本没生成有效 SQL,更谈不上执行恶意语句。

典型翻车点:

  • 接口方法参数是 @Param("userIds") List<Long> ids,XML 却写 collection="list" → 找不到 list,foreach 不执行
  • item="uid",但内部写 #{userId} → OGNL 找不到属性,抛 BindingException
  • 传入 List<String>,却在 #{uid.name} 访问属性 → 运行时报 ognl.MethodFailedException

空集合或 null 必须用 <if> 包裹,否则语法出错

foreach 遇到 null 或空集合时,什么也不输出。这会导致 SQL 语法断裂,比如 WHERE id IN 后面直接接 AND status = 1,数据库报错 SQLSyntaxErrorException。这不是注入,但会让查询崩掉。

正确写法是用 <if> 显式兜底:

<where>
  <if test="ids != null and !ids.isEmpty()">
    id IN <foreach collection="ids" item="id" open="(" separator="," close=")">#{id}</foreach>
  </if>
  <if test="status != null">AND status = #{status}</if>
</where>
  • 不要依赖 foreach 自带的空判断逻辑——它没有
  • test="ids != null and !ids.isEmpty()" 中的 !ids.isEmpty() 不能简写成 ids.size() > 0,MyBatis OGNL 对空集合的 size() 调用可能抛 NPE
  • 如果业务允许空集合查全表,需额外加 OR 1=1 分支,但要谨慎评估权限和性能

数组、Map、对象列表的 collection 值怎么写才不翻车

collection 的值不是凭经验猜的,它严格对应 Java 方法签名和参数包装方式。写错就找不到集合,foreach 彻底失效。

  • 单个 List<Long> 参数,没加 @Param → collection="list"
  • 单个 Long[] 参数,没加 @Param → collection="array"
  • @Param("ids") List<Long> ids → collection="ids"
  • 传入 Map: map.put("orderIds", list) → collection="orderIds"
  • 传入对象 UserQuery query,其中 query.getIds() 返回 List<Long> → collection="ids"(取 getter 名,去掉 get 和首字母小写)

最容易被忽略的是:泛型擦除后,MyBatis 看不到 List<String> 和 List<Long> 的区别,全靠你传参时类型一致、XML 里 #{} 用对——否则运行时报 OGNL 异常,不是编译期错误。

热门AI工具

更多
豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

火山引擎

火山引擎是一款面向企业的云计算与AI服务平台。

PixTV
PixTV Hot

PixTV是一款面向AIGC内容创作的AI视频生成工具。

咔片AIPPT

一款在线AI演示文稿制作工具,可根据主题和内容需求辅助生成PPT结构与页面,提高演示材料制作效率。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

UP简历
UP简历 Hot

一款AI办公效率工具,主要用于基于AI技术的免费在线简历制作工具,适合需要提升相关任务效率的用户。

Laper
Laper Hot

Laper是专为编剧、导演和制片人推出的 AI 原生剧本创作工具。

音述AI
音述AI Hot

一款AI音频处理工具,主要用于音述AI是一个以“用声音述说故事”为核心的 AI 音乐创作与声音分享社区,适合需要提升相关任务效率的用户。

相关专题

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

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

4163

2023.10.12

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

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

891

2023.10.27

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

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

1089

2024.02.23

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

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

6041

2024.03.06

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

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

2923

2024.03.06

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

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

6020

2024.04.07

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

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

8081

2024.04.29

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

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

1110

2024.04.29

PixTV官网入口地址合集
PixTV官网入口地址合集

本专题汇总了 PixTV AI 一站式视频创作平台的官方入口与使用教程。无需下载软件,浏览器直接访问即可使用。平台将剧本、图像、视频、声音与剪辑整合在“无限画布”中,接入 GPT Image 2.5、Seedance 2.5 等头部模型。本专题整理了从新建画布、角色锚定、分镜拆分到视频生成与导出的完整操作指南,助你快速上手 AI 短剧与漫剧创作。

20

2026.10.10

热门下载

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

精品课程

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

共10课时 | 2.3万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn