通过MyBatis源码，查看org.apache.ibatis.binding.BindingException的抛出路径

最新推荐文章于 2025-06-08 12:08:50 发布
最新推荐文章于 2025-06-08 12:08:50 发布
阅读量1.7k 收藏
点赞数 1
CC 4.0 BY-SA版权
分类专栏： Mybatis 文章标签： org.apache.ibatis.binding.Bind
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.youkuaiyun.com/yangfengjueqi/article/details/79608900
本文通过分析MyBatis源码，探讨了org.apache.ibatis.binding.BindingException异常的产生路径。从找不到参数异常出发，沿着MapperMethod、MapperProxy、MapperProxyFactory到MapperRegistry的调用链进行解析，揭示了MyBatis参数封装及异常处理的机制。

摘要生成于 C知道 ，由 DeepSeek-R1 满血版支持， 前往体验 >

使用MyBatis框架中经常会看到这样的异常，今天跟着源码看一下这条异常的抛出路径：

先根据路径找到org.apache.ibatis.binding.BindingException这个异常类(Ctrl + Shift + R没有直接定位到该类，具体原因待分析)，源代码如图1


Ctrl + H中也没定位到Parameter '__frch_item_0' not found. Available parameter，只能通过Ctrl + Shift + G一个个查看BindingException几个构造函数的调用位置了。


查找一遍后，确定该条异常只有在org.apache.ibatis.binding.MapperMethod中的内部静态类ParamMap<V>中抛出


可以看到MyBatis是将Mapper中的参数都封装成HashMap对象，该内部静态类是在MapperMethod中的convertArgsToSq

最低0.47元/天 解锁文章

200万优质内容无限畅学
MyBatis 源码分析-- SQL请求执行流程（ Mapper 接口方法的执行的过程）
weixin_42118323的博客
06-24 1121
MapperProxy#invoke 方法会判断执行的方法是否是 Object 类的方法，如果是就无需代理，否则才会走代理的方法，代理的方法有两个默认实现 一个是普通方法 PlainMethodInvoker 和默认方法实现 DefaultMethodInvoker。CachingExecutor#query 会判断是否使用了缓存，如果允许使用缓存会先从二级缓存查询，二级缓存中查询不到才会去查询一级缓存或者数据库，如果二级缓存为空或者不允许使用缓存就会直接去查询一级缓存或者数据库。
MyBatis源码分析
简乐君
05-11 1万+
篇章一：入口篇 我们学习Mybatis时知道其核心是SqlSessionFactory，它是mybatis的核心类，也是Mybatis运行的入口，spring集成mybatis时需要配置SqlSessionFactoryBean和扫描mapper的MapperScannerConfigurer，spring-mybatis集成主要的配置就这么点，从这理解也就不难理解mybatis入口问题了，但是...
org.apache.ibatis.binding.BindingException
Creamchn的博客
03-25 309
org.apache.ibatis.binding.BindingException报错信息 报错信息 今天在使用mabatis的时候查询不到数据,抛出异常,排查了xml文件没有任何的错误 exception: org.apache.ibatis.binding.BindingException: Invalid bound statement (not found): com.xuecheng...
org.apache.ibatis.binding.BindingException: Invalid bound statement (not found) 错误
最新发布
xiaodouni333的博客
06-08 629
mybatis报错，找不到SQL映射语句
【JAVA】解决mapper绑定异常：nested exception is org.apache.ibatis.binding.BindingException:
s850345609的博客
05-01 1070
解决mapper绑定异常：nested exception is org.apache.ibatis.binding.BindingException:
org.apache.ibatis.binding.BindingException原因总结
热门推荐
二十同学
06-05 19万+
今天遇到mybatis的报错，搞了好久才搞懂，在网上找了好久的相似案例，也没有搞定，先来看下网上常见的解决办法吧，相信也能解决大部分人的报错。 排查方法如下： 1、mapper接口和mapper.xml是否在同一个包（package)下？名字是否一样（仅后缀不同）？ 2、mapper.xml的命名空间（namespace）是否跟mapper接口的包名一致？ 3、接口的方法名，与xml中的一...
初学mybatis时出现 org.apache.ibatis.binding.BindingException报错
weixin_46822367的博客
03-16 617
错误分析：由于每一个Mapper.xml都需要在mybatis核心配置文件中注册 解决方法：在mybatis-config.xml配置文件中添加下面几行代码（注意路径一定要填写正确，按照com/lyp/dao/UserMapper.xml 的格式进行填写） <mappers> <mapper resource="com/lyp/dao/UserMapper.xml"/> </mappers> ...
org.mybatis.spring.MyBatisSystemException: nested exception is org.apache.ibatis.binding.BindingException: Parameter 'startTime' not found. Available parameters are [deviceNo, endTime, param3, param1, param2] at org.mybatis.spring.MyBatisExceptionTranslator.translateExceptionIfPossible(MyBatisExceptionTranslator.java:96) at org.mybatis.spring.SqlSessionTemplate$SqlSessionInterceptor.invoke(SqlSessionTemplate.java:441) at com.sun.proxy.$Proxy100.selectList(Unknown Source) at org.mybatis.spring.SqlSessionTemplate.selectList(SqlSessionTemplate.java:224) at com.baomidou.mybatisplus.core.override.MybatisMapperMethod.executeForMany(MybatisMapperMethod.java:166) at com.baomidou.mybatisplus.core.override.MybatisMapperMethod.execute(MybatisMapperMethod.java:77) at com.baomidou.mybatisplus.core.override.MybatisMapperProxy$PlainMethodInvoker.invoke(MybatisMapperProxy.java:148) at com.baomidou.mybatisplus.core.override.MybatisMapperProxy.invoke(MybatisMapperProxy.java:89) at com.sun.proxy.$Proxy119.timePeriodTraffic(Unknown Source) at com.syzn.dv.biz.yunk.southbound.adapter.repo.impl.YunkStatisticDataRepoImpl.timePeriodTraffic(YunkStatisticDataRepoImpl.java:145) at com.syzn.dv.biz.yunk.manager.impl.YunkBigScreenManagerImpl.getTimePeriodTraffic(YunkBigScreenManagerImpl.java:120) at com.syzn.dv.biz.yunk.northbound.appservice.impl.YunkBigScreenAppServiceImpl.getTimePeriodTraffic(YunkBigScreenAppServiceImpl.java:59) at com.syzn.dv.biz.bigscreen.northbound.controller.BigScreenController.getTimePeriodTraffic(BigScreenController.java:51) at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method) at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:62) at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:43) at java.lang.reflect.Method.invoke(Method.java:498) at org.springframework.web.method.support.InvocableHandlerMethod.doInvoke(InvocableHandlerMethod.java:197) at org.springframework.web.method.support.In
04-02
: 关于类加载器涉及到 JVM 的“双亲委派机制”，在《精尽MyBatis源码分析 - 基础支持层》有简单讲述，可参考`initWebApplicationContext`的实现逻辑。 [^2]: 根据官方声明，2.0.9可能是最后一个2.0.x版本，建议关注...
Mybatis源码
tmax52HZ的博客
05-27 632
从Mybatis入门使用开始，分析到Mybatis源码。涉及以下内容： 1、mybatis-Config.xml内容解析、Mybatis-generatorConfiguration.xml逆向工程、XML映射文件等 2、SQL注入、动态SQL中各种标签的使用 3、源码分析了MapperProxy、SqlSessionTemplate、一级缓存失效、二级缓存查询存储原理、以及四大组件Executor、StatementHandler、ParameterHandler、ResultSetHandler以及插件
MyBatis中mapper接口方法多参数传入
u011420057的博客
05-18 6363
测试一个更新用户密码的mapper方法的时候出现了这个异常： Caused by: org.apache.ibatis.binding.BindingException: Parameter 'password' not found. Available parameters are [0, 1, param1, param2] at org.apache.ibatis.binding.Map
mybatis配置映射问题org.apache.ibatis.binding.BindingException: Invalid bound statement (not found):
椰子奶糖的博客
09-04 3万+
随着做的小项目的体量增加，我就想着给各类mapper以及*.xml分个类 担心会出点什么幺蛾子，所以用以前的测试类测试了一下，就爆出来这个错误 org.apache.ibatis.binding.BindingException: Invalid bound statement (not found): com.ch.home.mapper.restDishMapper.DishCu...
org.apache.ibatis.binding.BindingException: Mapper method 'com.zbiti.alarm.dao.AlarmDao.queryTest at
ShiXinXin_Harbour的博客
09-09 661
看到了万能的String,万能的string作为接口和resultType的返回值 使用Mybatis查询一个数值字段时，我们会使用int long 等简单类型作为resultType，如果我们这个sql没有查询出记录，也就是sql查询出的结果为null，那么这时候就会报错！！！ 接口定义： public int queryTest(); mapper定义 （staff_id = 33 不存在时...
org.apache.ibatis.binding.BindingException: Mapper method 'com... has an unsupported return type的解决办
IT_PJ0708的博客
11-28 1万+
今天在写接口中出现了这种错误，花了整整1个小时  建议排除的办法 1，检查dao层与xml的全类名是否一致 2，检查方法名与是否dao层是否一致 3，返回类型是是否一致 今天我解决的问题就是返回值类型出现的，我在xml中写了一个update语句返回的类型是map dao层也是返回类型也是map 但是忽略了一个问题。update默认返回的类型是int 所以出现了 has an unsuppo...
SpringBoot2整合Mybatis拦截器，拦截mapper接口的某个方法
周君的个人博客
01-05 1万+
需求： 在执行某个动态sql时，where 子句，希望通过用户进行自定义查询条件，比如用户可以传入 “id >100011 and name = '张三'” 的多条件表达式进行查询 (注意：这里的条件查询，为了安全性的考虑，是经过处理的，以免出现安全漏洞。) 方法： 1. 自定义mybatis的拦截器MySqlInterceptor（继承 org.apache.ibatis.plugin.Interceptor）对执行的mapper接口进行拦截 2. 改写对应...
报错org.apache.ibatis.binding.BindingException: Parameter 'xxxxx' not found.
空空说技术的博客
09-14 3万+
报错Parameter ‘xxxx’ not found. Available parameters are [0, 1, param1, param2… 1.报错信息 　　今天使用mybatis查询数据的时候，出现org.apache.ibatis.binding.BindingException: Parameter ‘username’ not found. Available para...
在微服务开发的工程中使用mybaits进行查询时，出现了参数无法识别的报错信息：org.apache.ibatis.binding.BindingException: Parameter 'payDa...
06-11 452
【问题描述】 2018-06-09 17:33:09.910 ERROR 7424 --- [io-2008-exec-10] o.a.c.c.C.[.[.[/].[dispatcherServlet] : Servlet.service() for servlet [dispatcherServlet] in context with path [] threw exception ...
org.apache.ibatis.binding.BindingException:报错原因解决
qq_37281398的博客
08-08 2657
spring整合mybatis，操作数据库的时候报这个异常 Sat Aug 08 19:24:45 CST 2020 WARN: Establishing SSL connection without server's identity verification is not recommended. According to MySQL 5.5.45+, 5.6.26+ and 5.7.6+ requirements SSL connection must be established by defa
mybatis-plus org.apache.ibatis.binding.BindingException
08-18
org.apache.ibatis.binding.BindingException在MyBatis-Plus中也可能出现。MyBatis-Plus是在MyBatis基础上进行扩展和增强的持久层框架，因此在使用MyBatis-Plus过程中，也可能会遇到BindingException异常。 ...
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值