前言

這個(gè)Bug前前后后折騰了兩天才找到答案，雖說不是完全兩天的工作時(shí)間在調(diào)試這個(gè)問題，但是過程也確實(shí)曲折，所以做一下記錄，也當(dāng)做一次自我反省

背景

SpringBoot 與 MyBatis-Plus 的 pom 依賴

<!-- SpringBoot 版本 --><parent> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-parent</artifactId> <version>1.5.9.RELEASE</version> <relativePath/> <!-- lookup parent from repository --></parent><!-- MyBatis-plus 版本 --><dependency> <groupId>com.baomidou</groupId> <artifactId>mybatis-plus-boot-starter</artifactId> <version>3.1.0</version></dependency>

項(xiàng)目分模塊結(jié)構(gòu)

之前一直停留在 SpringBoot 整合其他框架做一些小項(xiàng)目，所以都是把代碼放在一個(gè)工程，也沒有進(jìn)行分模塊管理。

由于公司打算開發(fā)新產(chǎn)品，我想嘗試在 SpringBoot 的項(xiàng)目來做分模塊的開發(fā)（Maven工程），并且用 MyBatis-Plus 來做持久層框架，也就是將 SpringBoot 做 web模塊， 實(shí)體跟Mapper 拆分到 persistence模塊，并將 mapper.xml 文件放在 persistence模塊 的 resources/mapper 目錄下。

在項(xiàng)目分模塊完成之后，并進(jìn)行代碼移植時(shí)并沒有發(fā)現(xiàn)問題，因?yàn)榇藭r(shí)并不需要調(diào)用到自定義 mapper.xml 中的 sql 查詢數(shù)據(jù)庫。但隨著一步一步的完善代碼，也開始需要用到 mapper.xml 的 sql 查詢，此時(shí)，在調(diào)試時(shí)，發(fā)現(xiàn)了如下錯(cuò)誤：

即，報(bào)找不到對(duì)應(yīng)的 sql

排查原因排除 mapper.xml 書寫錯(cuò)誤

首先排除 mapper.xml 中 namespace 或 sql 的 id 寫錯(cuò)，因?yàn)槲业拈_發(fā)工具下載了 MybatisX 的插件，mapper.java 與 mapper.xml 都有插件的小圖標(biāo)，如下圖所示，

懷疑：分模塊導(dǎo)致

其次，在先前我已經(jīng)整合過 SpringBoot 與 MyBatis-Plus 單項(xiàng)目的工程，并沒有這個(gè)問題，所以，我懷疑是因?yàn)?分模塊導(dǎo)致的原因 導(dǎo)致的，所以，我想 分模塊跟不分模塊的工程 有區(qū)別？

區(qū)別就是，不分模塊 mapper.xml 文件就在項(xiàng)目 classes 下的 mapper 中，而分模塊后， mapper.xml 文件就在 persistence模塊打出來的 jar 中 。

錯(cuò)誤思路：修改pom文件配置resources目錄

所以，發(fā)現(xiàn)了這點(diǎn)之后，就開始必應(yīng)解決方案，但是剛開始我的思路是 錯(cuò)誤的，我以為項(xiàng)目打包之后，沒有把 persistence模塊的 resources 下 的 mapper 目錄打包進(jìn) jar 中 。浪費(fèi)了一些時(shí)間之后，我才想清楚應(yīng)該先去 persistence模塊 打出來的 jar 中確認(rèn)有沒有將 resources 下的 mapper/mapper.xml 打包進(jìn)去。

懷疑：Spring Resource時(shí)沒有加載 jar 中的 mapper.xml

上面的問題教了自己一課，眼見為實(shí) ，雖然解決 Bug 的過程中，合理的猜測(cè)是必要的，但是在有限的結(jié)果集中，驗(yàn)證排除一些錯(cuò)誤的思路更為重要。就像，經(jīng)常有人會(huì)問我，“為什么我運(yùn)行老是報(bào)找不到類的錯(cuò)誤”，我就說那你到 tomcat 的發(fā)布路徑上看一下 jar 包有沒有發(fā)不上去，這其實(shí)是一個(gè)道理的。

回到問題，為什么Spring Resource時(shí)沒有加載 jar 中的 mapper.xml ？必應(yīng)尋找解決方案，在必應(yīng)的過程中我才想起了 Spring 的 Resource 加載文件， classpath 與 classpath* 的區(qū)別，好久沒有自己手寫搭項(xiàng)目，把這個(gè)給忘記了。

所以，此時(shí)我確信將 application.xml 中 mybatis-plus.mapper-locations 的值改為 classpath*:mapper/*Mapper.xml 即可，如下

#mapper plusmybatis-plus: mapper-locations: classpath*:mapper/*Mapper.xml懷疑：SpringBoot 跟 MyBatis-Plus 整合的配置哪里不對(duì)嗎？

上面的配置修改之后，重新運(yùn)行，還是報(bào)同樣的錯(cuò)！！！

What The Fuck！！！因?yàn)槲矣X得這個(gè) bug 就是由于 classpath:mapper/*Mapper.xml Spring 的 Resource 只能掃描當(dāng)前應(yīng)用中的 classpath 下的 mapper 目錄的 mapper.xml 的文件，所以，我又重新必應(yīng)了 SpringBoot 與 Mybati-plus 的整合配置 ，說到底還是對(duì)這個(gè)框架不了解，導(dǎo)致走了不少彎路，而且在出問題的時(shí)候，沒有堅(jiān)信自己的判斷，而不斷的嘗試必應(yīng)出來的結(jié)果，使得又浪費(fèi)了一些時(shí)間在這個(gè)問題上。

最后必應(yīng)了一圈后，還是沒有找到解決方案，而且與此相關(guān)的問題文章也不多， 我開始迷茫跟急躁了，畢竟已經(jīng)浪費(fèi)了這么多的時(shí)間，我還是決定先驗(yàn)證一下我前面深信的東西---- Spring 的 Resource 加載文件， classpath 與 classpath* 的區(qū)別 ，所以，我決定自己創(chuàng)建 sqlSessionFactory ，代碼如下

@Bean('sqlSessionFactory')public SqlSessionFactory sqlSessionFactory() throws Exception { MybatisSqlSessionFactoryBean sqlSessionFactory = new MybatisSqlSessionFactoryBean(); sqlSessionFactory.setDataSource(datasource); ResourcePatternResolver resolver = new PathMatchingResourcePatternResolver(); Resource[] resources = resolver.getResources('classpath*:mapper/*Mapper.xml'); sqlSessionFactory.setMapperLocations(resources); MybatisConfiguration configuration = new MybatisConfiguration(); configuration.setJdbcTypeForNull(JdbcType.NULL); configuration.setMapUnderscoreToCamelCase(true); configuration.setCacheEnabled(false); sqlSessionFactory.setConfiguration(configuration); //添加分頁功能 sqlSessionFactory.setPlugins(new Interceptor[]{paginationInterceptor() }); return sqlSessionFactory.getObject();}

結(jié)果是運(yùn)行通過了！！不過，這也是理所當(dāng)然的，這就說明了我在 application.xml 中 mybatis-plus 的配置沒生效，相當(dāng)于又回到了上一個(gè)問題。到了這里，我才想到去看 mybatis-plus-boot-starter 里面的源碼！！

沒想到的是，源碼相當(dāng)容易看，首先，jar 包的目錄結(jié)構(gòu)如下，看名字直接選擇看 MybatisPlusAutoConfiguration 這個(gè)配置類

打開 MybatisPlusAutoConfiguration 的源碼，直接看 SqlSessionFactory 的創(chuàng)建，如下，在設(shè)置 mapper-locations 的判斷處，打下斷點(diǎn)，進(jìn)行調(diào)試

并且將前面自定義創(chuàng)建的 SqlSessionFactory 的代碼注釋掉，application.yml 中配置 mapper-locations: classpath*:mapper/*Mapper.xml ，重新運(yùn)行，進(jìn)行源碼調(diào)試，發(fā)現(xiàn)上圖斷點(diǎn)的邏輯，沒有進(jìn)到 if 的判斷中去，調(diào)試的 MybatisPlusProperties 對(duì)象結(jié)果如下，

！！！What The Fuck！！！我配置的明明是 classpath*:mapper/*Mapper.xml ，怎么變成了 classpath:mapper/*Mapper.xml 可恨的是，我的思路有繞彎了！！！

懷疑：yml 的配置語法對(duì) classpath*:mapper/*Mapper.xml 解析有問題

我都服了我自己了，但確實(shí)是這次修改讓我找到了最后的答案，將原本的配置寫法改成了數(shù)組，寫法如下，

#mapper plusmybatis-plus: mapper-locations: [classpath*:mapper/*Mapper.xml]

因?yàn)閷?duì)這種配置格式也沒去深究，之前都是一對(duì)一的配置項(xiàng)，沒有嘗試過數(shù)組的寫法，所以上來就運(yùn)行報(bào)錯(cuò)了，但是報(bào)的是 application.yml 的語法格式有誤。所以，將值加上引號(hào)括起來，變成

#mapper plusmybatis-plus: mapper-locations: ['classpath*:mapper/*Mapper.xml']

重新運(yùn)行，發(fā)現(xiàn)竟然通過了！！！源碼調(diào)試的 mapperLocations 的值也是 classpath*:mapper/*Mapper.xml ，此時(shí)我以為找到了問題的所在了，就是 yml 的配置語法對(duì) classpath*:mapper/*Mapper.xml 解析有問題 我也對(duì)此深信不疑。

結(jié)論：開發(fā)工具沒有同步配置

在沒寫這筆記前，我還深信問題就是 yml 的語法對(duì)值帶有 冒號(hào) 的解析時(shí)，需要對(duì)值用 引號(hào) 包起來。但是在寫筆記做記錄的過程中，需要還原場(chǎng)景，在調(diào)試的時(shí)候，發(fā)現(xiàn)并沒有說 需要對(duì)帶有冒號(hào)的值加上引號(hào)包起來 ，這時(shí)我才想起來，會(huì)不會(huì)是 開發(fā)工具的問題，在運(yùn)行的時(shí)候，沒有把修改的配置文件同步上去 。經(jīng)過多次的調(diào)試，也證明了這點(diǎn)，有時(shí)候項(xiàng)目跑太久，開發(fā)工具就會(huì)突然出來發(fā)難。

搞了半天， 在 application.yml 的配置 classpath*:mapper/*Mapper.xml 是有效的！！！有效的！！！有效的！！！ 相當(dāng)于開發(fā)工具的作祟讓我白白浪費(fèi)了2天時(shí)間，但是期間也發(fā)現(xiàn)了自身的一下問題，太久沒有遇到錯(cuò)誤，一味的相信搜索引擎而不去思考，最后還差點(diǎn) 用錯(cuò)誤的認(rèn)識(shí)，否定了原本正確的東西 。

#mapper plusmybatis-plus: mapper-locations: classpath*:mapper/*Mapper.xml

在發(fā)現(xiàn) application.yml配置修改后沒生效的第一時(shí)間，我就應(yīng)該檢查發(fā)布路徑的文件，或者去調(diào)試源碼。中間浪費(fèi)太多的時(shí)間陷入盲目的必應(yīng)搜索答案，做筆記反省一下自己，安定就會(huì)退步，堅(jiān)持學(xué)習(xí)，永遠(yuǎn)不要放棄思考。

以上為個(gè)人經(jīng)驗(yàn)，希望能給大家一個(gè)參考，也希望大家多多支持好吧啦網(wǎng)。