簡(jiǎn)介面向畢業(yè)設(shè)計(jì)與超市管理場(chǎng)景的進(jìn)銷存管理系統(tǒng)采用Java語(yǔ)言開(kāi)發(fā)基于Spring、SpringMVC、MyBatis整合框架搭配MySQL數(shù)據(jù)庫(kù)以B/S結(jié)構(gòu)實(shí)現(xiàn)。系統(tǒng)劃分管理員、員工、前臺(tái)三類角色管理員可管理用戶、員工、商品分類、商品信息、商品維護(hù)、入庫(kù)出庫(kù)記錄、銷售統(tǒng)計(jì)、留言板及訂單員工處理商品與出入庫(kù)記錄前臺(tái)首頁(yè)提供商品瀏覽、新聞資訊、留言反饋與購(gòu)物入口覆蓋超市進(jìn)銷存的完整業(yè)務(wù)鏈路。壓縮包內(nèi)共1390個(gè)文件以JSP動(dòng)態(tài)頁(yè)面、Java業(yè)務(wù)源碼、JavaScript腳本、CSS樣式表為主輔以PNG/GIF圖片、XML配置文件、SQL數(shù)據(jù)庫(kù)腳本、Word論文和PPT答辯材料整體約31.22MB目錄結(jié)構(gòu)清晰便于定位代碼與文檔。已有110人學(xué)習(xí)下載適合需要完成畢業(yè)設(shè)計(jì)或課程設(shè)計(jì)的計(jì)算機(jī)專業(yè)學(xué)生可參考其多角色權(quán)限設(shè)計(jì)、進(jìn)銷存流程實(shí)現(xiàn)及SSM整合思路。1. 從課設(shè)到簡(jiǎn)歷為什么一套 SSMJSP 的超市進(jìn)銷存管理系統(tǒng)到今天還有人做每年臨近畢業(yè)季「基于 SSMJSP 的 XX 超市進(jìn)銷存管理系統(tǒng)」都是 Java 方向課程設(shè)計(jì)和畢業(yè)設(shè)計(jì)里出現(xiàn)頻率極高的選題。家百利超市進(jìn)銷存管理系統(tǒng)就是這類項(xiàng)目的典型代表技術(shù)棧固定為 Spring SpringMVC MyBatis頁(yè)面層用 JSP業(yè)務(wù)范圍圈定在超市的進(jìn)貨、銷售和庫(kù)存管理三條主線上。很多同學(xué)覺(jué)得這套技術(shù)?！咐稀沟∏∈沁@種老而穩(wěn)的組合把 Java Web 開(kāi)發(fā)里最核心的東西——對(duì)象管理、請(qǐng)求流轉(zhuǎn)、SQL 操作、事務(wù)控制——完整地串了一遍。這套系統(tǒng)解決的不是什么高并發(fā)難題而是讓中小型超市的進(jìn)銷存數(shù)據(jù)從 Excel 表格和手寫(xiě)單據(jù)變成能對(duì)得上賬的數(shù)據(jù)庫(kù)記錄。適合正在做畢設(shè)或課設(shè)的學(xué)生也適合想快速補(bǔ)一套完整 SSM 項(xiàng)目經(jīng)驗(yàn)的初級(jí)工程師照著源碼捋一遍業(yè)務(wù)閉環(huán)。2. 技術(shù)選型拆解SSMJSP 這套組合的邊界與合理性2.1 三個(gè)框架的分工Spring 管對(duì)象、SpringMVC 管請(qǐng)求、MyBatis 管 SQL在做任何一個(gè) SSM 項(xiàng)目之前先把三個(gè)框架的邊界畫(huà)清楚后面讀源碼才不會(huì)迷路。Spring 負(fù)責(zé)對(duì)象管理也就是把 Service、Mapper 這些類交給容器統(tǒng)一創(chuàng)建和注入同時(shí)承擔(dān)事務(wù)管理和 AOP 切面SpringMVC 負(fù)責(zé)請(qǐng)求分發(fā)從瀏覽器進(jìn)來(lái)的 URL 經(jīng)過(guò) DispatcherServlet 找到對(duì)應(yīng)的 Controller 方法再返回視圖或數(shù)據(jù)MyBatis 負(fù)責(zé)數(shù)據(jù)庫(kù)訪問(wèn)把 SQL 寫(xiě)在 XML 映射文件或注解里返回的對(duì)象自動(dòng)映射成 Java 實(shí)體。三者各管一段出了問(wèn)題排查范圍天然被切開(kāi)了。在源碼工程里這三個(gè)框架的協(xié)作關(guān)系可以從兩個(gè)配置文件里看出來(lái)。一個(gè)典型的 Spring 配置片段長(zhǎng)這樣!-- 開(kāi)啟注解掃描Controller 之外的所有 Bean 都從這里注冊(cè) -- context:component-scan base-packagecom.jiabaili.service / context:component-scan base-packagecom.jiabaili.dao / !-- 數(shù)據(jù)源配置驅(qū)動(dòng)、地址、賬號(hào)、密碼 -- bean iddataSource classorg.springframework.jdbc.datasource.DriverManagerDataSource property namedriverClassName valuecom.mysql.jdbc.Driver / property nameurl valuejdbc:mysql://localhost:3306/jbl_supermarket?characterEncodingutf8 / property nameusername valueroot / property namepassword value123456 / /bean !-- 把數(shù)據(jù)源交給 MyBatis 的 SqlSessionFactory -- bean idsqlSessionFactory classorg.mybatis.spring.SqlSessionFactoryBean property namedataSource refdataSource / property namemapperLocations valueclasspath:com/jiabaili/mapper/*.xml / /bean !-- 掃描 Mapper 接口動(dòng)態(tài)生成實(shí)現(xiàn)類 -- bean classorg.mybatis.spring.mapper.MapperScannerConfigurer property namebasePackage valuecom.jiabaili.dao / /bean這段配置的邏輯是先掃描 Service 和 DAO 接口再把數(shù)據(jù)源注入 MyBatis 的會(huì)話工廠最后通過(guò) MapperScannerConfigurer 把 DAO 接口和 XML 里的 SQL 綁定起來(lái)。參數(shù)里有三個(gè)地方需要根據(jù)實(shí)際環(huán)境改數(shù)據(jù)庫(kù)地址、賬號(hào)密碼、mapper XML 的掃描路徑。不少源碼工程的坑就出在 mapperLocations 的路徑寫(xiě)錯(cuò)導(dǎo)致啟動(dòng)時(shí)報(bào)Invalid bound statement (not found)。這個(gè)報(bào)錯(cuò)的意思是接口方法找到了但對(duì)應(yīng)的 SQL 沒(méi)加載進(jìn)來(lái)優(yōu)先檢查路徑和 XML 文件名是否和接口名一一對(duì)應(yīng)。2.2 JSP 不過(guò)時(shí)只是被用錯(cuò)了地方頁(yè)面層為什么不適合無(wú)腦前后端分離近幾年前后端分離成了默認(rèn)姿勢(shì)但 SSMJSP 這套組合并沒(méi)有被淘汰。JSP 的核心優(yōu)勢(shì)是服務(wù)端渲染Java 代碼和 HTML 可以混編數(shù)據(jù)從 Controller 塞進(jìn) Model 之后直接在頁(yè)面上用 EL 表達(dá)式和 JSTL 標(biāo)簽取出來(lái)不需要額外起 Node.js 服務(wù)也不需要解決跨域問(wèn)題。對(duì)于超市進(jìn)銷存這種以表單和表格為主的后臺(tái)管理系統(tǒng)頁(yè)面交互不復(fù)雜JSP 的開(kāi)發(fā)效率反而高于 VueAxios 那一套?？匆幌略创a里典型的進(jìn)貨單 JSP 頁(yè)面片段感受一下數(shù)據(jù)是怎么從后端流到頁(yè)面的% page contentTypetext/html;charsetUTF-8 languagejava % % taglib prefixc urihttp://java.sun.com/jsp/jstl/core % html head title進(jìn)貨單列表/title /head body table border1 tr th進(jìn)貨單號(hào)/th th供應(yīng)商/th th進(jìn)貨日期/th th總金額/th /tr c:forEach items${purchaseList} varpurchase tr td${purchase.purchaseNo}/td td${purchase.supplierName}/td td${purchase.purchaseDate}/td td${purchase.totalAmount}/td /tr /c:forEach /table /body /html這里最需要注意的是${purchase.purchaseNo}這種 EL 表達(dá)式它背后對(duì)應(yīng)的是 Purchase 實(shí)體類的getPurchaseNo()方法。如果實(shí)體類沒(méi)有生成 getter頁(yè)面上會(huì)直接空白而且不報(bào)錯(cuò)。新手最容易在這里翻車(chē)MySQL 里字段是purchase_noJava 實(shí)體屬性是purchaseNoMyBatis 開(kāi)啟了駝峰映射就能對(duì)上沒(méi)開(kāi)啟就要在 XML 里寫(xiě)resultMap做手動(dòng)映射。JSP 頁(yè)面取值取不到的時(shí)候先回 Mapper XML 里看 resultMap 或 resultType 配的是什么再回實(shí)體類里看 getter 是否存在不要第一反應(yīng)去改頁(yè)面。2.3 源碼工程的目錄結(jié)構(gòu)三個(gè)包和一個(gè) resources 目錄拿到家百利進(jìn)銷存系統(tǒng)的源碼工程第一件事不是急著運(yùn)行而是先看目錄結(jié)構(gòu)。傳統(tǒng)的 SSM 項(xiàng)目按 MVC 分層源碼里一般會(huì)有一個(gè)頂級(jí)包名比如com.jiabaili下面按 controller、service、dao、entity 四個(gè)子包組織。entity 里放和數(shù)據(jù)庫(kù)表對(duì)應(yīng)的實(shí)體類dao 里寫(xiě)接口service 里寫(xiě)業(yè)務(wù)邏輯controller 里寫(xiě)請(qǐng)求映射。resources 目錄下放著 Spring 配置文件、MyBatis 映射文件和 MyBatis 全局配置。src/main/java/com/jiabaili/ ├── controller/ # 頁(yè)面跳轉(zhuǎn)和請(qǐng)求參數(shù)接收 │ ├── LoginController.java │ ├── PurchaseController.java │ └── SaleController.java ├── service/ # 業(yè)務(wù)邏輯層事務(wù)邊界在這里 │ ├── PurchaseService.java │ └── SaleService.java ├── dao/ # MyBatis Mapper 接口 │ ├── PurchaseDao.java │ └── SaleDao.java └── entity/ # 數(shù)據(jù)庫(kù)表對(duì)應(yīng)的實(shí)體 ├── Purchase.java └── Product.java src/main/resources/ ├── spring/ # Spring 和 SpringMVC 配置文件 ├── mapper/ # MyBatis 的 XML 映射文件 └── mybatis-config.xml # MyBatis 全局配置拿到源碼先核對(duì)這個(gè)結(jié)構(gòu)。很多從網(wǎng)盤(pán)下載的源碼工程包名和實(shí)際目錄對(duì)不上或者少了 mapper 文件夾運(yùn)行起來(lái)全是「找不到符號(hào)」。我一般會(huì)先全局搜索RequestMapping把所有 Controller 里的 URL 路徑列出來(lái)和數(shù)據(jù)庫(kù)表名對(duì)照一遍就能大概猜出這個(gè)系統(tǒng)的功能模塊劃分。超市進(jìn)銷存系統(tǒng)的功能通常圍繞六個(gè)模塊轉(zhuǎn)登錄、商品管理、供應(yīng)商管理、進(jìn)貨管理、銷售管理、庫(kù)存查詢?cè)创a里的 Controller 類基本和這六個(gè)模塊一一對(duì)應(yīng)。3. 數(shù)據(jù)庫(kù)設(shè)計(jì)與業(yè)務(wù)閉環(huán)進(jìn)銷存的核心不只是三張表3.1 七張核心表從商品表到庫(kù)存流水表的設(shè)計(jì)邏輯進(jìn)銷存系統(tǒng)聽(tīng)起來(lái)就是「進(jìn)貨、賣(mài)貨、查庫(kù)存」但表結(jié)構(gòu)不能只設(shè)計(jì)三張表。如果進(jìn)貨單和銷售單不拆主表和明細(xì)表一條進(jìn)貨記錄里多個(gè)商品就無(wú)法存儲(chǔ)如果庫(kù)存只存當(dāng)前數(shù)量不記錄每次變動(dòng)出了問(wèn)題根本沒(méi)法追溯。常見(jiàn)的做法是設(shè)計(jì)七張表商品表、供應(yīng)商表、進(jìn)貨單表、進(jìn)貨明細(xì)表、銷售單表、銷售明細(xì)表、庫(kù)存表。有的系統(tǒng)還會(huì)加一張庫(kù)存流水表每次入庫(kù)出庫(kù)都追加一條記錄。表名核心字段作用t_productid, product_no, product_name, spec, unit, price商品主數(shù)據(jù)t_supplierid, supplier_name, contact, phone, address供應(yīng)商檔案t_purchaseid, purchase_no, supplier_id, purchase_date, total_amount, operator進(jìn)貨單主表t_purchase_itemid, purchase_id, product_id, quantity, price, amount進(jìn)貨單明細(xì)t_saleid, sale_no, sale_date, total_amount, operator銷售單主表t_sale_itemid, sale_id, product_id, quantity, price, amount銷售單明細(xì)t_stockid, product_id, quantity, last_update_time實(shí)時(shí)庫(kù)存兩個(gè)主表各自掛一個(gè)明細(xì)表這是進(jìn)銷存系統(tǒng)里最核心的表結(jié)構(gòu)設(shè)計(jì)。主表存一筆單據(jù)的公共信息單號(hào)、日期、總金額、操作人明細(xì)表存這一筆單據(jù)里每個(gè)商品的數(shù)量和金額。以進(jìn)貨為例一次采購(gòu) 10 種商品t_purchase 表只多一條記錄而 t_purchase_item 表多 10 條。這樣設(shè)計(jì)的好處是兩個(gè)維度都能查按單號(hào)查整個(gè)進(jìn)貨批次按商品查這個(gè)商品在不同批次里的進(jìn)貨價(jià)。3.2 一次進(jìn)貨動(dòng)作背后的三次寫(xiě)操作事務(wù)邊界的經(jīng)典示范看一個(gè)進(jìn)銷存系統(tǒng)的源碼質(zhì)量最有效的辦法是看進(jìn)貨邏輯的 Service 實(shí)現(xiàn)。一次進(jìn)貨不是單純的 insert而是三個(gè)動(dòng)作往進(jìn)貨主表和明細(xì)表插入單據(jù)數(shù)據(jù)同時(shí)還要更新庫(kù)存表里的商品數(shù)量。這三個(gè)動(dòng)作必須在一個(gè)數(shù)據(jù)庫(kù)事務(wù)里任何一個(gè)失敗都要全部回滾。下面是一個(gè)簡(jiǎn)化版的進(jìn)貨 Service 代碼Service public class PurchaseService { Autowired private PurchaseDao purchaseDao; Autowired private PurchaseItemDao purchaseItemDao; Autowired private StockDao stockDao; Transactional(rollbackFor Exception.class) public void addPurchase(Purchase purchase, ListPurchaseItem items) { // 動(dòng)作一插入進(jìn)貨單主表返回主鍵 ID purchaseDao.insertPurchase(purchase); // 動(dòng)作二遍歷明細(xì)列表逐條插入進(jìn)貨明細(xì)表 for (PurchaseItem item : items) { item.setPurchaseId(purchase.getId()); purchaseItemDao.insertItem(item); // 動(dòng)作三更新庫(kù)存表商品存在則加數(shù)量不存在則插入 int affected stockDao.increaseStock(item.getProductId(), item.getQuantity()); if (affected 0) { Stock stock new Stock(); stock.setProductId(item.getProductId()); stock.setQuantity(item.getQuantity()); stockDao.insertStock(stock); } } } }這段代碼值得注意的地方有兩個(gè)。第一是Transactional(rollbackFor Exception.class)這個(gè)參數(shù)不是默認(rèn)值——Spring 的事務(wù)默認(rèn)只在拋出 RuntimeException 時(shí)回滾如果業(yè)務(wù)代碼拋的是自定義的 checked exception不指定 rollbackFor 的話庫(kù)存已經(jīng)更新了但單據(jù)沒(méi)插進(jìn)去數(shù)據(jù)就永遠(yuǎn)對(duì)不上了。第二是increaseStock返回受影響行數(shù)的寫(xiě)法用affected 0來(lái)判斷是更新還是插入本質(zhì)上是一個(gè)簡(jiǎn)單的「有則改、無(wú)則加」邏輯。這個(gè)寫(xiě)法在并發(fā)場(chǎng)景下會(huì)有問(wèn)題但對(duì)于課設(shè)和中小型超市的并發(fā)量來(lái)說(shuō)足夠了。3.3 論文里的 E-R 圖和數(shù)據(jù)字典和代碼怎么對(duì)照著寫(xiě)這套源碼附帶的論文里數(shù)據(jù)庫(kù)設(shè)計(jì)章節(jié)一般是重頭戲E-R 圖和數(shù)據(jù)字典加起來(lái)能占去十幾頁(yè)。寫(xiě)論文時(shí)有一個(gè)常見(jiàn)誤區(qū)E-R 圖畫(huà)得很大很全但和數(shù)據(jù)字典里的字段對(duì)不上或者數(shù)據(jù)字典里的表和代碼里的建表 SQL 不一致。拿到源碼后我建議把三樣?xùn)|西放在一起核對(duì)——論文中的 E-R 圖、數(shù)據(jù)字典、resources 目錄下的建表 SQL 文件。很多版本的源碼里論文里寫(xiě)了 12 張表實(shí)際 SQL 腳本只建了 7 張寫(xiě)著寫(xiě)著功能就缺了。數(shù)據(jù)字典的寫(xiě)法也有套路每張表一個(gè)表格字段名、數(shù)據(jù)類型、是否主鍵、是否為空、默認(rèn)值、說(shuō)明。寫(xiě)的時(shí)候不要照抄字段名就完事要把業(yè)務(wù)含義寫(xiě)清楚。比如 t_stock 表的quantity字段說(shuō)明不能只寫(xiě)「數(shù)量」應(yīng)該寫(xiě)「當(dāng)前實(shí)時(shí)庫(kù)存數(shù)量每次入庫(kù)加、出庫(kù)減由 Service 層事務(wù)保證一致性」。論文答辯時(shí)老師喜歡追問(wèn)的就是這種細(xì)節(jié)——「你這個(gè)庫(kù)存表的更新策略是什么」「進(jìn)貨單刪除的時(shí)候庫(kù)存要不要回滾」回答得上來(lái)說(shuō)明系統(tǒng)真的是你寫(xiě)的回答不上來(lái)代碼是不是自己寫(xiě)的就不好說(shuō)了。4. 在本地跑通源碼環(huán)境版本組合、配置修改和啟動(dòng)步驟4.1 版本組合把 JDK、Tomcat、MySQL、Maven 的兼容矩陣先定下來(lái)SSMJSP 項(xiàng)目最容易翻車(chē)的地方不在代碼而在環(huán)境。網(wǎng)上流傳的源碼工程很多是在不同版本的 JDK、Tomcat、MySQL 下寫(xiě)的直接拿自己機(jī)器上最新的環(huán)境去跑經(jīng)常出現(xiàn)各種玄學(xué)報(bào)錯(cuò)。先給一組經(jīng)過(guò)驗(yàn)證的兼容組合JDK 1.8、Tomcat 8.5、MySQL 5.7、Maven 3.6.3。這套組合和絕大部分 SSMJSP 課設(shè)源碼的編寫(xiě)環(huán)境一致也是我建議優(yōu)先嘗試的組合。組件推薦版本說(shuō)明JDK1.8SSM 項(xiàng)目基本都在 Java 8 上開(kāi)發(fā)避免直接用 JDK 11Tomcat8.5支持 JSP 2.3 和 Servlet 3.1兼容性最好MySQL5.75.x 版本對(duì) JDBC 驅(qū)動(dòng)的兼容性比 8.x 省心Maven3.6.3依賴管理用3.8 有時(shí)會(huì)因中央倉(cāng)庫(kù)策略報(bào)錯(cuò)JDK 和 Maven 的環(huán)境變量配置是老生常談但要檢查是否真的生效可以在命令行執(zhí)行java -version和mvn -v確認(rèn)輸出的版本號(hào)不是系統(tǒng)預(yù)裝的其他版本。MySQL 要注意 root 賬號(hào)的密碼是否和源碼里的jdbc.properties配置一致這是連接失敗的第一大原因。另外不建議一上來(lái)就用最新的 MySQL 8.0 和 Tomcat 10——Tomcat 10 的包名從javax.servlet改成了jakarta.servlet老 SSM 項(xiàng)目里的javax導(dǎo)入全會(huì)報(bào) ClassNotFoundException不是改一行配置能解決的。4.2 從導(dǎo)入到啟動(dòng)的七步操作以命令行方式跑通整個(gè)工程拿到源碼后按下面這幾步操作能避開(kāi)大多數(shù)坑。先檢查 JDK 和 Maven 版本再導(dǎo)入數(shù)據(jù)庫(kù)腳本然后修改三個(gè)配置文件最后啟動(dòng) Tomcat。我用命令行的方式來(lái)寫(xiě)因?yàn)楹芏嗑W(wǎng)上下的源碼工程并不帶 IDE 配置直接用 Maven 命令驗(yàn)證最靠譜。# 第一步確認(rèn) JDK 版本 java -version # 期望看到 1.8 字樣 # 第二步確認(rèn) Maven 版本 mvn -v # 期望看到 Apache Maven 3.x # 第三步創(chuàng)建數(shù)據(jù)庫(kù)并導(dǎo)入 SQL 腳本 mysql -u root -p # 在 MySQL 里執(zhí)行CREATE DATABASE jbl_supermarket DEFAULT CHARSET utf8mb4; # 然后退出 mysql 命令行回到系統(tǒng)命令行執(zhí)行下面這行 mysql -u root -p jbl_supermarket sql/jbl_supermarket.sql # 第四步編譯并打包工程 mvn clean package -DskipTests # 看到 BUILD SUCCESS 說(shuō)明編譯通過(guò) # 第五步部署到 Tomcat cp target/jbl-supermarket.war /path/to/tomcat/webapps/ # 第六步啟動(dòng) Tomcat /path/to/tomcat/bin/startup.sh # 第七步查看啟動(dòng)日志 tail -f /path/to/tomcat/logs/catalina.out # 看到 Deployment of web application archive ... has finished 說(shuō)明部署成功第三步里的 SQL 腳本是源碼自帶的建表和初始數(shù)據(jù)文件一般在項(xiàng)目根目錄的sql/或db/文件夾下。導(dǎo)入前先打開(kāi)看一下確認(rèn)里面有沒(méi)有CREATE DATABASE語(yǔ)句——如果有就不需要手動(dòng)創(chuàng)建數(shù)據(jù)庫(kù)直接全量導(dǎo)入即可如果沒(méi)有就先建庫(kù)再指定庫(kù)名導(dǎo)入。第五步里部署 war 包之前我習(xí)慣把 Tomcat 的webapps目錄下原來(lái)自帶的ROOT、docs等文件夾清掉避免訪問(wèn) 8080 端口時(shí)跳到 Tomcat 默認(rèn)首頁(yè)讓人誤以為項(xiàng)目沒(méi)部署成功。4.3 三個(gè)必須改的配置數(shù)據(jù)庫(kù)連接、根路徑和字符編碼工程跑起來(lái)之前有三個(gè)配置項(xiàng)要逐個(gè)核對(duì)。第一個(gè)是數(shù)據(jù)庫(kù)連接信息通常在src/main/resources下的jdbc.properties里把jdbc.url、jdbc.username、jdbc.password改成自己本機(jī)的值。第二個(gè)是項(xiàng)目的上下文根路徑如果 war 包名是jbl-supermarket訪問(wèn)地址就是http://localhost:8080/jbl-supermarket/登錄頁(yè)面的 URL 如果寫(xiě)死了/login會(huì)跳轉(zhuǎn)到 Tomcat 根路徑下找不到資源。第三個(gè)是字符編碼JSP 頁(yè)面、Servlet 過(guò)濾器、數(shù)據(jù)庫(kù)連接串三處都要統(tǒng)一成 UTF-8缺一個(gè)就會(huì)出現(xiàn)中文亂碼。!-- web.xml 里配置 Spring MVC 的字符編碼過(guò)濾器必須在所有過(guò)濾器最前面 -- filter filter-nameencodingFilter/filter-name filter-classorg.springframework.web.filter.CharacterEncodingFilter/filter-class init-param param-nameencoding/param-name param-valueUTF-8/param-value /init-param init-param param-nameforceEncoding/param-name param-valuetrue/param-value /init-param /filter filter-mapping filter-nameencodingFilter/filter-name url-pattern/*/url-pattern /filter-mapping這段過(guò)濾器的forceEncoding參數(shù)很容易被忽略。如果不設(shè)成 trueSpring 只會(huì)在請(qǐng)求參數(shù)里帶有編碼信息時(shí)才會(huì)覆蓋默認(rèn)編碼設(shè)了 true則強(qiáng)制所有請(qǐng)求和響應(yīng)都使用 UTF-8。很多本地開(kāi)發(fā)環(huán)境沒(méi)問(wèn)題、部署到服務(wù)器就亂碼的情況都是因?yàn)檫@臺(tái)服務(wù)器上的容器默認(rèn)編碼不是 UTF-8。把這段配置加進(jìn)去之后JSP 頁(yè)面頭部的contentTypetext/html;charsetUTF-8和數(shù)據(jù)庫(kù)連接串里的characterEncodingutf8三處對(duì)齊中文顯示問(wèn)題基本就根治了。5. 避坑指南SSMJSP 項(xiàng)目最容易翻車(chē)的 5 個(gè)檢查點(diǎn)5.1 分頁(yè)查詢失效返回全表數(shù)據(jù)現(xiàn)象在商品列表頁(yè)點(diǎn)擊第二頁(yè)結(jié)果頁(yè)面把全部商品一次性列出來(lái)了或者點(diǎn)下一頁(yè)沒(méi)反應(yīng)SQL 日志里查出來(lái)的數(shù)據(jù)量是全部記錄數(shù)。原因SSM 項(xiàng)目里分頁(yè)通常用 PageHelper 插件但 PageHelper 的版本必須和 MyBatis 版本兼容。另一個(gè)常見(jiàn)原因是 MyBatis 全局配置里沒(méi)有注冊(cè) PageHelper 的攔截器導(dǎo)致調(diào)用PageHelper.startPage()后沒(méi)有任何攔截效果。還有一種情況是startPage()后面緊接著的不是第一條查詢語(yǔ)句中間多了一條別的 SQLPageHelper 會(huì)把分頁(yè)參數(shù)作用到錯(cuò)誤的查詢上。解決先確認(rèn) Maven 依賴?yán)镆氲氖莄om.github.pagehelper:pagehelper再在mybatis-config.xml中注冊(cè)攔截器plugins plugin interceptorcom.github.pagehelper.PageInterceptor property namehelperDialect valuemysql / property namereasonable valuetrue / /plugin /pluginsreasonabletrue這個(gè)參數(shù)的作用是當(dāng)頁(yè)碼超出總頁(yè)數(shù)時(shí)自動(dòng)跳到第一頁(yè)或最后一頁(yè)而不是報(bào)錯(cuò)。排查時(shí)還要注意PageHelper.startPage( pageNum, pageSize )后面必須緊跟第一條select查詢中間不能有其他 SQL 或邏輯判斷。血淚經(jīng)驗(yàn)是有人在一行日志輸出語(yǔ)句放在中間分頁(yè)就神秘失效了這不是玄學(xué)是 PageHelper 基于 ThreadLocal 的實(shí)現(xiàn)機(jī)制決定的。5.2 中文亂碼JSP 頁(yè)面改了 charset 也沒(méi)用現(xiàn)象登錄后首頁(yè)全是問(wèn)號(hào)商品名稱顯示成「???」或者頁(yè)面能顯示中文但插入到數(shù)據(jù)庫(kù)里的值變成了亂碼。原因亂碼的傳播鏈條是「瀏覽器 → Tomcat → Servlet 過(guò)濾器 → 數(shù)據(jù)庫(kù)連接 → MySQL 表結(jié)構(gòu)」五個(gè)環(huán)節(jié)。只改 JSP 頁(yè)面的charsetUTF-8解決的是響應(yīng)方向的問(wèn)題請(qǐng)求方向如果 Tomcat 的 URIEncoding 沒(méi)配置POST 請(qǐng)求體是 UTF-8 但 Tomcat 默認(rèn)按 ISO-8859-1 解碼到 Java 代碼里就已經(jīng)是亂碼了。數(shù)據(jù)庫(kù)連接串沒(méi)加characterEncodingutf8從 Java 到 MySQL 也會(huì)亂碼。解決按順序檢查三處。第一處是jdbc.properties里的連接串確保包含useUnicodetruecharacterEncodingutf8第二處是web.xml里的 CharacterEncodingFilter已在上文給出第三處是 MySQL 建表語(yǔ)句里的字符集如果表結(jié)構(gòu)本身是 latin1代碼層全是 UTF-8 也救不回來(lái)。檢查已存在的表用這條 SQLSHOW TABLE STATUS FROM jbl_supermarket;看到latin1的行執(zhí)行ALTER TABLE t_product CONVERT TO CHARACTER SET utf8mb4;把整張表轉(zhuǎn)過(guò)來(lái)。記住一點(diǎn)UTF-8 和 utf8mb4 的差別在于 emoji 和生僻字不要省錢(qián)用 utf8直接上 utf8mb4 最穩(wěn)妥。5.3 Service 層兩個(gè)數(shù)據(jù)庫(kù)操作一個(gè)成功一個(gè)失敗沒(méi)回滾現(xiàn)象進(jìn)貨時(shí)報(bào)了「明細(xì)不能為空」的異常但重新登錄系統(tǒng)發(fā)現(xiàn)庫(kù)存數(shù)量已經(jīng)增加了或者銷售單沒(méi)插入成功庫(kù)存卻被扣減了。原因最常見(jiàn)的兩個(gè)原因一是Transactional注解加在了類上但類的掃描路徑?jīng)]覆蓋到Spring 容器里這個(gè) Service 根本不是一個(gè)代理對(duì)象二是事務(wù)方法內(nèi)部 catch 了異常并吞掉Spring 感知不到異常就不會(huì)回滾。還有一個(gè)隱蔽的原因Transactional默認(rèn)只對(duì) RuntimeException 回滾業(yè)務(wù)拋出的 checked exception比如自定義的BizException不會(huì)觸發(fā)回滾。解決把注解寫(xiě)成Transactional(rollbackFor Exception.class)并且不要在大事務(wù)方法里用 try-catch 吞異常。如果確實(shí)需要捕獲異常做邏輯處理處理完之后要重新拋出或手動(dòng)調(diào)用TransactionAspectSupport.currentTransactionStatus().setRollbackOnly()。通過(guò) Spring 的聲明式事務(wù)別自己手動(dòng)寫(xiě)回滾邏輯那是把簡(jiǎn)單問(wèn)題復(fù)雜化。5.4 Tomcat 部署后 ClassNotFoundException但 Maven 編譯是成功的現(xiàn)象mvn package順利打出 war 包部署到 Tomcat 后卻報(bào)ClassNotFoundException: com.mysql.jdbc.Driver或者報(bào)找不到某個(gè) Mapper 類。原因Maven 打包時(shí)依賴沒(méi)有打進(jìn)去或者打進(jìn)了重復(fù)的 jar。SSM 項(xiàng)目要在pom.xml里把 Spring、MyBatis、MySQL 驅(qū)動(dòng)等依賴連同一同打進(jìn) war 包如果某個(gè)依賴被標(biāo)記為provided作用域打包時(shí)會(huì)跳過(guò)它。另一個(gè)常見(jiàn)情況是 Tomcat 的lib目錄里放了一份老版本的 Servlet API和項(xiàng)目里引入的版本沖突。解決在項(xiàng)目根目錄執(zhí)行mvn dependency:tree看 MySQL 驅(qū)動(dòng)和 MyBatis 的依賴樹(shù)上有沒(méi)有provided或compile標(biāo)簽。然后在 Tomcat 的webapps目錄找到布署的 war 包解壓目錄進(jìn)入WEB-INF/lib用ls | grep mysql確認(rèn)驅(qū)動(dòng) jar 確實(shí)在。不推薦手動(dòng)往 Tomcatlib目錄里扔 jar那樣會(huì)把所有部署在這個(gè) Tomcat 上的項(xiàng)目都影響屬于擴(kuò)大了排查范圍。5.5 JSP 頁(yè)面上 EL 表達(dá)式原樣輸出取不到值現(xiàn)象頁(yè)面上顯示的是${product.productName}這一串字符串而不是商品名稱本身瀏覽器里查看源碼能看到 EL 表達(dá)式?jīng)]被解析。原因JSP 頁(yè)面的isELIgnored被設(shè)成了 true或者 web.xml 的 Servlet 版本聲明太低JSP 2.0 以下默認(rèn)不解析 EL。還有一種情況是 Controller 里往 Model 塞數(shù)據(jù)的 key 和頁(yè)面上取的 key 不一致比如 Controller 里寫(xiě)model.addAttribute(productList, ...)頁(yè)面里取的是product。解決在 JSP 頁(yè)面頭部顯式聲明% page isELIgnoredfalse %同時(shí)檢查 web.xml 的命名空間是不是 Servlet 3.0 及以上版本。如果頁(yè)面確認(rèn)要使用 JSTL 的${}表達(dá)式頁(yè)面頂部要加上% taglib prefixc urihttp://java.sun.com/jsp/jstl/core %。排查順序是先看 JSP 頂部有沒(méi)有聲明再看 web.xml 版本最后看 Controller 里的 key 名和頁(yè)面是否一致。EL 表達(dá)式取不到值不像 Java 編譯錯(cuò)誤有明確報(bào)錯(cuò)頁(yè)面靜默空白很多人卡在這里半小時(shí)發(fā)現(xiàn)只是 key 少寫(xiě)了一個(gè)字母。6. 給進(jìn)銷存系統(tǒng)加統(tǒng)計(jì)報(bào)表從 JSP 表格到可視化圖表的升級(jí)路徑6.1 用 JFreeChart 在服務(wù)端生成圖片還是前端用 ECharts 拿 JSON 畫(huà)圖進(jìn)銷存系統(tǒng)的論文里通常會(huì)提到「統(tǒng)計(jì)報(bào)表」模塊但很多源碼實(shí)現(xiàn)只是用 JSP 再畫(huà)一個(gè)表格把進(jìn)貨總額、銷售總額列出來(lái)談不上可視化。做這個(gè)模塊的升級(jí)時(shí)有兩種方案。方案一是在 Java 端用 JFreeChart 生成柱狀圖或餅圖圖片直接把圖片路徑塞給 JSP 的img標(biāo)簽展示優(yōu)點(diǎn)是純 Java 實(shí)現(xiàn)不需要前端引入第三方庫(kù)但圖表交互能力弱調(diào)整樣式得重新生成圖片。方案二是在 Controller 里把統(tǒng)計(jì)數(shù)據(jù)封裝成 JSON 返回給 JSPJSP 里用 ECharts 渲染靈活性和美觀度都更好。我傾向方案二因?yàn)樗亚昂蠖寺氊?zé)分得更清楚而且這套 JSON 接口將來(lái)改造前后端分離時(shí)可以無(wú)縫遷移。JSP 頁(yè)面里只需要加一段 JavaScriptscript src${pageContext.request.contextPath}/static/js/echarts.min.js/script script // 從后端接口取統(tǒng)計(jì)數(shù)據(jù)接口返回 [{name: 牛奶, value: 120}, ...] fetch(${pageContext.request.contextPath}/statistics/saleRank) .then(response response.json()) .then(data { const chart echarts.init(document.getElementById(saleChart)); chart.setOption({ title: { text: 本月商品銷量 TOP10 }, tooltip: {}, xAxis: { data: data.map(item item.name) }, yAxis: {}, series: [{ type: bar, data: data.map(item item.value) }] }); }); /script這段代碼用 fetch 調(diào)后端接口取 JSON然后喂給 ECharts邏輯很直白。需要說(shuō)明的是Controller 里對(duì)應(yīng)的接口方法要返回ResponseBody并且把統(tǒng)計(jì) SQL 的結(jié)果映射成Map或ListMap的格式ECharts 拿到后才能正確渲染。自己動(dòng)手升級(jí)這個(gè)模塊時(shí)重點(diǎn)不在代碼本身而是統(tǒng)計(jì)口徑——銷量是按銷售明細(xì)表的 quantity 匯總銷售額是按 amount 匯總兩個(gè) SQL 都要GROUP BY product_id后用ORDER BY SUM(...) DESC LIMIT 10控制返回條數(shù)。6.2 三個(gè)值得動(dòng)手的改造方向Spring Boot 化、數(shù)據(jù)權(quán)限、緩存如果這套 SSMJSP 系統(tǒng)是用來(lái)找工作面試的項(xiàng)目不建議停留在「跑通即可」建議往三個(gè)方向動(dòng)手改一改。第一個(gè)方向是 Spring Boot 化把 XML 配置改成application.yml啟動(dòng)方式從 Tomcat 部署變成mvn spring-boot:run這個(gè)改造過(guò)程能把 Servlet 和 Spring 的底層理解再夯實(shí)一遍。第二個(gè)方向是數(shù)據(jù)權(quán)限給不同角色的登錄用戶配置不同的數(shù)據(jù)范圍——普通員工只能看到自己的操作記錄店長(zhǎng)能看到全店數(shù)據(jù)這個(gè)功能在面試時(shí)很加分。第三個(gè)方向是首頁(yè)庫(kù)存預(yù)警加一層緩存把庫(kù)存低于閾值的商品列表緩存起來(lái)改數(shù)據(jù)庫(kù)時(shí)主動(dòng)清緩存不涉及 Redis 的話先用ConcurrentHashMap手動(dòng)實(shí)現(xiàn)一個(gè)簡(jiǎn)單的 CacheUtil 類理解清楚緩存穿透和緩存一致性的概念后再上 Redis。我自己做這個(gè)課設(shè)題目時(shí)踩過(guò)最深的坑是事務(wù)回滾——當(dāng)時(shí)進(jìn)貨單插入成功但明細(xì)插入時(shí)主鍵沖突沒(méi)拋異常導(dǎo)致庫(kù)存更新了兩次。后來(lái)養(yǎng)成了一個(gè)習(xí)慣寫(xiě)完一個(gè)涉及多表更新的 Service 方法先故意制造一個(gè)錯(cuò)誤跑一遍確認(rèn)數(shù)據(jù)沒(méi)變?cè)賹?xiě)正常的業(yè)務(wù)邏輯。這個(gè)習(xí)慣幫我避免了好幾次線上事故。做課設(shè)和畢設(shè)也是一樣的道理代碼跑通只是起點(diǎn)把每個(gè)邊界情況都驗(yàn)證過(guò)一遍答辯時(shí)才硬氣。希望幫到你。本文還有配套的精品資源點(diǎn)擊獲取