一. 業務場景

前幾天壹哥帶學生做一個項目，需要更新數據庫中的車輛信息表，具體需求是要根據指定車輛的設備id(編號和設備ID均非主鍵)來更新車輛信息。壹哥要求學生們用Mybatis進行實現，所以就在對應的Mapper.xml文件中自定義SQL語句。結果有個學生在調用對應接口時爆出了一個BindingException異常，一下子就造成了整個模塊崩潰，但他不知道這個異常該怎么解決，于是就慌慌張張地跑來問壹哥。其實我們在學習的時候，很多初學者都會遇到一些奇葩的問題而不知道怎么解決。

那么接下來，壹哥就以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的使用須知：

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] ，

這里表示沒找有到占位符表示的參數 #{carNO}，能用的參數有carNo、devId等，這里明顯就是發生了拼寫錯誤。我們仔細檢查核對一下發生異常之前，MyBatis中的XML文件內容：

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

我們發現，原始的XML映射文件里面#{carNO}占位符使用的carNO，即NO都是大寫字母！！！然后我們再來看看對應的Mapper接口代碼：

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

注意看，這里參數綁定里面No的o是小寫字幕，就是這樣一個很小的細節，因為學生的粗心大意導致了上面的綁定錯誤！

也就是說，上面的異常是由一個字母的大小寫不匹配而引發的！無語！是不是太不應該出現這種錯誤了呢？其實很多人在學習編程時所犯的錯誤，絕大多數都是因為馬虎造成的！

五. 解決辦法

其實解決辦法很簡單，只需要將XML文件中的參數名和Mapper接口里的參數名保持一致即可！比如兩者都改成carNO！

六. 總結與反思

本案例中的異常，是因為一個字母的大小寫不匹配而導致的錯誤，這不僅僅引發了BindingException異常，同時還暴露了我們學習時存在的極大缺點：

1). 代碼命名不規范，Id還是ID，No還是NO，在項目中要保持統一的風格； 2). 合理CV：為了減少XML文件中出現不必要的錯誤，可以直接從已有的SQL語句中把參數粘貼過來(NO); 3). 一定要注意接口與XML文件之間的拼寫一致性！

本案例中的異常真可以說是“一個饅頭引發的血案”，一個小小的拼寫錯誤也可以引發大故障，所以大家在開發時一定要仔細哦！

現在你知道異常該怎么解決了嗎？如果還有什么問題，可以在評論區給壹哥留言哦。

總結

以上是生活随笔為你收集整理的”一个馒头引发的血案“|记Mybatis之BindingException异常的产生及解决过程的全部內容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。