当前位置：首页 > 科技 > 软件

盘点 Mybatis 使用过程中遇到的坑！

来源：责编：时间：2024-09-10 09:47:53 28观看

导读01、引言大家好，我是了不起，前一段时间在工作中因为一个疏忽踩了一个坑，最终通过异常栈追溯源码解决了问题。下面我来给大家还原一下案发现场，并介绍一下自己的解决思路，希望能对大家有所启发。02、案发现场当时的业务逻辑

01、引言

大家好，我是了不起，前一段时间在工作中因为一个疏忽踩了一个坑，最终通过异常栈追溯源码解决了问题。

下面我来给大家还原一下案发现场，并介绍一下自己的解决思路，希望能对大家有所启发。

02、案发现场

当时的业务逻辑主要通过 Mybatis 框架来修改数据，具体示例如下：

import org.springframework.data.repository.query.Param;public interface GroupMapper {  int updateGroup(@Param("oldSerial") Set<Integer> oldSerial, @Param("newSerial") int newSerial); int invalidGroup(@Param("set") Set<Integer> set);}

<update id="updateGroup">    update groupCode_table_use    set groupCode=#{newSerial}    where groupCode in    <foreach collection="oldSerial" close=")" open="(" item="item" separator=",">        #{item}    </foreach></update><update id="invalidGroup">    update groupCode_table    set status='无效'    where groupCode in    <foreach collection="set" close=")" open="(" item="item" separator=",">        #{item}    </foreach></update>

本以为 so easy 的代码，出现意外了！第一个sql语句updateGroup正常运行，第二个sql语句invalidGroup竟然报错了？？？

报错信息如下：

图片

从日志上可以看出，提示set参数找不到！

明明使用了@Param("set")将参数命名为set为何找不到，完全不符合多年开发的认知。

更加诡异的是updateGroup已使用了同样的方式去遍历，完全没得问题，那么问题出现在了哪了？

小伙伴可以先猜一猜！

03、原因分析

百思不得其解下，我掏出了祖传绝活 debug 源码，最终发现原来是Mybatis对集合Set进行了特殊处理。

案发项目引入的Mybatis版本是 3.5.1。部分源码如下！

org.apache.ibatis.session.defaults.DefaultSqlSession.java@Overridepublic int update(String statement, Object parameter) {  try {    dirty = true;    MappedStatement ms = configuration.getMappedStatement(statement);    //调用了wrapCollection方法对参数进行了处理    return executor.update(ms, wrapCollection(parameter));  } catch (Exception e) {    throw ExceptionFactory.wrapException("Error updating database.  Cause: " + e, e);  } finally {    ErrorContext.instance().reset();  }}/*** 如果参数实现了Collection接口或是数组类型 wrapCollection方法会对参数进行封装* 如果参数实现了Collection接口会封装为含collection键的Map*     如果参数又实现了List接口会封装为含list键的Map(追增)*     对Set集合没有特殊处理* 如果参数是数组类型会封装为含array键的Map*/private Object wrapCollection(final Object object) {  if (object instanceof Collection) {    StrictMap<Object> map = new StrictMap<>();    map.put("collection", object);    if (object instanceof List) {      map.put("list", object);    }    return map;  } else if (object != null && object.getClass().isArray()) {    StrictMap<Object> map = new StrictMap<>();    map.put("array", object);    return map;  }  return object;}

通过以上的源码分析，发现Mybatis框架对集合参数进行了特殊处理。

这就是为什么报错信息中提示Available parameters are [collection]。

找到了collection错误信息从哪里来问题，接下来我们分析一下set参数到了哪里去。

首先updateGroup可以正常执行是因为源码中对集合的特殊处理只对单参数生效，也就是说@Param("set")注解失效是因为被Mybatis自家的特殊处理给覆盖了？

这不合乎常理啊，那么问题可能出在@Param注解身上，通过排查代码发现GroupMapper.java类引用的@Param注解不对！

// 代码引入的注解类Paramimport org.springframework.data.repository.query.Param;// 期望的注解类，应该由mybatis提供import org.apache.ibatis.annotations.Param;

实际上，springframework包下的@Param注解执行时机在wrapCollection处理之前，wrapCollection对集合的特殊处理将springframework包下的@Param注解处理覆盖掉了，所以无法解析参数set。而mybatis包下的@Param注解执行时机在wrapCollection处理之后，程序可以正常运行。

最终确定，绕了这么大一圈，原来是包导入错了，谁能想到springframework包下还有一个@Param注解，在多参数的情况下竟然可以正常使用o(╥﹏╥)o。

04、异常栈分析法

整个异常排查过程中，主要通过分析异常栈信息进行快速定位。下面我给大家介绍一下异常栈分析法。

我们在工作中查看异常栈，往往都是业务代码异常导致的，这个时候我们只需要关心是在我们编写的哪段代码中出了问题。

而这时好用的idea也会为温馨的为我们做出提示，会在异常栈中将我们编写的方法位置信息标蓝处理，这样我们就定快速定位出现问题的代码。

图片

但是一旦是底层引用的jar包出现了异常，仅仅是这样查看异常栈是不够的。下面我们就以上面案例中的异常栈来带大家分析。

当前异常：

图片

原始异常：

图片

分析流程：

异常调用栈顺序:从上至下为方法调用顺序的逆序，异常由异常栈的最上面的方法抛出，整个调用的入口在最下方。
寻找原始异常入口技巧：检索异常栈中与原始异常入口（最下面）抛出位置同名的方法。
寻找真正异常出现的位置，要找最后一个 Caused by 的第一行栈帧。

"Caused by" 是 Java 异常处理机制中的一部分，它表示当前异常是由另一个异常引起的。在 Java 中，每个 Throwable 对象都可以通过 getCause() 方法获取到原始异常，这个原始异常就是通过 "Caused by" 打印出来的。

异常栈示例代码：

假设你在catch块中捕获了一个异常，并重新抛出了一个新的异常，同时保留了原始异常的信息：

public class Example {    public static void main(String[] args) {        try {            methodThatThrowsException();        } catch (Exception e) {            throw new RuntimeException("Caught an exception", e);        }    }    public static void methodThatThrowsException() throws Exception {        throw new Exception("Original exception");    }}

当你运行上述代码时，控制台输出的异常栈信息通常会包含Caused by信息：

java.lang.RuntimeException: Caught an exception    at Example.main(Example.java:7)Caused by: java.lang.Exception: Original exception    at Example.methodThatThrowsException(Example.java:12)    at Example.main(Example.java:5)

java.lang.Exception: Original exception 是原始异常。
java.lang.RuntimeException: Caught an exception 是新抛出的异常，并且包含了原始异常作为其原因。
Caused by 信息显示了原始异常的详细信息，这有助于调试和理解异常的来源。

如何保留原始异常信息呢？

方式一：直接传递原始异常：

try {     methodThatThrowsException(); } catch (Exception e) {     throw new RuntimeException("Caught an exception", e); }

方式二：使用 addSuppressed 方法：

try {     methodThatThrowsException(); } catch (Exception e) {     RuntimeException newException = new RuntimeException("Caught an exception");     newException.addSuppressed(e);     throw newException; }

05、结语

学会查看分析异常栈，可以为我们工作大大提高效率，希望这篇文章给大家带来收获，最后再送给大家一个小技巧。异常栈不仅仅可以用来排查异常哦，还可以帮助大家学习源码，debug 源码找不到入口怎么办，那就创造一个异常！

本文链接：http://www.28at.com/showinfo-26-112730-0.html盘点 Mybatis 使用过程中遇到的坑！

声明：本网页内容旨在传播知识，若有侵权等问题请及时与本网联系，我们将在第一时间删除处理。邮件：2376512515@qq.com

上一篇： SpringBoot与XXL-JOB高效定时任务管理指南

下一篇： Elasticsearch 使用误区—单次请求获取大量数据

标签：

热门焦点

6月iOS设备性能榜：M2稳居榜首 A系列只能等一手3nm来救

没有新品发布，自然iOS设备性能榜的上榜设备就没有什么更替，仅仅只有跑分变化而产生的排名变动，毕竟苹果新品的发布节奏就是这样的，一年下来也就几个移动端新品，不会像安卓厂商，一
服务存储设计模式：Cache-Aside模式

Cache-Aside模式一种常用的缓存方式，通常是把数据从主存储加载到KV缓存中，加速后续的访问。在存在重复度的场景，Cache-Aside可以提升服务性能，降低底层存储的压力，缺点是缓存和底
“又被陈思诚骗了”

作者｜张思齐出品｜众面（ID：ZhongMian_ZM）如今的国产悬疑电影，成了陈思诚的天下。最近大爆电影《消失的她》票房突破30亿断层夺魁暑期档，陈思诚再度风头无两。你可以说陈思诚的
小米汽车电池信息疑似曝光：容量101kWh，支持800V高压快充

7月14日消息，今日一名博主在社交媒体发布了一张疑似小米汽车电池信息的照片，显示该电池包正是宁德时代麒麟电池，容量为101kWh，电压为726.7V，可以预测小
机构称Q2国内智能手机销量同比下滑4% vivo份额重回第1

7月29日消息，根据市场调查机构Counterpoint Research公布的最新报告，2023年第2季度中国智能手机销量同比下降4%，创新自2014年以来第2季度销量新低。报
苹果、三星、惠普等暂停向印度出口笔记本和平板电脑

集微网消息，据彭博社报道，在8月3日印度突然禁止在没有许可证的情况下向印度进口电脑/平板及显示器等产品后，苹果、三星电子和惠普等大公司暂停向印度
iQOO 11S新品发布会

iQOO将在7月4日19:00举行新品发布会，推出杭州亚运会电竞赛事官方用机iQOO 11S。
2299元起！iQOO Pad明晚首销：性能最强天玑平板

5月23日，iQOO如期举行了新品发布会，除了首发安卓最强旗舰处理器的iQOO Neo8系列新机外，还在发布会上推出了旗下首款平板电脑——iQOO Pad，其最大的卖点
Android 14发布：首批适配机型公布

5月11日消息，谷歌在今天凌晨举行了I/O大会，本次发布会谷歌带来了自家的AI语言模型PaLM 2、谷歌Pixel Fold折叠屏、谷歌Pixel 7a手机，同时发布了Androi