簡(jiǎn)介基于SSM框架的圖書管理系統(tǒng)完整項(xiàng)目適合正在學(xué)習(xí)Java Web進(jìn)階知識(shí)或準(zhǔn)備課程設(shè)計(jì)、畢業(yè)設(shè)計(jì)的開(kāi)發(fā)者。系統(tǒng)在業(yè)務(wù)上覆蓋權(quán)限登錄、讀者管理、圖書借閱與歸還、郵件通知、答題互動(dòng)等模塊技術(shù)上則貫穿Spring依賴注入、SpringMVC請(qǐng)求調(diào)度、MyBatis動(dòng)態(tài)SQL配置可直觀看到三大框架如何協(xié)作完成業(yè)務(wù)鏈路。資源包共三個(gè)文件包括工程源碼、使用手冊(cè)以及數(shù)據(jù)庫(kù)初始化腳本前者幫助分析代碼結(jié)構(gòu)與配置后兩者提供運(yùn)行環(huán)境和數(shù)據(jù)準(zhǔn)備整體壓縮包約九十一兆字節(jié)。目前已有三千二百五十四人學(xué)習(xí)下載是不少學(xué)習(xí)者參考過(guò)的整合案例。對(duì)讀者而言通過(guò)閱讀源碼可理清分層架構(gòu)、攔截器與事務(wù)控制等關(guān)鍵點(diǎn)配合手冊(cè)與腳本還能快速搭建運(yùn)行環(huán)境并進(jìn)行二次開(kāi)發(fā)能有效縮短從理論到實(shí)踐的距離。1. ssm框架的圖書管理系統(tǒng)值得下手的第一個(gè)理由它是SSM整合的完整范本如果你正在找一套能跑通的 SSM 圖書管理系統(tǒng)大概率不是為了“看看書怎么管理”而是想弄明白 Spring、SpringMVC、MyBatis 這三個(gè)框架在一個(gè)真實(shí)項(xiàng)目里到底怎么互相配合。這套系統(tǒng)的核心價(jià)值在于它不是一個(gè)只貼了 CRUD 代碼的 demo而是一個(gè)把配置、分層、請(qǐng)求流轉(zhuǎn)、數(shù)據(jù)庫(kù)操作全部串起來(lái)的標(biāo)準(zhǔn)工程。前端由 JSP 渲染頁(yè)面后端按 Controller-Service-Mapper 三層切分你用任何一個(gè) IDE 導(dǎo)入后都能啟動(dòng)、訪問(wèn)、斷點(diǎn)調(diào)試。適合三類人正在做畢業(yè)設(shè)計(jì)或課程實(shí)訓(xùn)的學(xué)生、想從 Servlet 轉(zhuǎn)向 SSM 整合的進(jìn)階開(kāi)發(fā)者、以及需要一套基礎(chǔ)代碼做二次開(kāi)發(fā)比如增加借閱規(guī)則、讀者管理的人。接下來(lái)我們先把它的工程骨架拆開(kāi)。2. SSM 整合骨架從項(xiàng)目結(jié)構(gòu)看懂 Spring SpringMVC MyBatis 的分工SSM 整合最大的門檻不是某一個(gè)框架難學(xué)而是三者疊加后“誰(shuí)負(fù)責(zé)什么、配置寫在哪、啟動(dòng)時(shí)加載順序如何”容易混淆。這套圖書管理系統(tǒng)的工程結(jié)構(gòu)按功能分包從根目錄就能看出框架職責(zé)Spring 管業(yè)務(wù)與數(shù)據(jù)、SpringMVC 管請(qǐng)求路由、MyBatis 管數(shù)據(jù)庫(kù)訪問(wèn)。2.1 項(xiàng)目目錄設(shè)計(jì)與分層原則這個(gè)圖書管理項(xiàng)目采用標(biāo)準(zhǔn)的 Maven Web 工程結(jié)構(gòu)。所謂“標(biāo)準(zhǔn)”指主包下按 controller、service、dao、entity或 pojo四層分包c(diǎn)ontroller 處理頁(yè)面請(qǐng)求和參數(shù)綁定service 做業(yè)務(wù)邏輯如借書校驗(yàn)、庫(kù)存扣減dao 即 MyBatis 的 Mapper 接口負(fù)責(zé) SQL 操作entity 對(duì)應(yīng)數(shù)據(jù)庫(kù)表。JSP 頁(yè)面放在 src/main/webapp/WEB-INF 下靜態(tài)資源如 css、js、圖片放 webapp/static這樣通過(guò)攔截器放行時(shí)路徑也容易管理。src/main/java/com/example/library ├── controller // BookController、UserController、BorrowController ├── service // BookService 接口 Impl 實(shí)現(xiàn)類 ├── dao // BookMapper、UserMapper、BorrowMapper ├── entity // Book、User、BorrowRecord └── common // 統(tǒng)一返回結(jié)果、分頁(yè)對(duì)象、異常處理 src/main/resources ├── mybatis // MyBatis 配置文件 ├── mapper // BookMapper.xml、UserMapper.xml 等 └── spring // applicationContext.xml、spring-mvc.xml src/main/webapp ├── WEB-INF │ ├── jsp // 圖書列表、借閱記錄、登錄頁(yè) │ └── web.xml └── static // css、js、images分包邏輯的出發(fā)點(diǎn)是讓每一層的依賴方向自上而下controller 調(diào) service、service 調(diào) mapper不反向引用。實(shí)際開(kāi)發(fā)中改動(dòng)最多的是 service 層因?yàn)榻钑紤]圖書庫(kù)存與用戶借閱上限還書要考慮逾期天數(shù)這類業(yè)務(wù)規(guī)則必須沉淀在 service 而不是 controller否則后期改需求會(huì)很痛。這套項(xiàng)目的 dao 層以接口加 XML 的方式定義實(shí)體類與表字段一一對(duì)應(yīng)。2.2 核心配置職責(zé)applicationContext.xml、spring-mvc.xml 與 web.xml 的邊界SSM 整合里最容易翻車的是“配置寫錯(cuò)文件”。web.xml 是整個(gè) Web 應(yīng)用的入口它負(fù)責(zé)啟動(dòng) Spring 容器和 SpringMVC 容器。這里有一個(gè)關(guān)鍵約定applicationContext.xml 配置 Spring 的全局內(nèi)容包括數(shù)據(jù)源、事務(wù)管理器、MyBatis 的 SqlSessionFactory、Service 層的掃描spring-mvc.xml 只配置與 MVC 相關(guān)的內(nèi)容包括 Controller 組件掃描、視圖解析器、靜態(tài)資源放行。兩者不能混為一談。!-- web.xml配置 Spring 與 SpringMVC 的加載 -- context-param param-namecontextConfigLocation/param-name param-valueclasspath:spring/applicationContext.xml/param-value /context-param listener listener-classorg.springframework.web.context.ContextLoaderListener/listener-class /listener servlet servlet-namedispatcher/servlet-name servlet-classorg.springframework.web.servlet.DispatcherServlet/servlet-class init-param param-namecontextConfigLocation/param-name param-valueclasspath:spring/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-mapping核心邏輯是 DispatcherServlet 攔截所有請(qǐng)求/再把請(qǐng)求交給 spring-mvc.xml 中定義的 HandlerMapping 定位到具體 Controller 方法。load-on-startup設(shè) 1 表示容器啟動(dòng)時(shí)就創(chuàng)建 DispatcherServlet而不是等第一個(gè)請(qǐng)求到達(dá)才初始化這對(duì)排查啟動(dòng)報(bào)錯(cuò)很重要。在 spring-mvc.xml 中只做三件事context:component-scan base-packagecom.example.library.controller/、配置視圖解析器指定 JSP 路徑前綴與后綴以及放行靜態(tài)資源。applicationContext.xml 則配置數(shù)據(jù)源如 MySQL 的連接地址、賬號(hào)密碼、SqlSessionFactoryBean 的 Mapper 文件位置、事務(wù)管理器并且context:component-scan base-packagecom.example.library.service/只掃描 service 與 dao。如果掃描范圍重疊或者全用默認(rèn)掃描輕則 Bean 重復(fù)重則事務(wù)注解失效這一點(diǎn)在后文避坑章節(jié)細(xì)說(shuō)。2.3 用 Maven 拉依賴pom.xml 版本選擇與沖突排查SSM 項(xiàng)目依賴多版本匹配是啟動(dòng)階段最折磨人的點(diǎn)。我的習(xí)慣是先用 Maven 統(tǒng)一管理版本spring 相關(guān)的四個(gè)核心包spring-core、spring-webmvc、spring-jdbc、spring-tx必須保持相同版本否則會(huì)出現(xiàn)類加載沖突或 NoSuchMethodError。數(shù)據(jù)庫(kù)驅(qū)動(dòng)、MyBatis 與 mybatis-spring 橋接包的版本也要匹配MyBatis 3.4.x 配合 mybatis-spring 1.3.x 可正常運(yùn)行如果換成 mybatis-spring 2.x搭配方式基本不變但要注意官方包路徑調(diào)整。!-- pom.xml 關(guān)鍵依賴版本以 BOM 或 properties 統(tǒng)一控制 -- properties spring.version5.2.22.RELEASE/spring.version mybatis.version3.5.6/mybatis.version /properties dependencies dependency groupIdorg.springframework/groupId artifactIdspring-webmvc/artifactId version${spring.version}/version /dependency dependency groupIdorg.mybatis/groupId artifactIdmybatis/artifactId version${mybatis.version}/version /dependency dependency groupIdorg.mybatis/groupId artifactIdmybatis-spring/artifactId version2.0.6/version /dependency dependency groupIdmysql/groupId artifactIdmysql-connector-java/artifactId version8.0.29/version /dependency dependency groupIdcom.github.pagehelper/groupId artifactIdpagehelper-spring-boot-starter/artifactId version1.4.2/version /dependency /dependencies注意 PageHelper 的 starter 是 Spring Boot 版本若在傳統(tǒng) SSM 中使用應(yīng)引入pagehelper核心包并在 MyBatis 配置中追加插件否則分頁(yè)不生效。依賴沖突排查的做法啟動(dòng)時(shí)若出現(xiàn) ClassNotFoundException先執(zhí)行mvn dependency:tree看是否存在兩個(gè)版本的 spring-web出現(xiàn)Invalid bound statement則檢查 Mapper XML 路徑是否在編譯后存在于 classes 目錄以及 mapper 接口是否被包掃描覆蓋。3. 數(shù)據(jù)庫(kù)設(shè)計(jì)與圖書 CRUD 落地從建表到 Mapper 映射圖書管理系統(tǒng)最核心的資產(chǎn)是數(shù)據(jù)模型。很多學(xué)習(xí)者拿到項(xiàng)目直接改代碼卻忽略表設(shè)計(jì)決定業(yè)務(wù)實(shí)現(xiàn)難度這一前提。這套系統(tǒng)的表數(shù)量不多通常就圖書表、讀者/用戶表、借閱記錄表外鍵關(guān)系盡量用邏輯關(guān)聯(lián)而不是物理外鍵項(xiàng)目跑起來(lái)更省心。3.1 圖書管理系統(tǒng)的數(shù)據(jù)模型book、user、borrow_record 三表結(jié)構(gòu)這張三表模型幾乎覆蓋進(jìn)銷存和借閱管理的基本形態(tài)。圖書表負(fù)責(zé)存靜態(tài)信息用戶表存讀者資料借閱記錄表承擔(dān)借書/還書的狀態(tài)流轉(zhuǎn)。設(shè)計(jì)時(shí)注意圖書表要有獨(dú)立的邏輯刪除字段deleted而不是物理刪除記錄。借閱記錄表要有borrow_time和return_time其中return_time允許為空空值表示尚未歸還這是后續(xù)統(tǒng)計(jì)逾期與在借數(shù)量的判斷依據(jù)。CREATE TABLE book ( id INT NOT NULL AUTO_INCREMENT, isbn VARCHAR(20) DEFAULT NULL, book_name VARCHAR(100) NOT NULL, author VARCHAR(50) DEFAULT NULL, publisher VARCHAR(80) DEFAULT NULL, category VARCHAR(30) DEFAULT NULL, stock INT DEFAULT 1 COMMENT 館藏?cái)?shù)量, borrowed_count INT DEFAULT 0 COMMENT 已借出數(shù)量, deleted TINYINT DEFAULT 0 COMMENT 0未刪1已刪, PRIMARY KEY (id), KEY idx_book_name (book_name) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; CREATE TABLE user ( id INT NOT NULL AUTO_INCREMENT, username VARCHAR(50) NOT NULL, password VARCHAR(64) NOT NULL COMMENT 加密后密碼, real_name VARCHAR(30) DEFAULT NULL, max_borrow INT DEFAULT 5 COMMENT 最大借閱數(shù)量, PRIMARY KEY (id), UNIQUE KEY uk_username (username) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; CREATE TABLE borrow_record ( id INT NOT NULL AUTO_INCREMENT, book_id INT NOT NULL, user_id INT NOT NULL, borrow_time DATETIME NOT NULL, return_time DATETIME DEFAULT NULL, PRIMARY KEY (id), KEY idx_book_user (book_id,user_id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;兩個(gè)細(xì)節(jié)值得注意stock表示館藏總量borrowed_count表示當(dāng)前已借出數(shù)量實(shí)際可借數(shù)量通過(guò)stock - borrowed_count計(jì)算比每次實(shí)時(shí) count 借閱記錄更高效。user.max_borrow是業(yè)務(wù)規(guī)則的數(shù)據(jù)庫(kù)載體調(diào)整單人可借數(shù)量不用改代碼。字符集統(tǒng)一使用 utf8mb4 而不是 utf8否則插入生僻字或特殊符號(hào)容易丟字符。3.2 MyBatis Mapper 映射XML 寫法與參數(shù)綁定細(xì)節(jié)這套項(xiàng)目的 Mapper 層用 XML 實(shí)現(xiàn)動(dòng)態(tài) SQL比注解方式更適合復(fù)雜條件查詢。以圖書查詢?yōu)槔畛２鹊目邮恰皸l件為空時(shí) SQL 拼接多出一個(gè) WHERE 或 AND”。MyBatis 的where標(biāo)簽會(huì)自動(dòng)去掉多余的AND和OR這是 SSM 圖書管理項(xiàng)目中必須用熟的關(guān)鍵字。!-- BookMapper.xml動(dòng)態(tài)多條件查詢 -- select idsearchBooks parameterTypemap resultTypecom.example.library.entity.Book SELECT * FROM book where if testbookName ! null and bookName ! AND book_name LIKE CONCAT(%, #{bookName}, %) /if if testauthor ! null and author ! AND author #{author} /if if testcategory ! null and category ! AND category #{category} /if AND deleted 0 /where ORDER BY id DESC /select代碼邏輯說(shuō)明where標(biāo)簽自動(dòng)處理首個(gè)條件前的AND避免 SQL 語(yǔ)法錯(cuò)誤。所有參數(shù)通過(guò)#{}傳入MyBatis 會(huì)將其轉(zhuǎn)化為預(yù)編譯的?占位符可有效規(guī)避 SQL 注入。parameterTypemap是因?yàn)檎{(diào)用方可能只傳部分字段用 Map 不必定義專門的查詢對(duì)象。參數(shù)說(shuō)明LIKE CONCAT(%, #{bookName}, %)推薦寫法不要在 Java 代碼里拼好%再傳否則遇到特殊字符時(shí)容易出問(wèn)題。deleted 0放在where內(nèi)保證任何查詢都自動(dòng)過(guò)濾已刪除數(shù)據(jù)。如果只想查某本具體的書book_name的等值匹配比LIKE性能更好這一點(diǎn)在索引使用時(shí)很重要。3.3 Service 層事務(wù)邊界為什么數(shù)據(jù)源配置只寫一半會(huì)靜默失敗SSM 圖書項(xiàng)目新增圖書時(shí)需要校驗(yàn) ISBN 是否重復(fù)這時(shí)候事務(wù)的邊界就顯得很關(guān)鍵。常見(jiàn)的新手認(rèn)知是MyBatis 的 SQL 執(zhí)行成功就萬(wàn)事大吉但實(shí)際場(chǎng)景里 SQL 執(zhí)行成功只是第一步——比如新增圖書時(shí)向 book 表插入一條記錄同時(shí)往某個(gè)統(tǒng)計(jì)表寫入日志第二條 SQL 失敗時(shí)第一條必須回滾。Service public class BookServiceImpl implements BookService { Autowired private BookMapper bookMapper; Override Transactional(rollbackFor Exception.class) public void addBook(Book book) { int count bookMapper.countByIsbn(book.getIsbn()); if (count 0) { throw new RuntimeException(ISBN已存在); } bookMapper.insertBook(book); } }邏輯說(shuō)明Transactional(rollbackFor Exception.class)明確聲明所有異常都觸發(fā)回滾不寫rollbackFor時(shí)默認(rèn)只回滾 RuntimeException受檢異常不會(huì)自動(dòng)回滾這是數(shù)據(jù)不一致的高發(fā)源頭。Service 方法內(nèi)部先查重再插入兩個(gè)操作同處一個(gè)事務(wù)避免并發(fā)下重復(fù)插入。參數(shù)說(shuō)明拋出RuntimeException是事務(wù)回滾的觸發(fā)條件如果這里改成返回false或拋出普通 Exception事務(wù)不會(huì)回滾。強(qiáng)調(diào)一點(diǎn)Transactional放在 Service 實(shí)現(xiàn)類的具體方法上不要放在接口上因?yàn)槟承﹦?dòng)態(tài)代理機(jī)制對(duì)接口注解的識(shí)別不穩(wěn)定。4. 把功能做實(shí)圖書搜索、分頁(yè)與借還操作的實(shí)現(xiàn)過(guò)程CRUD 只是骨架圖書管理系統(tǒng)真正讓用戶覺(jué)得“能用”的功能是搜索、分頁(yè)和借還操作。這三個(gè)功能最考驗(yàn)對(duì) SSM 請(qǐng)求流轉(zhuǎn)和 SQL 細(xì)節(jié)的把控。4.1 分頁(yè)查詢PageHelper 與手動(dòng) Limit 的選擇分頁(yè)有兩條路一條是引入 PageHelper 插件在 Service 層調(diào)用PageHelper.startPage(pageNum, pageSize)后緊跟一條 Mapper 查詢插件自動(dòng)攔截并生成帶 LIMIT 的 SQL 并注入總數(shù)統(tǒng)計(jì)另一條是手動(dòng)計(jì)算offset (pageNum-1)*pageSize后傳入 Mapper。這套圖書系統(tǒng)我默認(rèn)推薦 PageHelper因?yàn)樗诓樵冞壿嫴蛔兊那闆r下能快速完成分頁(yè)但如果你為追求可控性手動(dòng) Limit 也完全可以接受——只要記得 count 查詢與數(shù)據(jù)查詢分開(kāi)寫。// BookController分頁(yè)查詢圖書列表 RequestMapping(/list) public String list(RequestParam(defaultValue 1) int pageNum, RequestParam(defaultValue 10) int pageSize, Model model) { PageHelper.startPage(pageNum, pageSize); ListBook bookList bookService.queryAllBooks(); PageInfoBook pageInfo new PageInfo(bookList); model.addAttribute(pageInfo, pageInfo); return book/list; }PageHelper.startPage只對(duì)緊隨其后的第一條 Mapper 查詢生效所以調(diào)用后不要插入其他 SQL 操作。PageInfo封裝了 total、pageNum、pageSize、pages 等字段JSP 端可以按需取用。頁(yè)面底部渲染上一頁(yè)/下一頁(yè)時(shí)注意參數(shù)拼接我用${pageInfo.prePage}和${pageInfo.nextPage}時(shí)要校驗(yàn)首尾邊界否則第一頁(yè)點(diǎn)“上一頁(yè)”會(huì)跳到第 0 頁(yè)這在用戶實(shí)操中很戳信任感。手動(dòng)分頁(yè)的 SQL 寫法是limit #{offset}, #{pageSize}但要注意 offset 在 XML 里傳入時(shí)已經(jīng)是計(jì)算后的整數(shù)不要在 SQL 里再乘一次。用 PageHelper 時(shí)如果出現(xiàn)“分頁(yè)不生效”的翻車絕大多數(shù)原因是 mybatis-spring 的版本與 PageHelper 插件的攔截器方式不匹配后文避坑章節(jié)單獨(dú)展開(kāi)。4.2 模糊搜索書名、作者、ISBN 的組合條件處理真實(shí)檢索場(chǎng)景下用戶很少一次性填滿所有搜索條件更多是只輸入一兩個(gè)字。組合條件的關(guān)鍵在于前端表單可能有空值后端 Controller 的RequestParam可能沒(méi)有傳入對(duì)應(yīng)參數(shù)這時(shí)直接用getParameter會(huì)拿到 null 并拼進(jìn) SQL產(chǎn)生與預(yù)期不符的結(jié)果。正確姿勢(shì)是前端傳空串后端對(duì)空串做統(tǒng)一容錯(cuò)。RequestMapping(/search) public String search(RequestParam(required false) String bookName, RequestParam(required false) String author, RequestParam(required false) String category, Model model) { MapString, Object condition new HashMap(); condition.put(bookName, bookName null ? : bookName.trim()); condition.put(author, author null ? : author.trim()); condition.put(category, category null ? : category.trim()); ListBook list bookService.searchBooks(condition); model.addAttribute(bookList, list); return book/list; }代碼邏輯required false讓 SpringMVC 接收不到該參數(shù)時(shí)不報(bào) 400而是注入 null。傳入 Mapper 前統(tǒng)一處理為合法值避免 XML 里寫太多判空。trim()去掉首尾空格是一門細(xì)節(jié)用戶從輸入框粘貼內(nèi)容時(shí)常帶不可見(jiàn)字符去掉后搜索命中率明顯提升。搜索結(jié)果默認(rèn)不分頁(yè)會(huì)導(dǎo)致數(shù)據(jù)量大時(shí)頁(yè)面卡頓我一般會(huì)配合 4.1 的分頁(yè)邏輯復(fù)用同一套查詢。4.3 借書/還書庫(kù)存校驗(yàn)與狀態(tài)流轉(zhuǎn)的實(shí)現(xiàn)借書不是簡(jiǎn)單 insert 一條記錄它要同時(shí)滿足三個(gè)條件用戶存在、在借冊(cè)數(shù)未達(dá)上限、圖書可借庫(kù)存足夠。真正寫業(yè)務(wù)時(shí)用戶很少先查詢一遍再點(diǎn)借閱往往是直接提交因此校驗(yàn)必須寫進(jìn) Service 層。常見(jiàn)錯(cuò)誤是把校驗(yàn)放 Controller 里換一套前端訪問(wèn)方式就繞過(guò)了邏輯。Transactional(rollbackFor Exception.class) public void borrowBook(Integer bookId, Integer userId) { Book book bookMapper.selectByIdForUpdate(bookId); if (book null || book.getDeleted() 1) { throw new RuntimeException(圖書不存在或已刪除); } if (book.getStock() - book.getBorrowedCount() 0) { throw new RuntimeException(庫(kù)存不足); } int activeBorrows borrowRecordMapper.countActiveByUserId(userId); if (activeBorrows userMapper.findById(userId).getMaxBorrow()) { throw new RuntimeException(已達(dá)借閱上限); } bookMapper.increaseBorrowedCount(bookId); borrowRecordMapper.insert(new BorrowRecord(bookId, userId, new Date(), null)); }代碼邏輯selectByIdForUpdate使用悲觀鎖鎖住圖書行避免同一本書同時(shí)被多人借出時(shí)超借這是“并發(fā)場(chǎng)景下庫(kù)存不夠分”的兜底做法。借出數(shù)量通過(guò)stock - borrowedCount判斷而不是直接用stock 0否則已借出的數(shù)量沒(méi)扣除會(huì)導(dǎo)致借閱總數(shù)超過(guò)館藏。countActiveByUserId統(tǒng)計(jì)該用戶尚未歸還的借閱記錄與user.max_borrow比較時(shí)注意需查詢用戶基本信息的額外代價(jià)。借書時(shí)的數(shù)字變化有兩處book 表的borrowed_count加 1以及 borrow_record 表插入一條記錄。必須放在同一事務(wù)里順序是先扣減、后插入如果順序反了插入失敗時(shí)扣減落庫(kù)會(huì)造成數(shù)據(jù)錯(cuò)亂。還書時(shí)反向操作borrowRecordMapper.updateReturnTime(recordId, new Date())并把對(duì)應(yīng)圖書的borrowed_count減 1注意還書操作要取最近一條未歸還記錄避免用戶對(duì)同一本書借了兩次后還錯(cuò)記錄。5. SSM 整合避坑自查那些讓你翻車的配置與依賴問(wèn)題SSM 這個(gè)組合運(yùn)行起來(lái)路徑必然經(jīng)過(guò)配置文件任何一個(gè)環(huán)節(jié)斷開(kāi)都會(huì)導(dǎo)致啟動(dòng)失敗或請(qǐng)求異常。遍歷這套系統(tǒng)的完整運(yùn)行環(huán)境后我把高頻翻車按“現(xiàn)象—原因—解決”整理出來(lái)新手照著排查能少走彎路。5.1 現(xiàn)象Service 自動(dòng)注入為 null調(diào)用方法拋空指針原因context:component-scan掃描的 base-package 過(guò)窄或者根本沒(méi)有覆蓋到 service 實(shí)現(xiàn)類Spring 容器中沒(méi)有生成 Service Bean。很多時(shí)候 people 忘記在 applicationContext.xml 里加掃描標(biāo)簽只配了數(shù)據(jù)源和 SqlSessionFactory導(dǎo)致Autowired注入時(shí)找到不到 Bean。解決確認(rèn) applicationContext.xml 中顯式聲明context:component-scan base-packagecom.example.library.service/且 base-package 必須指向 service 包所在位置不能寫成com.example.library.controller。寫完配置后啟動(dòng)項(xiàng)目看控制臺(tái)日志搜一下Creating service之類的輸出確認(rèn) Bean 被實(shí)例化。5.2 現(xiàn)象啟動(dòng)時(shí)報(bào)Failed to configure a DataSource或連接超時(shí)原因數(shù)據(jù)源配置選擇錯(cuò)誤或變量占位沒(méi)解析。常見(jiàn)于 jdbc.properties 文件未加載、driver-class-name等關(guān)鍵項(xiàng)名稱敲歪比如把driver-class-name寫成driverClassName就無(wú)法綁定。MySQL 8.0 版本驅(qū)動(dòng)時(shí)驅(qū)動(dòng)類是com.mysql.cj.jdbc.Driver而 5.x 是com.mysql.jdbc.Driver兩者混淆必掛。解決在 applicationContext.xml 中按下面方式引入 jdbc.properties并顯式指定class為org.springframework.jdbc.datasource.DriverManagerDataSource或 druid 數(shù)據(jù)源。配置里的 URL 務(wù)必寫成jdbc:mysql://localhost:3306/library_db?useUnicodetruecharacterEncodingutf8mb4不寫characterEncoding容易出現(xiàn)中文亂碼不寫useSSLfalse在 MySQL 8 下可能報(bào) SSL 連接告警。5.3 現(xiàn)象前端通過(guò) AJAX 拿不到返回值console 一直解析失敗原因SpringMVC 方法返回Map或List時(shí)缺少ResponseBody或工程缺少 Jackson 依賴。傳統(tǒng) SSM 中ResponseBody需要 jackson-databind 等依賴否則返回?cái)?shù)據(jù)無(wú)法序列化為 JSON前端拿到的是 500 錯(cuò)誤頁(yè)或空體。解決pom 中引入com.fasterxml.jackson.core:jackson-databind這一依賴Controller 方法上加ResponseBody或類上直接加RestController。注意spring-mvc.xml里要開(kāi)mvc:annotation-driven/否則 SpringMVC 默認(rèn)不啟用 Jackson 轉(zhuǎn)換器加注解也會(huì)失效。5.4 現(xiàn)象部署到 Tomcat 后訪問(wèn)頁(yè)面 404但啟動(dòng)無(wú)報(bào)錯(cuò)原因項(xiàng)目沒(méi)有正確編譯為可運(yùn)行的 Web 模塊或web.xml里 DispatcherServlet 的url-pattern配置把 JSP 請(qǐng)求也攔截了。Tomcat 找不到 JSP 頁(yè)面直接走到兜底 404。還有一種情況是 SpringMVC 的視圖解析器前綴路徑配錯(cuò)導(dǎo)致返回的視圖名指向了不存在的目錄。解決先確認(rèn) JSP 是放在src/main/webapp/WEB-INF/jsp下并且被 Maven 打包。視圖解析器配置請(qǐng)這樣寫property nameprefix value/WEB-INF/jsp//property namesuffix value.jsp/JSP 放在WEB-INF目錄外也能被直接訪問(wèn)但不如放里面安全后文登錄攔截會(huì)展開(kāi)。若/攔了一切在 spring-mvc.xml 中寫mvc:resources mapping/static/** location/static//放行靜態(tài)資源否則連 css、js 都會(huì)被攔下來(lái)。6. 讓系統(tǒng)更穩(wěn)事務(wù)、慢查詢與登錄攔截的進(jìn)階調(diào)校系統(tǒng)能跑起來(lái)只是開(kāi)始要放到實(shí)訓(xùn)環(huán)境或正式環(huán)境里被人連續(xù)點(diǎn)幾十次還不出錯(cuò)還得做三件進(jìn)階的事嚴(yán)格事務(wù)、優(yōu)化查詢、守住權(quán)限。6.1 事務(wù)控制策略把事務(wù)注解細(xì)化到具體業(yè)務(wù)方法。借書與還書這類寫操作無(wú)條件用Transactional(rollbackFor Exception.class)單純的列表查詢、單條詳情查詢建議不加事務(wù)避免給數(shù)據(jù)庫(kù)增加無(wú)謂的鎖。需要多條 SQL 聯(lián)合更新時(shí)再開(kāi)啟事務(wù)。注意 Spring 的代理機(jī)制同一個(gè)類內(nèi)部調(diào)用帶事務(wù)注解的方法事務(wù)不生效。比如BookServiceImpl中 a 方法調(diào)同一個(gè)類的 b 方法b 上的事務(wù)會(huì)被忽略正確做法是獨(dú)立封裝或注入自身代理我通常把寫操作整合到一個(gè)門面類處理比如BorrowFacade。6.2 慢查詢排查圖書列表頁(yè)點(diǎn)擊一次要做一次 count 加一次數(shù)據(jù)查詢MySQL 拿到模糊搜索條件很容易全表掃描。對(duì)常見(jiàn)搜索字段book_name和author建索引并且在 SQL 執(zhí)行前使用EXPLAIN SELECT * FROM book WHERE book_name LIKE 關(guān)鍵字%檢查是否命中索引。要留意 LIKE 以%開(kāi)頭時(shí)即使有索引也無(wú)能為力。真遇到搜索慢到閃紅直接用前綴索引或考慮 MySQL 全文索引。從設(shè)計(jì)上想這份資源中idx_book_name索引只能加速前綴匹配帶%開(kāi)頭時(shí)我可以把首字符相同的量控制住比如建議用戶輸入至少前兩個(gè)字再搜。6.3 登錄攔截與靜態(tài)資源放行未登錄用戶理論上不能進(jìn)入 /book/list、/borrow/* 等路徑。用 SpringMVC 攔截器實(shí)現(xiàn)要比在 JSP 里頻繁判斷 session 干凈得多。繼承 HandlerInterceptorAdapter 或?qū)崿F(xiàn) HandlerInterceptor 接口在 preHandle 方法里檢查 session若為空則重定向到 /login。配置時(shí)注意把/login、/static/**排除否則登錄頁(yè)自己也進(jìn)不去css、js 被攔后又出現(xiàn)頁(yè)面裸奔狀態(tài)。public class LoginInterceptor implements HandlerInterceptor { Override public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception { Object user request.getSession().getAttribute(loginUser); if (user null) { response.sendRedirect(request.getContextPath() /login); return false; } return true; } }代碼邏輯request.getSession().getAttribute(loginUser)從回話中取登錄對(duì)象當(dāng)用戶未登錄時(shí)會(huì)被重定向到登錄頁(yè)。response.sendRedirect重定向路徑需要拼接request.getContextPath()否則部署在帶上下文路徑的正向時(shí)跳轉(zhuǎn)可能指向錯(cuò)誤地址。登錄成功后記得在業(yè)務(wù)代碼中主動(dòng)設(shè)置 session 屬性否則這個(gè)攔截器永遠(yuǎn)認(rèn)為你未登錄我在這里吃過(guò)虧。寫完登錄攔截后順手做了一件很提效的事用日志打印攔截器是否命中驗(yàn)證期里每次點(diǎn)請(qǐng)求都能在控制臺(tái)看到遍歷路徑排查“為什么頁(yè)面能訪問(wèn)卻跳登錄”這類問(wèn)題時(shí)快很多。從那以后我每次調(diào) SSM 項(xiàng)目都強(qiáng)制走一遍“檢查攔截器 驗(yàn)證事務(wù) EXPLAIN 走索引”這三步任何從畢業(yè)設(shè)計(jì)來(lái)的歷史項(xiàng)目都能在半天內(nèi)確認(rèn)是否達(dá)到交付標(biāo)準(zhǔn)。這套 SSM 圖書管理系統(tǒng)也是一樣按上面的思路從頭到尾把配置、業(yè)務(wù)、安全三步走通剩下的工作就是按你自己的業(yè)務(wù)需求改字段和頁(yè)面了希望幫到你。本文還有配套的精品資源點(diǎn)擊獲取