背景

之前幫同事解決mybatis Invalid bound statement (not found):這個(gè)問(wèn)題，最近看到很多人也遇到這樣的問(wèn)題，所以就記錄一下出現(xiàn)這種情況的幾種情況。

問(wèn)題分析

出現(xiàn) Invalid bound statement (not found) 這個(gè)錯(cuò)誤的原因：

是根據(jù) mapper接口的全路徑 以"."(點(diǎn)號(hào))與方法名拼接成字符串，作為唯一key（下面將以key代替 ） 到 Map<String, MappedStatement> mappedStatements （后續(xù)已map 代替該對(duì)象）中去獲取對(duì)應(yīng)的MappedStatement, 如果獲取不到就報(bào)這個(gè)錯(cuò)誤。

根據(jù)上面的流程，也就解釋了為什么mapper 中的方法不能重載的原因。因?yàn)楂@取MappedStatement 是根類和方法名有關(guān)，與參數(shù)無(wú)關(guān)。所以不能重載。

繼續(xù)分析Invalid bound statement 這個(gè)錯(cuò)誤，出現(xiàn)這個(gè)錯(cuò)誤是因?yàn)楂@取不到MappedStatement，也就是說(shuō)在map 容器中根據(jù)key 去獲取值，沒(méi)有獲取到。

解決

那么問(wèn)題來(lái)了，什么情況下在map中根據(jù)key 獲取不到值呢？

其實(shí)獲取不到就兩種情況。

• 第一種情況： 就是map 是一個(gè)空集合。
• 第二種情況：map中沒(méi)有這個(gè)key （也就是說(shuō)key值不對(duì)）

什么情況下mappedStatements 這個(gè)map 為空呢？

回答這個(gè)問(wèn)題要明白mybatis 的原理。

在項(xiàng)目啟動(dòng)的過(guò)程中，會(huì)掃描并解析掃描到的mapper.xml 文件，將xml文件的namespace 與select 、update 、insert、delete 標(biāo)簽的id 以 namespace.id 的形式組成一個(gè)唯一的key ,將sql語(yǔ)句封裝成一個(gè)MappedStatement 對(duì)象作為value存儲(chǔ)在mappedStatements 這個(gè)map 集合中。

所以當(dāng)map集合為空，說(shuō)明mapper.xml 沒(méi)有被容器掃描到。

那什么情況下項(xiàng)目中有mapper.xml 文件卻沒(méi)有被掃描到呢？

回答這個(gè)問(wèn)題，要清楚mybatis mapper.xml 文件的加載目錄。

當(dāng)我們沒(méi)有在配置文件中配置指定目錄或者配置配置錯(cuò)誤的文件地址。

 mybatis:
  mapper-locations: classpath:mybatis/mapper/*.xml

在容器啟動(dòng)的時(shí)候會(huì)到配置文件指定的目錄和mapper 接口所在的包中查找，如果查找不到map集合就是空的。

這時(shí)候有的人該問(wèn)

配置文件配置的mapper.xml 文件地址沒(méi)有錯(cuò)誤，為什么map 還是空的？

如果出現(xiàn)這個(gè)問(wèn)題，我們需要排查一下target 目錄中是否有mapper.xml 文件 因?yàn)閙aven 編譯打包 會(huì)將代碼編譯打包成target文件中，程序運(yùn)行也是讀取加載該目錄下的文件，而不是我們項(xiàng)目目錄。

這時(shí)需要在pom 文件build中添加如下配置

<resources>
            <resource>
                <directory>src/main/java</directory>
                <includes>
                    <include>**/*.xml</include>
                </includes>
                <filtering>false</filtering>
            </resource>
            <resource>
                <directory>src/main/resources</directory>
                <includes>
                    <include>**/*.xml</include>
                    <include>**/*.yml</include>
                </includes>
                <filtering>false</filtering>
            </resource>
        </resources>`

map為空總結(jié)

1、 檢查mapper的xml文件 是否在mapper 接口包中。如果不在，說(shuō)明指定了目錄（目前一般都是在resource 資源目錄下新建文件夾） 如果指定了目錄 需要在配置文件中配置指定的目錄。

注意：在resource 目錄下創(chuàng)建多級(jí)目錄時(shí)，要一層一層創(chuàng)建，不要像創(chuàng)建Java目錄一下以"."隔開，這樣是不對(duì)的。

2、項(xiàng)目配置沒(méi)有問(wèn)題，還出現(xiàn)這個(gè)問(wèn)題，排查一下target 目錄中是否有mapper.xml 。沒(méi)有則說(shuō)明maven 打包的時(shí)候沒(méi)有將xml 文件打包進(jìn)jar中，需要在pom中添加resource配置信息。

下面來(lái)說(shuō)說(shuō)第二種情況：key 值不正確

1、這種情況 需要排查mapper 接口全路徑 與 mapper xml 文件中的namespace 配置是否一致。

這里有個(gè)驗(yàn)證技巧：

按住Ctrl 鍵 鼠標(biāo)點(diǎn)擊接口名 看看是否能正常跳轉(zhuǎn)到接口中，如果能正常跳轉(zhuǎn)，則說(shuō)明映射成功，如果不能跳轉(zhuǎn)，則說(shuō)明namespace 配置的不正確，需要修改。

2、隱射成功，下一步拷貝接口中的方法名 到xml 文件中查找是否有對(duì)應(yīng)的sql，排查xml sql 的id值是否與方法名一致。（注意空格）

這里也有一個(gè)排錯(cuò)技巧：

在idea 上安裝 Free Mybatis plugin插件，這樣 按住Ctrl 鍵 點(diǎn)擊id 看是否能跳轉(zhuǎn)到接口中對(duì)應(yīng)的方法上。如果不能則說(shuō)明id 的值不對(duì)，修改成方法名即可。

看到這里估計(jì)有人又該問(wèn)了

我怎么知道m(xù)ap中是否為空呢？怎么知道key是不正確呢？

如果有看源碼能力的，可以debug項(xiàng)目 追源碼。

如果不想看源碼的，我這里給一個(gè)很直接的方式。debug模式啟動(dòng)項(xiàng)目后，記住是在項(xiàng)目啟動(dòng)后，在mybatis 源碼中打斷點(diǎn)，然后請(qǐng)求 debug查看。

千萬(wàn)別在啟動(dòng)項(xiàng)目前打斷點(diǎn)，因?yàn)轫?xiàng)目啟動(dòng)加載也會(huì)走這里，這樣會(huì)看迷糊的。記住是啟動(dòng)項(xiàng)目后，訪問(wèn)前 打斷點(diǎn)

總結(jié)

這是我目前能找到錯(cuò)誤的原因和解決的方式方法。

以上為個(gè)人經(jīng)驗(yàn)，希望能給大家一個(gè)參考，也希望大家多多支持腳本之家。

最新評(píng)論