MyBatis SQL语法错误：缺少LIKE关键字详解与解决方案

更新时间：2026年08月18日 08:44:25 作者：步行cgn

在MyBatis模糊查询中遇到SQLSyntaxErrorException错误,本文详细分析brand concat('%',?,'%')报错的原因,指出缺少LIKE关键字的问题,并提供三种解决方案和完整示例,帮助你快速修复SQL语法错误,确保查询正确执行,需要的朋友可以参考下

一、错误现象

运行测试时抛出：

java.sql.SQLSyntaxErrorException: You have an error in your SQL syntax; 
check the manual that corresponds to your MySQL server version for the right syntax to use near 'concat('%','宝马','%')' at line 2

执行 SQL（从日志中截取）：

select id, car_num, brand, guide_price, produce_time, car_type 
from t_car                                                                  
where brand concat('%', ?, '%')

参数：宝马（String）

二、错误含义

这条 SQL 的 WHERE 子句中，brand 后面直接跟了 concat('%',?, '%')，但 MySQL 中模糊匹配必须使用 LIKE 关键字，不能直接将表达式放在列名后面。

也就是说，brand concat(...) 是非法的 SQL 语法，正确的写法应当是 brand LIKE concat(...)。

三、错误代码示例

你的 CarMapper.xml 中很可能写了类似：

<select id="selectCar" resultType="com.xie.entity.Car">
    select id, car_num, brand, guide_price, produce_time, car_type 
    from t_car
    where brand concat('%', #{brand}, '%')
</select>

或者可能是：

<select id="selectCar" resultType="com.xie.entity.Car">
    select id, car_num, brand, guide_price, produce_time, car_type 
    from t_car
    where brand concat('%', '${brand}', '%')
</select>

但无论哪种，都缺少了 LIKE 关键字。

四、解决方案

方案一：直接加上LIKE（推荐）

<select id="selectCar" resultType="com.xie.entity.Car">
    select id, car_num, brand, guide_price, produce_time, car_type 
    from t_car
    where brand LIKE concat('%', #{brand}, '%')
</select>

使用 #{} 可以安全地防止 SQL 注入。

方案二：使用bind标签（另一种写法）

<select id="selectCar" resultType="com.xie.entity.Car">
    <bind name="pattern" value="'%' + brand + '%'"/>
    select id, car_num, brand, guide_price, produce_time, car_type 
    from t_car
    where brand LIKE #{pattern}
</select>

方案三：在 Java 代码中拼接%

// Mapper 接口
List<Car> selectCar(@Param("brand") String brand);

// 调用时
String brand = "宝马";
carMapper.selectCar("%" + brand + "%");

XML 中：

<select id="selectCar" resultType="com.xie.entity.Car">
    select id, car_num, brand, guide_price, produce_time, car_type 
    from t_car
    where brand LIKE #{brand}
</select>

这种方式将拼接逻辑移到 Java 层，XML 更简洁。

五、错误原因分析

从日志 ==> Preparing: ... where brand concat('%',?,'%') 可以看出，MyBatis 生成的 SQL 中，concat 函数直接被放在了 brand 后面，而没有 LIKE。这说明 XML 中漏写了 LIKE。

这是典型的 SQL 语法错误，与 MyBatis 参数绑定无关。

六、修正后的完整示例

Mapper 接口：

List<Car> selectCar(@Param("brand") String brand);

XML 映射：

<select id="selectCar" resultType="com.xie.entity.Car">
    select id, car_num, brand, guide_price, produce_time, car_type 
    from t_car
    where brand LIKE concat('%', #{brand}, '%')
</select>

测试代码：

List<Car> cars = carMapper.selectCar("宝马");
cars.forEach(System.out::println);

七、总结

错误类型	原因	解决方案
`SQLSyntaxErrorException` near `concat(...)`	`WHERE` 子句中缺少 `LIKE` 关键字	在列名和条件表达式之间加上 `LIKE`

记住：MySQL 的模糊查询必须使用 LIKE 关键字，格式为 column LIKE pattern，不能省略。

以上就是MyBatis SQL语法错误：缺少LIKE关键字详解与解决方案的详细内容，更多关于MyBatis SQL语法错误的资料请关注脚本之家其它相关文章！

您可能感兴趣的文章:

深度解析@JsonSerialize注解及其在Jackson 序列化中的应用小结
本文详细介绍了Jackson库中的@JsonSerialize注解,探讨其用途、优点、缺点以及在日期格式处理、特殊数据类型、敏感信息隐藏和自定义逻辑等场景的应用,通过实例演示了如何在Person类中使用注解定制日期序列化,感兴趣的朋友一起看看吧
2025-10-10
Java使用BigDecimal解决精度丢失问题
本文详细解释了浮点型数据因二进制和十进制不兼容而导致的精度丢失问题,并指出BigDecimal是解决该问题的有效方法,文中的示例代码讲解详细,感兴趣的小伙伴可以了解下
2026-04-04
Java基础之TreeMap详解
这篇文章主要介绍了Java基础之TreeMap详解,文中有非常详细的代码示例,对正在学习java基础的小伙伴们有非常好的帮助,需要的朋友可以参考下
2021-04-04
详解java定时任务
这篇文章主要为大家详细介绍了java定时任务，使用JDK中的Timer定时任务来实现，感兴趣的小伙伴们可以参考一下
2016-03-03
Java面向对象编程（封装/继承/多态）实例解析
这篇文章主要介绍了Java面向对象编程（封装/继承/多态）实例解析的相关内容，具有一定参考价值，需要的朋友可以了解下。
2017-10-10
java性能分析jconsole详解
这篇文章主要介绍了java性能分析jconsole详解，文章围绕主题展开详细的内容介绍，具有一定的参考价值，需要的小伙伴可以参考一下
2022-07-07
如何根据带账号密码的WSDL地址生成JAVA代码
这篇文章主要介绍了如何根据带账号密码的WSDL地址生成JAVA代码,文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下
2020-10-10
Java如何导入Jsoup库做一个有趣的爬虫项目
Jsoup库是一款Java的HTML解析器,可用于从网络或本地文件中获取HTML文档并解析其中的数据,这篇文章给大家介绍Java导入Jsoup库做一个有趣的爬虫项目,感兴趣的朋友跟随小编一起看看吧
2023-11-11
redis setIfAbsent和setnx的区别与使用说明
这篇文章主要介绍了redis setIfAbsent和setnx的区别与使用，具有很好的参考价值，希望对大家有所帮助。如有错误或未考虑完全的地方，望不吝赐教
2021-08-08
Java源码解析HashMap的tableSizeFor函数
今天小编就为大家分享一篇关于Java源码解析HashMap的tableSizeFor函数，小编觉得内容挺不错的，现在分享给大家，具有很好的参考价值，需要的朋友一起跟随小编来看看吧
2019-01-01