簡介一套基于 Idea 2021 從零整合 Spring、SpringMVC 與 MyBatis 三大框架的源碼工程配套 Tomcat 9.0 與 MySQL 8.0.25 環(huán)境面向初學(xué) JavaWeb 的讀者以及需要快速搭建項(xiàng)目骨架的開發(fā)者重點(diǎn)解決框架整合、依賴沖突和基礎(chǔ)配置等常見問題。資源包共包含 105 個(gè)文件以 52 個(gè) jar 依賴庫、28 個(gè) xml 配置、10 個(gè)編譯后的 class 文件、5 個(gè) Java 源碼和 4 個(gè) JSP 頁面為主同時(shí)保留 properties、gitignore 等輔助文件整體大小約 22.34MB目錄按控制層、業(yè)務(wù)層、持久層劃分結(jié)構(gòu)清晰便于逐模塊閱讀和復(fù)用。累計(jì)已有三千一百三十五人學(xué)習(xí)使用是較常見的 SSM 入門參考。整個(gè)示例以圖書管理為業(yè)務(wù)場(chǎng)景實(shí)體類、數(shù)據(jù)訪問接口、業(yè)務(wù)服務(wù)與控制器的職責(zé)劃分清晰數(shù)據(jù)庫訪問映射、業(yè)務(wù)邏輯封裝與頁面交互均有體現(xiàn)關(guān)鍵配置文件也一并給出可幫助讀者繞開版本兼容問題快速獲得一套可運(yùn)行、可擴(kuò)展的 SSM 項(xiàng)目雛形。無論是課程設(shè)計(jì)、畢業(yè)設(shè)計(jì)還是日常練習(xí)都能從中獲得可直接參考的項(xiàng)目結(jié)構(gòu)。1. 從零搭SSM框架不是背配置是理解三個(gè)容器怎么協(xié)同很多人拿到一套SSM源碼第一反應(yīng)是打開百度搜“IDEA 2021 SSM搭建教程”然后跟著教程把a(bǔ)pplicationContext.xml、spring-mvc.xml、web.xml三個(gè)文件復(fù)制粘貼一遍項(xiàng)目跑起來就覺得自己會(huì)了。結(jié)果一旦遇到包名改動(dòng)、Mapper找不到、Controller 404立刻傻眼因?yàn)椴恢肋@三個(gè)配置文件之間到底是什么關(guān)系。這套源碼拆解筆記就是圍繞“根容器、子容器、Mapper代理”三條線來寫的先搞清楚Spring和SpringMVC各自管哪些Bean再理解MyBatis是怎么被掛進(jìn)Spring的最后用一份完整可跑通的工程源碼作為對(duì)照。適合剛過JavaWeb、準(zhǔn)備做畢設(shè)或第一次接觸企業(yè)級(jí)項(xiàng)目結(jié)構(gòu)的人也適合想快速搭一套可復(fù)用骨架的從業(yè)者。2. IDEA 2021里初始化工程版本選型與Maven Web骨架的落地細(xì)節(jié)2.1 JDK、Maven、Tomcat版本怎么選定SSM不是新技術(shù)但它對(duì)版本組合非常敏感。我見過有人用JDK 17去跑Spring 5的工程結(jié)果CGLIB代理直接報(bào)錯(cuò)也見過用Tomcat 10搭配javax.servlet寫的代碼啟動(dòng)就報(bào)ClassNotFound。搭建前先把版本邊界劃清楚能少踩一半坑。這套源碼基于的是經(jīng)典組合JDK 1.8、Maven 3.6.x、Tomcat 8.5或9.0、Spring 5.x、MyBatis 3.5.x。這個(gè)組合經(jīng)過大量項(xiàng)目驗(yàn)證兼容性最穩(wěn)。組件推薦版本關(guān)鍵說明JDK1.8SSM經(jīng)典組合CGLIB代理和JSP編譯都最穩(wěn)Maven3.6.xIDEA 2021內(nèi)置Maven 3建議用自帶的減少配置干擾Tomcat8.5 / 9.08.5以下不支持Servlet 4.09.0和javax.servlet命名兼容Spring5.2.x / 5.3.x5.3以下更穩(wěn)避免Lombok和JDK編譯器的邊際問題MyBatis3.5.x3.5以上才支持mapperLocations通配符的規(guī)范寫法MySQL驅(qū)動(dòng)8.0.xdriverClassName和URL都要換成cj前綴后面細(xì)說為什么不推薦JDK 11以上因?yàn)镮DEA 2021里Tomcat 8.5默認(rèn)的運(yùn)行參數(shù)還是基于JDK 8的高版本JDK會(huì)有模塊化限制比如java.xml.bind模塊缺失這類問題對(duì)新手來說排查成本太高。JDK 1.8 Tomcat 8.5這套組合雖然“老”但企業(yè)里存量項(xiàng)目大量還在用學(xué)它不吃虧。2.2 新建Maven Web工程的兩種姿勢(shì)IDEA 2021里新建Maven Web工程有兩條路。一條是用archetype-webapp骨架IDEA會(huì)自動(dòng)生成一個(gè)標(biāo)準(zhǔn)的Web目錄結(jié)構(gòu)另一條是建立一個(gè)普通Maven工程然后手動(dòng)在src/main下補(bǔ)出webapp目錄和WEB-INF/web.xml。我一般推薦第二條因?yàn)閍rchetype-webapp生成的web.xml是2.3版本的DOCTYPE還是Sun的舊寫法要么手動(dòng)替換要么得改servlet版本怎么看都繞路。直接建普通Maven工程再補(bǔ)目錄反而每一步都看得見。手動(dòng)補(bǔ)目錄之后web.xml需要手動(dòng)改成Servlet 4.0的規(guī)范寫法?xml version1.0 encodingUTF-8? web-app xmlnshttp://xmlns.jcp.org/xml/ns/javaee xmlns:xsihttp://www.w3.org/2001/XMLSchema-instance xsi:schemaLocationhttp://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-app_4_0.xsd version4.0 display-nameSSM Demo/display-name /web-app這里的重點(diǎn)是namespace從java.sun.com換成了xmlns.jcp.org這是Servlet 4.0之后的新規(guī)范。如果你用archetype-webapp骨架IDEA生成的是web-app_2_3.xsd的舊版頭啟動(dòng)時(shí)Tomcat雖然能兼容但部分注解掃描行為會(huì)有差異。我一般會(huì)直接刪掉舊文件重新寫省得后面排查時(shí)懷疑人生。2.3 pom.xml依賴清單與scope邊界依賴配置是整個(gè)工程的基石。SSM的依賴不算多但每個(gè)依賴的scope和傳遞關(guān)系都有講究。下面這一組是能跑通的最小集合properties spring.version5.3.9/spring.version mybatis.version3.5.7/mybatis.version mysql.version8.0.26/mysql.version /properties dependencies !-- Spring核心 -- dependency groupIdorg.springframework/groupId artifactIdspring-context/artifactId version${spring.version}/version /dependency !-- SpringMVC -- dependency groupIdorg.springframework/groupId artifactIdspring-webmvc/artifactId version${spring.version}/version /dependency !-- Spring JDBC - 事務(wù)管理依賴 -- dependency groupIdorg.springframework/groupId artifactIdspring-jdbc/artifactId version${spring.version}/version /dependency !-- MyBatis核心 -- dependency groupIdorg.mybatis/groupId artifactIdmybatis/artifactId version${mybatis.version}/version /dependency !-- MyBatis與Spring橋接 -- dependency groupIdorg.mybatis/groupId artifactIdmybatis-spring/artifactId version2.0.6/version /dependency !-- MySQL 8驅(qū)動(dòng) -- dependency groupIdmysql/groupId artifactIdmysql-connector-java/artifactId version${mysql.version}/version scoperuntime/scope /dependency !-- Servlet API編譯期需要運(yùn)行時(shí)容器提供 -- dependency groupIdjavax.servlet/groupId artifactIdjavax.servlet-api/artifactId version4.0.1/version scopeprovided/scope /dependency !-- JSTLJSP頁面里用c:forEach時(shí)依賴 -- dependency groupIdjavax.servlet/groupId artifactIdjstl/artifactId version1.2/version /dependency /dependencies這里有一個(gè)新手最容易犯的錯(cuò)誤javax.servlet-api的scope必須寫成provided意思是編譯和測(cè)試時(shí)用最終打包不進(jìn)去因?yàn)門omcat自己帶了Servlet容器實(shí)現(xiàn)。如果寫成默認(rèn)的compile打包出的war會(huì)把servlet-api也塞進(jìn)去和Tomcat自帶的沖突輕則報(bào)警告重則啟動(dòng)時(shí)方法簽名對(duì)不上。mysql-connector-java用runtime就夠因?yàn)榇a里不直接引用驅(qū)動(dòng)類只在運(yùn)行期通過DriverManager加載。另外spring-jdbc這個(gè)依賴很多人會(huì)漏掉。搭建SSM時(shí)事務(wù)管理器用的是DataSourceTransactionManager這個(gè)類在spring-jdbc里只引spring-context和spring-webmvc是不夠的。我第一次搭的時(shí)候就是漏了這個(gè)Spring容器啟動(dòng)報(bào)BeanDefinitionStoreException找了半天才想起來事務(wù)相關(guān)類不歸spring-context管。3. Spring與SpringMVC容器分工請(qǐng)求是從哪一步真正進(jìn)到Controller的3.1 web.xml里配置兩個(gè)容器SSM體系里有兩個(gè)Spring容器這是理解整套配置文件的關(guān)鍵。一個(gè)是ContextLoaderListener創(chuàng)建的根容器負(fù)責(zé)加載Service、Dao這些業(yè)務(wù)組件另一個(gè)是DispatcherServlet創(chuàng)建的SpringMVC子容器只負(fù)責(zé)Controller和Web層組件。兩個(gè)容器是父子關(guān)系子容器能看見父容器里的Bean但父容器看不見子容器的Bean。!-- 根容器加載applicationContext.xml -- context-param param-namecontextConfigLocation/param-name param-valueclasspath:applicationContext.xml/param-value /context-param listener listener-classorg.springframework.web.context.ContextLoaderListener/listener-class /listener !-- SpringMVC子容器 -- servlet servlet-namedispatcher/servlet-name servlet-classorg.springframework.web.servlet.DispatcherServlet/servlet-class init-param param-namecontextConfigLocation/param-name param-valueclasspath:spring-mvc.xml/param-value /init-param load-on-startup1/load-on-startup /servlet servlet-mapping servlet-namedispatcher/servlet-name url-pattern//url-pattern /servlet-mappingdispatcher的url-pattern這里是單個(gè)斜杠表示除了JSP之外的所有請(qǐng)求都交給SpringMVC處理。load-on-startup設(shè)為1意思是Tomcat啟動(dòng)時(shí)立即初始化這個(gè)Servlet而不是等第一個(gè)請(qǐng)求進(jìn)來再初始化。如果不寫這一行第一次訪問頁面會(huì)明顯卡頓因?yàn)镈ispatcherServlet的初始化動(dòng)作被推遲到了運(yùn)行時(shí)。邏輯說明ApplicationContext.xml是根容器spring-mvc.xml是子容器。DispatcherServlet啟動(dòng)時(shí)先檢查有沒有已存在的根容器有就把它設(shè)為自己的父容器。這樣Controller里注入Service時(shí)Spring會(huì)先在子容器找找不到再從父容器里取。3.2 根容器配置只掃Service和Dao?xml version1.0 encodingUTF-8? beans xmlnshttp://www.springframework.org/schema/beans xmlns:contexthttp://www.springframework.org/schema/context xmlns:xsihttp://www.w3.org/2001/XMLSchema-instance xsi:schemaLocationhttp://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context.xsd !-- 根容器掃描Service和Dao排除Controller -- context:component-scan base-packagecom.demo.ssm context:exclude-filter typeannotation expressionorg.springframework.stereotype.Controller/ /context:component-scan /beans這段配置的核心是exclude-filter。根容器把整個(gè)業(yè)務(wù)包都掃了但明確排除了標(biāo)注Controller的類。為什么要排除如果根容器把Controller也注冊(cè)了SpringMVC子容器再掃一遍就會(huì)出現(xiàn)同一類型兩個(gè)Bean定義的情況某些AOP代理邏輯會(huì)變得非常詭異。另外如果根容器掃描了Controller而事務(wù)AOP切在Service上有時(shí)候會(huì)出現(xiàn)代理對(duì)象可見性異常。所以這個(gè)排除動(dòng)作不是可有可無而是必須寫。3.3 子容器配置注解驅(qū)動(dòng)、Controller掃描與靜態(tài)資源放行spring-mvc.xml是SpringMVC的核心也是這個(gè)框架里配置項(xiàng)最多的地方?xml version1.0 encodingUTF-8? beans xmlnshttp://www.springframework.org/schema/beans xmlns:contexthttp://www.springframework.org/schema/context xmlns:mvchttp://www.springframework.org/schema/mvc xmlns:xsihttp://www.w3.org/2001/XMLSchema-instance xsi:schemaLocationhttp://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context.xsd http://www.springframework.org/schema/mvc http://www.springframework.org/schema/mvc/spring-mvc.xsd !-- 子容器只掃描Controller -- context:component-scan base-packagecom.demo.ssm.controller/ !-- 開啟注解驅(qū)動(dòng)ResponseBody、RequestBody等 -- mvc:annotation-driven/ !-- 靜態(tài)資源放行 -- mvc:default-servlet-handler/ !-- 視圖解析器 -- bean classorg.springframework.web.servlet.view.InternalResourceViewResolver property nameprefix value/WEB-INF/views// property namesuffix value.jsp/ /bean /beansmvc:annotation-driven/ 是這一節(jié)里最值錢的一行配置。它默認(rèn)注冊(cè)了RequestMappingHandlerAdapter和RequestMappingHandlerMapping沒有它RequestMapping注解是不生效的。很多從舊教程抄代碼的人會(huì)漏掉這一行然后Controller無論如何都進(jìn)不去。mvc:default-servlet-handler/ 的作用是把那些沒匹配到Controller的請(qǐng)求交給Tomcat默認(rèn)的Servlet處理。因?yàn)镈ispatcherServlet攔截了/如果請(qǐng)求的是一個(gè)圖片或者靜態(tài)CSS文件而你沒有這個(gè)配置就會(huì)404。加了它SpringMVC在自身Handler映射找不到時(shí)自動(dòng)放行給容器默認(rèn)Servlet。視圖解析器里的prefix指向/WEB-INF/views/把JSP頁面放在WEB-INF下這是安全習(xí)慣。WEB-INF下的文件不能通過瀏覽器直接URL訪問必須由Controller轉(zhuǎn)發(fā)打開這樣可以防止有人繞過權(quán)限直接看JSP源碼。這里有一個(gè)經(jīng)典坑很多人把視圖解析器配成/和.jsp但如果請(qǐng)求路徑里有目錄層級(jí)比如/user/list視圖解析器會(huì)拼出/WEB-INF/views//user/list.jsp。路徑雙斜杠在Windows上沒問題Linux上Tomcat的某些版本會(huì)報(bào)404。我習(xí)慣在prefix末尾加/同時(shí)保證跳轉(zhuǎn)代碼里不要手寫前導(dǎo)斜杠的視圖名。4. 把MyBatis掛進(jìn)Spring數(shù)據(jù)源、Mapper代理與事務(wù)三條線的拼裝順序4.1 數(shù)據(jù)源與連接池參數(shù)MyBatis本身不管數(shù)據(jù)庫連接它需要一個(gè)DataSource提供物理連接。SSM里最常見的搭配是Alibaba Druid連接池因?yàn)樗鼛ПO(jiān)控頁面參數(shù)語義也清楚。先把數(shù)據(jù)庫連接信息抽到外部properties文件里# jdbc.properties jdbc.drivercom.mysql.cj.jdbc.Driver jdbc.urljdbc:mysql://localhost:3306/ssm_demo?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/ShanghaiuseSSLfalseallowPublicKeyRetrievaltrue jdbc.usernameroot jdbc.password123456jdbc.url這段有兩個(gè)參數(shù)值得展開說。serverTimezoneAsia/Shanghai是因?yàn)镸ySQL 8的時(shí)區(qū)默認(rèn)是UTC不加這個(gè)Java里的日期和數(shù)據(jù)庫里的日期對(duì)不上差8個(gè)小時(shí)。allowPublicKeyRetrievaltrue是MySQL 8.0.4之后的驅(qū)動(dòng)行為變化不使用SSL連接時(shí)如果沒有這個(gè)參數(shù)首次連接會(huì)報(bào)Public Key Retrieval is not allowed。這兩個(gè)參數(shù)是MySQL 8連接特有的坑用MySQL 5.x驅(qū)動(dòng)根本不會(huì)遇到所以網(wǎng)上舊教程里沒有。在applicationContext.xml里加載這個(gè)properties并配置Druid數(shù)據(jù)源context:property-placeholder locationclasspath:jdbc.properties/ bean iddataSource classcom.alibaba.druid.pool.DruidDataSource init-methodinit destroy-methodclose property namedriverClassName value${jdbc.driver}/ property nameurl value${jdbc.url}/ property nameusername value${jdbc.username}/ property namepassword value${jdbc.password}/ /beancontext:property-placeholder負(fù)責(zé)把jdbc.properties里的鍵值對(duì)加載進(jìn)Spring上下文之后用${}占位符引用。init-method和destroy-method分別指定連接池初始化和關(guān)閉時(shí)調(diào)用的方法。Druid自己維護(hù)了一組連接在Spring容器啟動(dòng)時(shí)預(yù)創(chuàng)建部分連接銷毀時(shí)主動(dòng)關(guān)閉避免連接泄漏。4.2 SqlSessionFactory與Mapper代理掃描MyBatis要接入Spring關(guān)鍵人物是SqlSessionFactoryBean。它替代了原生MyBatis里SqlSessionFactoryBuilder的工作把數(shù)據(jù)源和Mapper映射文件揉進(jìn)同一個(gè)工廠里bean idsqlSessionFactory classorg.mybatis.spring.SqlSessionFactoryBean property namedataSource refdataSource/ property nametypeAliasesPackage valuecom.demo.ssm.pojo/ property namemapperLocations valueclasspath:mapper/*.xml/ /bean bean classorg.mybatis.spring.mapper.MapperScannerConfigurer property namebasePackage valuecom.demo.ssm.dao/ property namesqlSessionFactoryBeanName valuesqlSessionFactory/ /beantypeAliasesPackage配置了一個(gè)包路徑MyBatis會(huì)自動(dòng)把這個(gè)包下的POJO類注冊(cè)為別名默認(rèn)別名是類名的首字母小寫形式。這樣在Mapper XML文件里寫resultTypeUser就夠了不用寫全限定名。mapperLocations指向了classpath:mapper/目錄所有Mapper XML文件放這個(gè)目錄下。MapperScannerConfigurer是MyBatis-Spring橋接包里最精巧的設(shè)計(jì)。它掃描basePackage包下所有接口然后為每個(gè)接口生成一個(gè)動(dòng)態(tài)代理對(duì)象注冊(cè)進(jìn)Spring容器。這意味著你不需要自己寫Dao實(shí)現(xiàn)類。它還有一個(gè)細(xì)節(jié)就是用sqlSessionFactoryBeanName屬性而不是sqlSessionFactory的ref引用。如果用refSpring會(huì)因?yàn)锽ean創(chuàng)建順序問題在某些場(chǎng)景下提前初始化sqlSessionFactory導(dǎo)致property-placeholder引用失效。用BeanName字符串延遲查找是官方推薦的做法也能避開啟動(dòng)時(shí)序的玄學(xué)問題。4.3 事務(wù)管理的兩種落地方式SSM里事務(wù)管理的標(biāo)準(zhǔn)做法是聲明式事務(wù)把事務(wù)邊界和業(yè)務(wù)代碼解耦。有兩種配置路徑一種是tx:advice aop:config切面織入一種是直接在Service類或方法上打Transactional注解。我傾向于用aop:config切面方式因?yàn)槭聞?wù)規(guī)則集中在一處業(yè)務(wù)代碼里不需要滿屏注解bean idtransactionManager classorg.springframework.jdbc.datasource.DataSourceTransactionManager property namedataSource refdataSource/ /bean tx:advice idtxAdvice transaction-managertransactionManager tx:attributes tx:method nameget* read-onlytrue propagationSUPPORTS/ tx:method nameselect* read-onlytrue propagationSUPPORTS/ tx:method nameinsert* propagationREQUIRED/ tx:method nameupdate* propagationREQUIRED/ tx:method namedelete* propagationREQUIRED/ tx:method name* propagationREQUIRED/ /tx:attributes /tx:advice aop:config aop:pointcut idservicePointcut expressionexecution(* com.demo.ssm.service..*.*(..))/ aop:advisor advice-reftxAdvice pointcut-refservicePointcut/ /aop:configDataSourceTransactionManager需要注入同一個(gè)dataSource對(duì)象因?yàn)槭聞?wù)的核心是Connection綁定如果事務(wù)管理器和SessionFactory用的數(shù)據(jù)源不是同一個(gè)事務(wù)會(huì)靜默失效數(shù)據(jù)照常寫入但回滾不生效。這也是SSM里一個(gè)很隱蔽的坑。tx:method的配置規(guī)則是按方法名匹配。get和select開頭的方法設(shè)為read-onlytruepropagationSUPPORTS意思是已有事務(wù)就加入沒有就不開新事務(wù)。insert、update、delete用REQUIRED當(dāng)前沒有事務(wù)就新建一個(gè)。aop:pointcut的expression表達(dá)式里com.demo.ssm.service...前兩個(gè)點(diǎn)代表service包下所有子包后一個(gè)*是方法名通配括號(hào)里的兩個(gè)點(diǎn)代表任意參數(shù)。這套表達(dá)式是AspectJ切點(diǎn)語法的基礎(chǔ)換包名時(shí)必須同步修改這里。5. 踩坑排查搭建SSM時(shí)最容易翻車的五個(gè)典型故障5.1 Controller配了注解還是404DispatcherServlet攔截路徑寫錯(cuò)了現(xiàn)象Controller類加了Controller和RequestMapping啟動(dòng)日志里能看到SpringMVC的RequestMappingHandlerMapping注冊(cè)了路徑但瀏覽器訪問時(shí)Tomcat返回404而且控制臺(tái)沒有任何報(bào)錯(cuò)。原因看web.xml里的servlet-mapping十有八九寫成了/*。/*和/的區(qū)別在于/會(huì)交給SpringMVC處理但不會(huì)攔截JSP/*會(huì)攔截所有請(qǐng)求包括JSP的請(qǐng)求。當(dāng)視圖解析器返回一個(gè)JSP路徑時(shí)請(qǐng)求會(huì)被DispatcherServlet再次攔截它找不到這個(gè)JSP對(duì)應(yīng)的Handler直接404。解決把servlet-mapping的url-pattern改回/。改完后請(qǐng)求流程變成Controller返回邏輯視圖名視圖解析器拼出物理路徑Tomcat直接處理JSP資源不再經(jīng)過DispatcherServlet。5.2 注解掃描范圍重疊導(dǎo)致MVC失效現(xiàn)象Controller里的ResponseBody返回JSON數(shù)據(jù)瀏覽器拿到的是中文亂碼或者干脆報(bào)406錯(cuò)誤。還有一種表現(xiàn)是Controller方法正常執(zhí)行但所有RequestMapping都失效。原因有的教程會(huì)在applicationContext.xml里不加排除兩個(gè)容器都掃了Controller。根容器注冊(cè)的Controller使用的是根容器里的消息轉(zhuǎn)換器它沒有加載SpringMVC的注解驅(qū)動(dòng)配置所以ResponseBody的工作不正常。這種“雙重注冊(cè)”問題特別難查因?yàn)橄到y(tǒng)不報(bào)錯(cuò)只是行為不對(duì)。解決嚴(yán)格遵循第3章的配置邊界。根容器排除Controller子容器只掃Controller包。如果你發(fā)現(xiàn)項(xiàng)目里已經(jīng)有重疊掃描把a(bǔ)pplicationContext.xml里的component-scan補(bǔ)上exclude-filter重啟后重新測(cè)試。從那以后我每次新起工程都會(huì)檢查一遍兩個(gè)文件的掃描路徑這個(gè)習(xí)慣救過我好幾次。5.3 Mapper接口報(bào)綁定異常類型不匹配的經(jīng)典報(bào)錯(cuò)現(xiàn)象項(xiàng)目啟動(dòng)正常但第一次調(diào)用某個(gè)Mapper方法時(shí)拋出org.apache.ibatis.binding.BindingException: Invalid bound statement (not found)提示某個(gè)接口找不到對(duì)應(yīng)的SQL語句。原因三層原因按頻率排序。第一Mapper接口和Mapper XML文件的namespace不匹配接口的全限定名和namespace必須完全一致少一個(gè)點(diǎn)都不行。第二Mapper XML文件沒有放在mapperLocations指定目錄下很多新手把UserMapper.xml放在java源碼目錄里打包后目標(biāo)目錄下根本沒有這個(gè)文件。第三Mapper接口里的方法名和XML里statement的id對(duì)不上。解決先確認(rèn)applicationContext.xml里mapperLocations的路徑是classpath:mapper/*.xml然后檢查target/classes/mapper目錄下有沒有對(duì)應(yīng)的xml文件。如果文件不在去pom.xml里的build配置里看是否排除了resources目錄下的xml。IDEA里Maven默認(rèn)不打包src/main/java下的xml所以一個(gè)穩(wěn)妥做法是把Mapper XML放在src/main/resources/mapper目錄下而不是和接口放一起。namespace、id、接口名三項(xiàng)逐一比對(duì)這個(gè)檢查習(xí)慣我從那以后一直保留著。5.4 本地啟動(dòng)正常部署后報(bào)ClassNotFound現(xiàn)象IDEA里跑Tomcat一切正常但把war包丟到獨(dú)立部署目錄里啟動(dòng)報(bào)NoClassDefFoundError或者某個(gè)類找不到。原因IDEA里運(yùn)行項(xiàng)目時(shí)它用的是自己合成Artifacts會(huì)把編譯輸出目錄和依賴jar包都加入classpath。但如果你打包war時(shí)IDEA的Artifacts輸出布局里沒有正確包含所有l(wèi)ib那么部署后就會(huì)缺依賴。我自己遇到過Druid和mybatis-spring兩個(gè)jar包莫名缺失的情況因?yàn)锳rtifacts的Output Layout里lib目錄只手動(dòng)加了一部分依賴。解決在Project Structure里找到Artifacts選中war exploded打開Output Layout查看WEB-INF/lib下是否所有依賴都在。通常做法是選中Available Elements里的所有jar包右鍵Put into /WEB-INF/lib。避免這個(gè)問題的方法是不要手動(dòng)管理lib而是讓IDEA自動(dòng)把所有依賴都打包進(jìn)去盡量別在pom里使用system scope的本地jar這類依賴IDEA有時(shí)不會(huì)自動(dòng)加入war。5.5 MySQL 8.0連接失敗驅(qū)動(dòng)類名與URL參數(shù)換了現(xiàn)象啟動(dòng)時(shí)Druid連接池報(bào)錯(cuò)Caused by: java.sql.SQLException: Unable to load authentication plugin caching_sha2_password或者Access denied for user。原因MySQL 8.0的默認(rèn)認(rèn)證插件是caching_sha2_password而MySQL 5.x時(shí)代的驅(qū)動(dòng)和連接方式都不認(rèn)。很多人還在用5.1.46版本的驅(qū)動(dòng)類com.mysql.jdbc.Driver這款驅(qū)動(dòng)和8.0服務(wù)端握手時(shí)會(huì)崩。另外就是之前提到的serverTimezone參數(shù)缺失會(huì)報(bào)時(shí)區(qū)異常。解決把驅(qū)動(dòng)類換成com.mysql.cj.jdbc.DriverMySQL Connector版本升到8.0.x。URL里加上serverTimezoneAsia/Shanghai和useSSLfalse。如果認(rèn)證還報(bào)錯(cuò)檢查allowPublicKeyRetrievaltrue是否加上這是客戶端首次連接時(shí)獲取RSA公鑰的開關(guān)。這五個(gè)參數(shù)是MySQL 8連接的標(biāo)準(zhǔn)配置組合少了任何一個(gè)都會(huì)在特定環(huán)境下翻車。6. 把SSM骨架沉淀成腳手架改包名、抽參數(shù)、留文檔三件套搭建完一次SSM工程之后最有價(jià)值的產(chǎn)出不是跑通的Demo而是一套能反復(fù)使用的骨架。我一般的做法是把這套源碼整理成腳手架目錄下次開新項(xiàng)目時(shí)直接復(fù)制過去然后做三件事改包名、抽參數(shù)、補(bǔ)充項(xiàng)目說明。改包名這一步很多人用IDE的重構(gòu)功能但I(xiàn)DEA對(duì)全包名替換有時(shí)會(huì)漏resources目錄下的配置。我習(xí)慣寫一個(gè)簡單的bash腳本把java目錄、resources目錄里所有出現(xiàn)舊包名的地方一次性替換#!/bin/bash # 用法: ./replace-package.sh 舊包名.路徑 新包名.路徑 項(xiàng)目根目錄 OLD_PKG$1 NEW_PKG$2 ROOT$3 # 把包名中的點(diǎn)轉(zhuǎn)換為路徑斜杠 OLD_PATH$(echo $OLD_PKG | tr . /) NEW_PATH$(echo $NEW_PKG | tr . /) # 遍歷java與resources目錄下所有文件 find $ROOT/src -type f \( -name *.java -o -name *.xml -o -name *.properties \) | while read FILE; do # 先替換文本內(nèi)容 sed -i s/$OLD_PKG/$NEW_PKG/g $FILE # 再處理目錄結(jié)構(gòu) DIR$(dirname $FILE) if echo $DIR | grep -q $OLD_PATH; then NEW_DIR$(echo $DIR | sed s|$OLD_PATH|$NEW_PATH|g) mkdir -p $NEW_DIR mv $FILE $NEW_DIR/ fi done echo 包名替換完成請(qǐng)檢查git diff確認(rèn)改動(dòng)范圍邏輯說明這個(gè)腳本先處理文件內(nèi)容里的全限定名再把文件移動(dòng)到新路徑對(duì)應(yīng)的目錄里。關(guān)鍵點(diǎn)是內(nèi)容替換和目錄移動(dòng)必須順序執(zhí)行如果先移動(dòng)目錄find的路徑會(huì)失效。參數(shù)說明第一個(gè)參數(shù)是舊包名第二個(gè)是新包名第三個(gè)是項(xiàng)目根目錄。如果包名出現(xiàn)在JSP頁面的page import標(biāo)簽里這個(gè)腳本覆蓋不到需要手動(dòng)補(bǔ)一遍。抽參數(shù)這件事更有價(jià)值。把多個(gè)配置文件里反復(fù)出現(xiàn)的值統(tǒng)一抽到properties里比如數(shù)據(jù)庫地址、上傳路徑、日志級(jí)別。下次切換環(huán)境時(shí)只需要改一個(gè)文件。預(yù)留一份參數(shù)對(duì)照表在項(xiàng)目根目錄寫清楚每個(gè)配置項(xiàng)在哪個(gè)文件里生效這是我被環(huán)境切換折磨過幾次后形成的習(xí)慣。比如Druid的initialSize、maxActive這些參數(shù)不同環(huán)境有不同的最優(yōu)值沒有對(duì)照表就等于黑匣子。從那以后我每次開新工程都強(qiáng)制走一遍“復(fù)制骨架、替換包名、跑通冒煙接口”這三步不跑通不許往下寫業(yè)務(wù)。某個(gè)同事曾經(jīng)跳過第一步直接改包名結(jié)果配置文件里的Mapper掃描路徑全部失效花了整整一個(gè)下午排查。這個(gè)過程讓我養(yǎng)成了凡事先把地基打牢的習(xí)慣希望幫到你。本文還有配套的精品資源點(diǎn)擊獲取