MyBatis 怎么处理特殊字符与模糊查询转义问题

落强姑娘_9554

落强姑娘_9554

2026-08-12

629人浏览

原创

mybatis模糊查询需处理_、%、等特殊字符的转义问题:可通过escape子句配合手动转义、改用locate/instr/position等无通配符函数、自定义拦截器统一处理,或前后端协同过滤实现安全匹配。

mybatis 怎么处理特殊字符与模糊查询转义问题

MyBatis 模糊查询中遇到 _、%、 等特殊字符时,会把它们当作通配符处理,导致查不到真实含这些字符的数据。比如用户搜“100%合格”,用 LIKE '%100%合格%' 实际匹配的是“任意开头 + 任意字符 + 合格 + 任意结尾”,根本不会命中字段里真正存着“100%合格”的记录。解决核心是:让数据库把特殊字符当普通文本,而不是通配符。

用 ESCAPE 显式声明转义符

在 SQL 中给 LIKE 加 ESCAPE 子句,指定一个转义字符(如 /),再对特殊字符前加该字符即可。MyBatis XML 写法示例:

  • WHERE name LIKE CONCAT('%', #{keyword}, '%') ESCAPE '/'
  • Java 传参前手动转义:keyword.replace("%", "/%").replace("_", "/_").replace("\", "\\");
  • 注意:ESCAPE 必须写在 LIKE 表达式之后、整个 WHERE 条件之前,且数据库需支持(MySQL、Oracle 都支持)

改用非 LIKE 的模糊函数

绕开 LIKE 本身,用字符串定位函数实现“包含”语义,天然不识别通配符:

OpenJDK 24
OpenJDK 24

OpenJDK 24 Windows x64 官方参考实现(24+36),适合 Windows 环境进行 Java 开发、编译、运行和版本兼容性验证。

下载
  • LOCATE(#{keyword}, column) > 0 —— MySQL,返回位置大于 0 即存在
  • INSTR(column, #{keyword}) > 0 —— 功能同 LOCATE,参数顺序相反
  • POSITION(#{keyword} IN column) > 0 —— 标准 SQL 写法,兼容性更好
  • 优点:无需转义、无通配符干扰;缺点:无法利用索引,大数据量时性能略低

自定义拦截器统一处理

适合中大型项目,避免每个 mapper 都手动处理。通过 MyBatis 拦截器扫描所有查询,自动识别 LIKE 条件并转义参数中的特殊字符:

  • 监听 Executor.query 方法,解析 BoundSql 获取原始 SQL 和参数
  • 匹配 SQL 中是否含 LIKE 关键字,并检查对应参数值是否含 %、_、
  • 对匹配到的参数值做预处理,例如:value.replaceAll("([%_\\])", "\\$1")
  • 配合 ESCAPE '\' 或使用 CONCAT 拼接,确保最终 SQL 安全执行

前端+后端协同过滤

简单场景下可从前端输入环节就控制,降低后端负担:

  • 表单提交前 JS 替换:input.replace(/([%_\])/g, '\$1'),再发请求
  • 后端接收后二次校验,对疑似恶意或含特殊字符的关键词打日志并告警
  • 搭配 MyBatis 的 #{} 占位符(非 ${}!),杜绝 SQL 注入风险

相关文章

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

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

下载

相关标签:

java

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

相关专题

更多
mybatis一级缓存和二级缓存
mybatis一级缓存和二级缓存

在MyBatis中,一级缓存和二级缓存是两种不同级别的缓存机制,它们都可以用来提高性能。本专题提供mybatis一级缓存和二级缓存相关文章,大家可以免费阅读。

2023.08.21

583

4

ibatis和mybatis有什么区别
ibatis和mybatis有什么区别

ibatis和mybatis的区别:1、基本信息不同;2、开发时间不同;3、功能与易用性;4、配置文件;5、入参类型与出参类型;6、返回结果集接受方式;7、语法差异;8、数据库方言支持;9、插件支持;10、社区活跃度;11、全球化支持。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.02.23

2542

5

mybatis如何配置数据库连接
mybatis如何配置数据库连接

mybatis配置数据库连接的方法:1、指定数据源;2、配置事务管理器;3、配置类型处理器和映射器;4、使用环境元素;5、配置别名。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.02.23

446

5

mybatis工作原理及流程是什么
mybatis工作原理及流程是什么

mybatis工作原理及流程:1、配置文件;2、接口与映射;3、sql解析与生成;4、执行计划;5、结果处理;6、动态sql;7、缓存机制;8、插件;9、事务管理;10、日志与监控;11、扩展性。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.02.23

292

4

hibernate和mybatis有哪些区别
hibernate和mybatis有哪些区别

hibernate和mybatis的区别:1、实现方式;2、性能;3、对象管理的对比;4、缓存机制。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.02.23

302

5

Java MyBatis框架
Java MyBatis框架

本专题专注于Java主流ORM框架MyBatis的应用,系统讲解SQL映射、动态SQL、结果映射、分页查询、缓存机制与多表关联等核心内容,并结合企业管理系统、电商平台和后台管理项目实战,帮助学员全面掌握高效的数据库持久层开发技能。

2025.08.26

5809

22

OpenJDK JVM参数怎么调优
OpenJDK JVM参数怎么调优

Java应用运行缓慢,如何调整JVM参数?本专题介绍OpenJDK JVM性能调优的基本流程,涵盖性能指标确认、运行数据采集、内存配置和垃圾回收分析,帮助你先定位瓶颈,再通过对照测试验证效果,避免直接套用参数而影响应用稳定性。

2026.10.16

60

10

OpenJDK怎么配置Java开发环境
OpenJDK怎么配置Java开发环境

怎样用OpenJDK搭建开发环境?本专题介绍版本选择、下载安装、环境变量配置和编译运行验证,帮助你理清JDK的作用及基本配置流程,并通过简单程序检查环境是否可用,为后续项目开发做好准备。

2026.10.16

20

10

OpenJDK怎么部署Java应用
OpenJDK怎么部署Java应用

Java项目开发完成后,怎样部署到目标环境并正常运行?本专题介绍OpenJDK应用部署流程,涵盖运行环境准备、版本兼容检查、应用打包、启动参数配置和日志查看,帮助你理清部署前后的操作顺序,减少环境差异造成的运行问题。

2026.10.16

20

10

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
dev.java 官方:Learn Java
dev.java 官方:Learn Java

共0课时 | 0人学习

Java JDBC数据库连接官方教程
Java JDBC数据库连接官方教程

共0课时 | 0人学习