记Mybatis之BindingException的产生解决过程

一. 业务场景

前几天威哥带学生做一个小案例，需要更新数据库中的车辆信息表，根据指定车辆的设备id(编号和设备ID均非主键)来更新车辆信息。威哥要求学生们用Mybatis进行实现，所以是在对应的mapper.xml中自定义了SQL语句，结果有个学生在调用对应接口时爆出了一个异常。但他不知道这个异常该怎么解决，于是就跑来问威哥。其实在学习的时候，很多初学者都会出现一些令人头疼的问题。

所以接下来威哥就以Mybatis中的这个常见异常为例，来带着大家分析Mybatis开发过程出现异常之后该如何快速解决，这样以后再遇到类似问题时，大家就知道该怎么解决问题了。

威哥提醒，不要让同一个问题困扰你两次哦！

二. 异常信息

我们先来看看这个异常是什么。

org.apache.ibatis.binding.BindingException
nested exception is org.apache.ibatis.binding.BindingException:Parameter 'carNo' not found. Available parameters are [cardNo, devId, param1, param2]

很多同学在使用Mybatis时，可能都遇到过上面的这个异常。有些同学一看到密密麻麻的英文单词，几乎都不认识，脑袋嗡一下子就炸了，到底哪里出错了，出了什么错，啥也不知道，反正就知道报错了，一下子就不知所措了。

威哥在这里告诉大家，遇到问题千万不要紧张。如果你的单词量不行，可以使用有道翻译对照查看错误，慢慢积累单词就记住了，其实Java里的常用单词就那么几个，天天看起码知道啥意思，我们也不需要你背写单词对吧。

上面的异常，咱们根据字面意思来理解就是产生了绑定异常，而后面的详细描述是说参数 carNo找不到.......既然已经知道了这个错误，那就继续往下看分析吧！

三. Mybatis使用须知

在解决异常之前，威哥先来带各位复习一下Mybatis的使用须知。Mybatis使用说明：

1).首先定义的接口方法名要和XxxMapper.xml文件中的id保持一致；
2).建议接口名和mapper映射文件名称一致；
3).mapper映射文件中的namesapce必须是接口的全限定名称；
4).建议接口文件和mapper映射文件的目录结构一致；
5).接口中如果用了参数绑定@Param，需要查看映射文件的占位符内容是否和它一致。

四. 原因排查

复习了上面的Mybatis使用须知，你现在是否已经知道上面的异常是怎么产生的了？其实控制台里的信息已经把异常原因说的很清楚了：

Parameter 'carNO' not found. Available parameters are [carNo, devId, param1, param2] ，

这里表示没找有到XML中使用占位符表示的参数 #{carNO}，能用的参数有carNo、devId等，这里明显就是发生了拼写错误。我们仔细检查核对一下MyBatis中的XML文件。

<!--如下的映射文件内容，里面的占位符使用的carNO,NO都是大写字母！！！-->
<update id ="updateDevIdByCarNo">
    update car set devId = #{devId} where car_no = #{carNO}
</update>

然后我们再来看看对应的Mapper接口代码：

int updateDevIdByCarNo(@Param("devId") String devId,@Param("carNo")String carNo);

注意看，这里参数绑定里面No的o是小写字幕，就是这样一个很小的细节，因为学生的粗心导致了上面的绑定错误！

也就是说，上面的异常是由一个字母的大小写不匹配而引发的错误！是不是太不应该出现这种错误了呢？其实很多人在学习编程时所犯的错误，绝大多数都是因为马虎造成的！

五. 解决办法

其实解决办法很简单，只需要将XML文件中的参数名和Mapper接口里的参数名保持一致即可！

六. 总结与反思

本案例中的异常，是因一个字母的大小写不匹配而导致的错误，这不仅仅引发了BindingException异常，同时还暴露了我们学习时存在的极大缺点：

1).代码命名不规范，Id还是ID，No还是NO，在项目中要保持统一的风格；
2).合理CV：为了减少xml文件中出现不必要的错误，可以直接从已有的SQL语句中把参数粘贴过来(NO);
3).一定要注意接口与xml文件之间的拼写一致性！

本案例中的异常真可以说是“一个馒头引发的血案”，小错误也可以引发大故障，请大家在开发时一定要仔细哦！现在你知道异常该怎么解决了吗？如果还有什么问题，可以在评论区给留言哦！或者java学习+资料获取 加q群：691533824