簡介面向百貨零售業的供應鏈管理系統項目基于 Java SSM 整合 Vue/JSP 技術棧構建覆蓋采購、庫存、銷售等核心業務環節適合用作畢業設計或 Java Web 綜合實戰參考。壓縮包共 924 個文件大小約 9.97MB主要包含 136 個 Java 后端源碼、72 個 JSP 頁面、224 個 JS 腳本與 102 個 CSS 樣式文件另有 2 個 SQL 數據庫腳本、項目功能說明文檔及 Eclipse 工程配置目錄結構清晰便于導入與二次開發。系統技術棧涉及 Spring、SpringMVC、MyBatis、Vue 組件化開發可幫助學習者深入理解前后端交互、SSM 整合流程及供應鏈模塊設計。資源經過嚴格調試可直接部署運行并附數據庫腳本和功能文檔能快速搭建演示環境。已有 3522 人學習適合需要完整項目源碼的學生與開發者參考。1. 拿到壓縮包之后先看懂這套百貨供應鏈的SSM骨架解壓ssm685百貨中心供應鏈管理系統jsp-lw.zip之后大概率會看到一個標準的Maven工程src/main/java下面分層放著controller、service、mappersrc/main/webapp/WEB-INF/jsp里躺著所有頁面根目錄還有一份帶lw字樣的說明文檔。這套組合就是典型的SSM框架項目——Spring管對象、Spring MVC管請求分發、MyBatis管數據庫讀寫視圖層用JSP渲染是近十年Java畢業設計和中小型企業內部系統最常見的結構。百貨中心的供應鏈管理業務上繞不開采購、入庫、庫存、銷售、供應商這幾張核心表系統要做的事就是把它們串成閉環。這篇博文不評價項目的代碼質量只講清楚一件事拿到這類SSMJSP項目后怎么快速建立數據模型和請求鏈路的認知然后改造成自己能跑、能講、能擴展的狀態。2. 數據先于代碼供應鏈表結構與MyBatis映射的設計邏輯2.1 百貨供應鏈最少需要幾張表百貨中心做供應鏈管理核心是把商品從供應商送到消費者手里中間經過倉庫。最少得有四類數據供應商、商品、入庫/采購、出庫/銷售。常見做法是再加一張庫存表或者直接在商品表冗余庫存字段小系統為了減少join查詢通常會直接在goods表里放stock字段。CREATE TABLE supplier ( sid int(11) NOT NULL AUTO_INCREMENT, sname varchar(50) NOT NULL, contact varchar(20) DEFAULT NULL, phone varchar(20) DEFAULT NULL, address varchar(100) DEFAULT NULL, PRIMARY KEY (sid) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; CREATE TABLE goods ( gid int(11) NOT NULL AUTO_INCREMENT, gname varchar(50) NOT NULL, price decimal(10,2) NOT NULL, stock int(11) NOT NULL DEFAULT 0, sid int(11) DEFAULT NULL, category varchar(30) DEFAULT NULL, PRIMARY KEY (gid), KEY fk_supplier (sid), CONSTRAINT fk_supplier FOREIGN KEY (sid) REFERENCES supplier (sid) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;這兩張表是基礎采購單和銷售單需要單獨建表。采購單記錄每次從供應商進貨的商品、數量和入庫時間銷售單記錄客戶買走的商品、數量和出庫時間。訂單表里的外鍵指向goods.gid不要直接存商品名稱字符串否則供應商改價或者商品改名后歷史數據會出現不一致。CREATE TABLE purchase_order ( poid int(11) NOT NULL AUTO_INCREMENT, gid int(11) NOT NULL, quantity int(11) NOT NULL, unit_price decimal(10,2) NOT NULL, create_time datetime DEFAULT CURRENT_TIMESTAMP, status tinyint(1) DEFAULT 1, PRIMARY KEY (poid), KEY fk_goods (gid), CONSTRAINT fk_goods FOREIGN KEY (gid) REFERENCES goods (gid) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;MySQL 8.0以下版本推薦utf8mb4原因不復雜百貨商品的描述信息里可能帶上emoji或者生僻字utf8mb3也就是常說的utf8存不了四個字節的字符。設計表時要注意供應商和商品是一對多關系這個關系在后續的JSP下拉框聯動中會用到。2.2 MyBatis Mapper如何對應到JSON和頁面字段SSM項目里的MyBatis層通常一個GoodsMapper.xml對應一張表的CRUD。核心是寫一個分頁查詢和庫存變更的SQL這兩段是供應鏈系統的重頭戲。分頁查詢在MyBatis里用手寫LIMIT最直接PageHelper插件雖然方便但老項目里未必引了依賴。select idselectGoodsPage resultTypecom.demo.entity.Goods SELECT g.gid, g.gname, g.price, g.stock, g.category, s.sname AS supplierName FROM goods g LEFT JOIN supplier s ON g.sid s.sid where if testgname ! null and gname ! AND g.gname LIKE CONCAT(%, #{gname}, %) /if if testcategory ! null and category ! AND g.category #{category} /if /where ORDER BY g.gid DESC LIMIT #{offset}, #{pageSize} /select#{offset}和#{pageSize}分別代表跳過的行數和每頁條數前端傳頁碼過來時Controller里做一個簡單換算offset (currentPage - 1) * pageSize。這里容易踩的坑是LIMIT后面不能直接用#{}拼寫列名或關鍵字MyBatis的預編譯只處理參數值不處理表名和列名。resultType直接映射到Java實體類實體類里如果加了supplierName這個屬性注意left join出來的別名必須和屬性名嚴格一致否則數據返回null。Mapper接口和XML的綁定是另一個高頻故障點對應關系的代碼長這樣public interface GoodsMapper { ListGoods selectGoodsPage(Param(gname) String gname, Param(category) String category, Param(offset) int offset, Param(pageSize) int pageSize); }XML里select的id必須與接口方法名完全一樣namespace指向接口的全限定名這兩個地方對不上啟動Tomcat時MyBatis綁定異常就會直接報錯。用Param注解傳多個參數是通用做法比用Map更安全因為XML里寫#{gname}時編譯器能校驗到類型。2.3 庫存扣減為什么不能先查再改供應鏈系統的庫存邏輯是并發事故重災區。商品表里如果只有stock字段記庫存的減法時不能用SELECT stock查出當前值然后在Java里算出新值再UPDATE這種思路在單人操作時沒問題兩個管理員同時賣同一件商品時就會超賣。正確做法是把扣減寫進一條SQL的條件里UPDATE goods SET stock stock - #{quantity} WHERE gid #{gid} AND stock #{quantity}這條SQL的返回值是受影響的行數等于1說明扣減成功等于0說明庫存不足或商品不存在。Service層判斷這個返回值失敗就拋業務異常JSP頁面捕獲后提示用戶。這個寫法在很多老項目里沒有改造時建議優先補上。想要更強的保障就用SELECT ... FOR UPDATE鎖行但小系統里stock #{quantity}條件配合行鎖已經夠用。3. JSP視圖層與Controller的參數流轉從表單到數據庫的完整鏈路3.1 請求從哪里來JSP表單的name與Controller的參數綁定百貨供應鏈系統里最常見的操作是做一張采購單。JSP頁面用表單提交數據每個input標簽的name屬性值就是Controller方法參數的綁定依據這個對應關系是SSM里最基礎也最容易忽略的規則。form action${pageContext.request.contextPath}/purchase/add methodpost input typehidden namegid value${goods.gid} / select namesupplierId c:forEach items${supplierList} varsup option value${sup.sid}${sup.sname}/option /c:forEach /select input typenumber namequantity min1 required / input typetext nameremark maxlength100 / button typesubmit提交采購單/button /form對應的Controller接收參數常見寫法是用JavaBean直接接收也可以用RequestParam逐個接收。JavaBean方式更貼合這套項目的習慣因為頁面字段與實體屬性一一對應時Spring MVC會自動完成類型轉換和注入。Controller RequestMapping(/purchase) public class PurchaseController { Autowired private PurchaseService purchaseService; PostMapping(/add) public String addPurchase(PurchaseOrder order, RedirectAttributes attr) { boolean success purchaseService.createPurchaseOrder(order); if (success) { attr.addFlashAttribute(msg, 采購單創建成功); } else { attr.addFlashAttribute(msg, 庫存扣減失敗請檢查庫存量); } return redirect:/purchase/list; } }方法簽名里PurchaseOrder order這個參數對象屬性名必須是gid、quantity、remark對應JSP里的name。RedirectAttributes用來跨重定向傳遞提示消息防止刷新頁面時表單重復提交。這里的redirect:前綴非常重要——如果直接返回purchase/list地址欄還是/purchase/addF5一刷新就會重復插入一條采購單。3.2 JSP渲染數據時的El表達式與JSTL標簽范圍頁面端循環數據一般用c:forEach配合EL表達式取值。$符號的規則是取作用域里的屬性Controller返回的ModelAndView里放了什么頁面就能取到什么。table border1 cellpadding8 tr th商品名稱/thth采購數量/thth單價/thth創建時間/thth操作/th /tr c:forEach items${purchaseList} varpo c:if test${po.status 1} tr td${po.goodsName}/td td${po.quantity}/td td${po.unitPrice}/td tdfmt:formatDate value${po.createTime} patternyyyy-MM-dd HH:mm:ss//td tda href${pageContext.request.contextPath}/purchase/detail/${po.poid}詳情/a/td /tr /c:if /c:forEach /table注意c:if的test條件里po.status 1這個寫法EL表達式里數字會被當作Long類型處理JSP頁面不會自動把整形轉成Integer所以實體類里status字段要定義成Integer避免空指針或類型不匹配。fmt:formatDate用來格式化時間頁面顯示的createTime類型是java.util.Date時才能生效如果寫的是LocalDateTime需要額外處理或者改成String類型再顯示。JSP的搜索意圖里有個高頻問題修改完頁面后瀏覽器還在顯示舊內容。這套老項目通常用Tomcat部署IDE里改JSP文件后有時需要重啟或清理work目錄——JSP會被Tomcat編譯成Java文件再編譯成Class存放在CATALINA_HOME/work/Catalina/localhost/應用名/org/apache/jsp目錄下改完頁面不刷新時去這個目錄刪掉對應的編譯產物即可這算是一個JSP改后不生效的排查手段。3.3 Controller返回JSON給頁面做異步刷新供應鏈管理系統的供應商下拉框在商品頁和采購頁都會用到。傳統做法是頁面加載時用EL直接渲染supplierList數據量幾百條沒問題但如果有二級聯動選供應商后再加載該供應商的商品就需要Controller返回JSONJSP用AJAX異步獲取。Spring MVC對JSON的原生支持來自ResponseBody注解GetMapping(/supplier/goods) ResponseBody public ListGoods getGoodsBySupplier(RequestParam(sid) Integer sid) { return goodsService.getGoodsBySupplierId(sid); }只要pom.xml里引入了jackson-databind依賴返回值就會被自動序列化成JSON數組。頁面端配合jQuery發起請求數據渲染到select里即可。有不少SSM項目用fastjson代替jackson但期間鬧出過反序列化漏洞現階段的建議是用jackson或者gson。JSON處理在JSP頁面里還有一個高頻搜索點是jsp jsonarray import這個通常指在JSP里導入Java的JSON工具類老項目里會直接% page importnet.sf.json.JSONArray %但這寫法不推薦——邏輯應該寫到Controller或者Service里JSP只做顯示。4. 部署運行時必踩的坑Tomcat版本、JDK編譯與數據一致性4.1 從zip到能訪問war包能跑起來的三要素解壓ssm685百貨中心供應鏈管理系統jsp-lw.zip之后先把目錄結構弄成Maven標準布局確認pom.xml里JDK版本然后二選一用IDEA打開直接跑或者用命令行Maven打包成war放進Tomcat。比較穩妥的方式是在IDEA里配置Tomcat運行這套SSM項目能跑起來的組合通常鎖定JDK 8 Tomcat 8.5/9 MySQL 5.7原因在于老項目里的依賴版本大多基于JDK 8編譯比如CGLIB代理和JSP編譯器在新JDK上偶發不兼容。pom.xml里關鍵的坐標配置長這樣properties maven.compiler.source1.8/maven.compiler.source maven.compiler.target1.8/maven.compiler.target project.build.sourceEncodingUTF-8/project.build.sourceEncoding /properties dependencies dependency groupIdorg.springframework/groupId artifactIdspring-context/artifactId version5.1.20.RELEASE/version /dependency dependency groupIdorg.springframework/groupId artifactIdspring-webmvc/artifactId version5.1.20.RELEASE/version /dependency dependency groupIdorg.mybatis/groupId artifactIdmybatis/artifactId version3.5.5/version /dependency dependency groupIdorg.mybatis/groupId artifactIdmybatis-spring/artifactId version2.0.5/version /dependency dependency groupIdmysql/groupId artifactIdmysql-connector-java/artifactId version5.1.49/version /dependency /dependenciesSpring 5.x版本要求JDK 8以上Tomcat 9對應Servlet 4.0規范而Spring MVC的DispatcherServlet在這個容器里不需要額外引javax.servlet-api的依賴容器自帶。MySQL驅動選5.1.49配合MySQL 5.7最穩如果用的是MySQL 8.0驅動需要升到com.mysql.cj.jdbc.Driver并把URL改造成jdbc:mysql://localhost:3306/ssm_db?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/Shanghai——少了serverTimezone參數會直接拋時區錯誤這是老項目遷移MySQL 8.0時最容易卡住的位置。4.2 啟動報錯看哪幾行驅動類、端口、JDBC驅動版本運行過程中有四個高頻報錯按頻率排每個對應的原因和處理手段都不同。第一個是ClassNotFoundException: com.mysql.jdbc.Driver字面意思是沒有這個驅動類實際是mysql-connector-java依賴沒打進war包或者版本太高導致類路徑變化解決辦法是檢查WEB-INF/lib下是否有jar包。第二個是Port 8080 already in use這是端口占用。Windows下用netstat -ano | findstr 8080查出PID然后taskkill /PID 進程號 /F結束進程。Linux下用lsof -i:8080定位kill -9處理。換端口就改Tomcat的server.xml里的Connector port8080注意同時核對項目代碼里有沒有寫死端口號比如數據庫連接URL里誤寫端口。第三個是Public Key Retrieval is not allowed這是MySQL 8.0的驅動與數據庫握手時要求獲取RSA公鑰但連接URL沒開啟對應開關。解決辦法是URL末尾加allowPublicKeyRetrievaltrue。第四個是JSP編譯錯誤頁面報Unable to compile class for JSP這種一般是JDK版本太高Tomcat 9以下的容器無法用JDK 11編譯JSP或者是JSP文件里用了JDK 8之后移除的類比如StringUtils的舊包路徑。所以最省力的組合就是JDK 8能避開八成的兼容問題。4.3 數據一致性一個采購事務里的兩張表供應鏈系統里一次采購操作要同時影響purchase_order和goods兩張表這就涉及事務。老項目里常見的是寫只更新訂單不扣庫存或者扣了庫存但訂單失敗了庫存改不回來。SSM的事務控制要在Service方法上加Transactional注解Service public class PurchaseServiceImpl implements PurchaseService { Autowired private PurchaseOrderMapper purchaseOrderMapper; Autowired private GoodsMapper goodsMapper; Override Transactional(rollbackFor Exception.class) public boolean createPurchaseOrder(PurchaseOrder order) { int updated goodsMapper.reduceStock(order.getGid(), order.getQuantity()); if (updated 0) { throw new BusinessException(庫存不足); } return purchaseOrderMapper.insert(order) 0; } }Transactional(rollbackFor Exception.class)的語義是運行時異常和檢查異常都能觸發回滾。小坑在于Spring聲明式事務默認只對RuntimeException回滾加異常時如果不把rollbackFor配上業務拋出的Exception子類根本不會回滾數據庫里就出現訂單有了、庫存沒減的一致性問題。另一個驗證方法是看控制臺有沒有Creating new transaction日志沒有說明事務管理器沒生效檢查Spring配置文件里tx:annotation-driven transaction-managertransactionManager/是否配置。事務在并發量不高的管理系統里性能損耗可控不要為了省事去掉事務。Transactional加在private方法上是無效的這點是很多JSP老項目改造時的隱含bug——注解只有加在public方法上且通過代理調用才會被攔截同類內部調用不會走代理。5. 壓軸的優化手法庫存扣減與頁面緩存的工程化寫法5.1 用樂觀鎖改造扣庫存的最優解在2.3節的stock #{quantity}寫法基礎上再疊加一個樂觀鎖版本號字段。供應鏈系統的庫存扣減在高并發下需要更嚴謹的防線version字段每次更新加1更新條件里帶AND version #{version}影響行數為0則重試標準的CAS操作。ALTER TABLE goods ADD COLUMN version INT NOT NULL DEFAULT 0; UPDATE goods SET stock stock - #{quantity}, version version 1 WHERE gid #{gid} AND stock #{quantity} AND version #{version}Service層拿到更新行數為0就拋異常讓用戶重新提交。版本號不必暴露給前端從商品詳情查出來放在表單的隱藏字段里即可。這么做能防止ABA問題——庫存被兩個請求讀出相同的值又寫回導致丟失一次扣減。反映到JSP頁面商品詳情按鈕跳轉時帶上version參數采購表單把這個字段作為隱藏輸入項提交這條鏈路就完整了。5.2 JSP頁面響應速度的三個手段百貨系統的商品列表頁往往會隨著數據量增大變得越來越卡第一個手段是JSP片段緩存商品分類導航、供應商信息這類不常變的內容用c:import或JSTL的c:cache做片段緩存注意c:cache需要引入jstl的cache標簽庫很多老項目沒有用Apache Commons JSP Tags替代來給頁面加時間緩存。第二個手段是SQL層面及時分頁前端LIMIT只查當前頁數據禁止查出全部List再在內存里截取。第三個手段是把商品圖片、靜態CSS和JS從JSP目錄移到獨立的靜態資源路徑用Nginx這類Web服務器做靜態文件響應Tomcat只處理動態請求壓力會下降明顯。5.3 改完之后的驗證清單部署優化完成后至少要驗證三條主鏈路。先驗證一條商品瀏覽路徑點開首頁搜索商品進詳情看庫存量是否與數據庫一致。再驗證一條采購鏈路提交采購單庫存減少采購列表出現新記錄供應商名稱正確顯示。最后驗證并發扣減用JMeter或Postman并發發5個相同的采購請求庫存只會扣減成功一次訂單表里只有一條記錄其余請求提示庫存不足。驗證時把日志級別調整到DEBUG重點觀察MyBatis輸出的SQL中UPDATE goods SET stock stock - ?的affected rows返回值結合事務日志看是否有提交回滾記錄。一套SSMJSP的供應鏈系統掌握了請求從JSP到Controller再到Mapper再回到頁面的完整回路理解了庫存扣減的數據一致性問題剩下的就是在這個骨架上繼續加報表、加登錄權限、加供應商結算模塊。每個版本迭代都從最小可運行狀態開始改改一步驗證一步比推翻重來更能積累可復用的技術資產。本文還有配套的精品資源點擊獲取 SSM+JSP百貨供應鏈管理系統實戰：表結構設計、庫存扣減與事務優化
簡介面向百貨零售業的供應鏈管理系統項目基于 Java SSM 整合 Vue/JSP 技術棧構建覆蓋采購、庫存、銷售等核心業務環節適合用作畢業設計或 Java Web 綜合實戰參考。壓縮包共 924 個文件大小約 9.97MB主要包含 136 個 Java 后端源碼、72 個 JSP 頁面、224 個 JS 腳本與 102 個 CSS 樣式文件另有 2 個 SQL 數據庫腳本、項目功能說明文檔及 Eclipse 工程配置目錄結構清晰便于導入與二次開發。系統技術棧涉及 Spring、SpringMVC、MyBatis、Vue 組件化開發可幫助學習者深入理解前后端交互、SSM 整合流程及供應鏈模塊設計。資源經過嚴格調試可直接部署運行并附數據庫腳本和功能文檔能快速搭建演示環境。已有 3522 人學習適合需要完整項目源碼的學生與開發者參考。1. 拿到壓縮包之后先看懂這套百貨供應鏈的SSM骨架解壓ssm685百貨中心供應鏈管理系統jsp-lw.zip之后大概率會看到一個標準的Maven工程src/main/java下面分層放著controller、service、mappersrc/main/webapp/WEB-INF/jsp里躺著所有頁面根目錄還有一份帶lw字樣的說明文檔。這套組合就是典型的SSM框架項目——Spring管對象、Spring MVC管請求分發、MyBatis管數據庫讀寫視圖層用JSP渲染是近十年Java畢業設計和中小型企業內部系統最常見的結構。百貨中心的供應鏈管理業務上繞不開采購、入庫、庫存、銷售、供應商這幾張核心表系統要做的事就是把它們串成閉環。這篇博文不評價項目的代碼質量只講清楚一件事拿到這類SSMJSP項目后怎么快速建立數據模型和請求鏈路的認知然后改造成自己能跑、能講、能擴展的狀態。2. 數據先于代碼供應鏈表結構與MyBatis映射的設計邏輯2.1 百貨供應鏈最少需要幾張表百貨中心做供應鏈管理核心是把商品從供應商送到消費者手里中間經過倉庫。最少得有四類數據供應商、商品、入庫/采購、出庫/銷售。常見做法是再加一張庫存表或者直接在商品表冗余庫存字段小系統為了減少join查詢通常會直接在goods表里放stock字段。CREATE TABLE supplier ( sid int(11) NOT NULL AUTO_INCREMENT, sname varchar(50) NOT NULL, contact varchar(20) DEFAULT NULL, phone varchar(20) DEFAULT NULL, address varchar(100) DEFAULT NULL, PRIMARY KEY (sid) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; CREATE TABLE goods ( gid int(11) NOT NULL AUTO_INCREMENT, gname varchar(50) NOT NULL, price decimal(10,2) NOT NULL, stock int(11) NOT NULL DEFAULT 0, sid int(11) DEFAULT NULL, category varchar(30) DEFAULT NULL, PRIMARY KEY (gid), KEY fk_supplier (sid), CONSTRAINT fk_supplier FOREIGN KEY (sid) REFERENCES supplier (sid) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;這兩張表是基礎采購單和銷售單需要單獨建表。采購單記錄每次從供應商進貨的商品、數量和入庫時間銷售單記錄客戶買走的商品、數量和出庫時間。訂單表里的外鍵指向goods.gid不要直接存商品名稱字符串否則供應商改價或者商品改名后歷史數據會出現不一致。CREATE TABLE purchase_order ( poid int(11) NOT NULL AUTO_INCREMENT, gid int(11) NOT NULL, quantity int(11) NOT NULL, unit_price decimal(10,2) NOT NULL, create_time datetime DEFAULT CURRENT_TIMESTAMP, status tinyint(1) DEFAULT 1, PRIMARY KEY (poid), KEY fk_goods (gid), CONSTRAINT fk_goods FOREIGN KEY (gid) REFERENCES goods (gid) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;MySQL 8.0以下版本推薦utf8mb4原因不復雜百貨商品的描述信息里可能帶上emoji或者生僻字utf8mb3也就是常說的utf8存不了四個字節的字符。設計表時要注意供應商和商品是一對多關系這個關系在后續的JSP下拉框聯動中會用到。2.2 MyBatis Mapper如何對應到JSON和頁面字段SSM項目里的MyBatis層通常一個GoodsMapper.xml對應一張表的CRUD。核心是寫一個分頁查詢和庫存變更的SQL這兩段是供應鏈系統的重頭戲。分頁查詢在MyBatis里用手寫LIMIT最直接PageHelper插件雖然方便但老項目里未必引了依賴。select idselectGoodsPage resultTypecom.demo.entity.Goods SELECT g.gid, g.gname, g.price, g.stock, g.category, s.sname AS supplierName FROM goods g LEFT JOIN supplier s ON g.sid s.sid where if testgname ! null and gname ! AND g.gname LIKE CONCAT(%, #{gname}, %) /if if testcategory ! null and category ! AND g.category #{category} /if /where ORDER BY g.gid DESC LIMIT #{offset}, #{pageSize} /select#{offset}和#{pageSize}分別代表跳過的行數和每頁條數前端傳頁碼過來時Controller里做一個簡單換算offset (currentPage - 1) * pageSize。這里容易踩的坑是LIMIT后面不能直接用#{}拼寫列名或關鍵字MyBatis的預編譯只處理參數值不處理表名和列名。resultType直接映射到Java實體類實體類里如果加了supplierName這個屬性注意left join出來的別名必須和屬性名嚴格一致否則數據返回null。Mapper接口和XML的綁定是另一個高頻故障點對應關系的代碼長這樣public interface GoodsMapper { ListGoods selectGoodsPage(Param(gname) String gname, Param(category) String category, Param(offset) int offset, Param(pageSize) int pageSize); }XML里select的id必須與接口方法名完全一樣namespace指向接口的全限定名這兩個地方對不上啟動Tomcat時MyBatis綁定異常就會直接報錯。用Param注解傳多個參數是通用做法比用Map更安全因為XML里寫#{gname}時編譯器能校驗到類型。2.3 庫存扣減為什么不能先查再改供應鏈系統的庫存邏輯是并發事故重災區。商品表里如果只有stock字段記庫存的減法時不能用SELECT stock查出當前值然后在Java里算出新值再UPDATE這種思路在單人操作時沒問題兩個管理員同時賣同一件商品時就會超賣。正確做法是把扣減寫進一條SQL的條件里UPDATE goods SET stock stock - #{quantity} WHERE gid #{gid} AND stock #{quantity}這條SQL的返回值是受影響的行數等于1說明扣減成功等于0說明庫存不足或商品不存在。Service層判斷這個返回值失敗就拋業務異常JSP頁面捕獲后提示用戶。這個寫法在很多老項目里沒有改造時建議優先補上。想要更強的保障就用SELECT ... FOR UPDATE鎖行但小系統里stock #{quantity}條件配合行鎖已經夠用。3. JSP視圖層與Controller的參數流轉從表單到數據庫的完整鏈路3.1 請求從哪里來JSP表單的name與Controller的參數綁定百貨供應鏈系統里最常見的操作是做一張采購單。JSP頁面用表單提交數據每個input標簽的name屬性值就是Controller方法參數的綁定依據這個對應關系是SSM里最基礎也最容易忽略的規則。form action${pageContext.request.contextPath}/purchase/add methodpost input typehidden namegid value${goods.gid} / select namesupplierId c:forEach items${supplierList} varsup option value${sup.sid}${sup.sname}/option /c:forEach /select input typenumber namequantity min1 required / input typetext nameremark maxlength100 / button typesubmit提交采購單/button /form對應的Controller接收參數常見寫法是用JavaBean直接接收也可以用RequestParam逐個接收。JavaBean方式更貼合這套項目的習慣因為頁面字段與實體屬性一一對應時Spring MVC會自動完成類型轉換和注入。Controller RequestMapping(/purchase) public class PurchaseController { Autowired private PurchaseService purchaseService; PostMapping(/add) public String addPurchase(PurchaseOrder order, RedirectAttributes attr) { boolean success purchaseService.createPurchaseOrder(order); if (success) { attr.addFlashAttribute(msg, 采購單創建成功); } else { attr.addFlashAttribute(msg, 庫存扣減失敗請檢查庫存量); } return redirect:/purchase/list; } }方法簽名里PurchaseOrder order這個參數對象屬性名必須是gid、quantity、remark對應JSP里的name。RedirectAttributes用來跨重定向傳遞提示消息防止刷新頁面時表單重復提交。這里的redirect:前綴非常重要——如果直接返回purchase/list地址欄還是/purchase/addF5一刷新就會重復插入一條采購單。3.2 JSP渲染數據時的El表達式與JSTL標簽范圍頁面端循環數據一般用c:forEach配合EL表達式取值。$符號的規則是取作用域里的屬性Controller返回的ModelAndView里放了什么頁面就能取到什么。table border1 cellpadding8 tr th商品名稱/thth采購數量/thth單價/thth創建時間/thth操作/th /tr c:forEach items${purchaseList} varpo c:if test${po.status 1} tr td${po.goodsName}/td td${po.quantity}/td td${po.unitPrice}/td tdfmt:formatDate value${po.createTime} patternyyyy-MM-dd HH:mm:ss//td tda href${pageContext.request.contextPath}/purchase/detail/${po.poid}詳情/a/td /tr /c:if /c:forEach /table注意c:if的test條件里po.status 1這個寫法EL表達式里數字會被當作Long類型處理JSP頁面不會自動把整形轉成Integer所以實體類里status字段要定義成Integer避免空指針或類型不匹配。fmt:formatDate用來格式化時間頁面顯示的createTime類型是java.util.Date時才能生效如果寫的是LocalDateTime需要額外處理或者改成String類型再顯示。JSP的搜索意圖里有個高頻問題修改完頁面后瀏覽器還在顯示舊內容。這套老項目通常用Tomcat部署IDE里改JSP文件后有時需要重啟或清理work目錄——JSP會被Tomcat編譯成Java文件再編譯成Class存放在CATALINA_HOME/work/Catalina/localhost/應用名/org/apache/jsp目錄下改完頁面不刷新時去這個目錄刪掉對應的編譯產物即可這算是一個JSP改后不生效的排查手段。3.3 Controller返回JSON給頁面做異步刷新供應鏈管理系統的供應商下拉框在商品頁和采購頁都會用到。傳統做法是頁面加載時用EL直接渲染supplierList數據量幾百條沒問題但如果有二級聯動選供應商后再加載該供應商的商品就需要Controller返回JSONJSP用AJAX異步獲取。Spring MVC對JSON的原生支持來自ResponseBody注解GetMapping(/supplier/goods) ResponseBody public ListGoods getGoodsBySupplier(RequestParam(sid) Integer sid) { return goodsService.getGoodsBySupplierId(sid); }只要pom.xml里引入了jackson-databind依賴返回值就會被自動序列化成JSON數組。頁面端配合jQuery發起請求數據渲染到select里即可。有不少SSM項目用fastjson代替jackson但期間鬧出過反序列化漏洞現階段的建議是用jackson或者gson。JSON處理在JSP頁面里還有一個高頻搜索點是jsp jsonarray import這個通常指在JSP里導入Java的JSON工具類老項目里會直接% page importnet.sf.json.JSONArray %但這寫法不推薦——邏輯應該寫到Controller或者Service里JSP只做顯示。4. 部署運行時必踩的坑Tomcat版本、JDK編譯與數據一致性4.1 從zip到能訪問war包能跑起來的三要素解壓ssm685百貨中心供應鏈管理系統jsp-lw.zip之后先把目錄結構弄成Maven標準布局確認pom.xml里JDK版本然后二選一用IDEA打開直接跑或者用命令行Maven打包成war放進Tomcat。比較穩妥的方式是在IDEA里配置Tomcat運行這套SSM項目能跑起來的組合通常鎖定JDK 8 Tomcat 8.5/9 MySQL 5.7原因在于老項目里的依賴版本大多基于JDK 8編譯比如CGLIB代理和JSP編譯器在新JDK上偶發不兼容。pom.xml里關鍵的坐標配置長這樣properties maven.compiler.source1.8/maven.compiler.source maven.compiler.target1.8/maven.compiler.target project.build.sourceEncodingUTF-8/project.build.sourceEncoding /properties dependencies dependency groupIdorg.springframework/groupId artifactIdspring-context/artifactId version5.1.20.RELEASE/version /dependency dependency groupIdorg.springframework/groupId artifactIdspring-webmvc/artifactId version5.1.20.RELEASE/version /dependency dependency groupIdorg.mybatis/groupId artifactIdmybatis/artifactId version3.5.5/version /dependency dependency groupIdorg.mybatis/groupId artifactIdmybatis-spring/artifactId version2.0.5/version /dependency dependency groupIdmysql/groupId artifactIdmysql-connector-java/artifactId version5.1.49/version /dependency /dependenciesSpring 5.x版本要求JDK 8以上Tomcat 9對應Servlet 4.0規范而Spring MVC的DispatcherServlet在這個容器里不需要額外引javax.servlet-api的依賴容器自帶。MySQL驅動選5.1.49配合MySQL 5.7最穩如果用的是MySQL 8.0驅動需要升到com.mysql.cj.jdbc.Driver并把URL改造成jdbc:mysql://localhost:3306/ssm_db?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/Shanghai——少了serverTimezone參數會直接拋時區錯誤這是老項目遷移MySQL 8.0時最容易卡住的位置。4.2 啟動報錯看哪幾行驅動類、端口、JDBC驅動版本運行過程中有四個高頻報錯按頻率排每個對應的原因和處理手段都不同。第一個是ClassNotFoundException: com.mysql.jdbc.Driver字面意思是沒有這個驅動類實際是mysql-connector-java依賴沒打進war包或者版本太高導致類路徑變化解決辦法是檢查WEB-INF/lib下是否有jar包。第二個是Port 8080 already in use這是端口占用。Windows下用netstat -ano | findstr 8080查出PID然后taskkill /PID 進程號 /F結束進程。Linux下用lsof -i:8080定位kill -9處理。換端口就改Tomcat的server.xml里的Connector port8080注意同時核對項目代碼里有沒有寫死端口號比如數據庫連接URL里誤寫端口。第三個是Public Key Retrieval is not allowed這是MySQL 8.0的驅動與數據庫握手時要求獲取RSA公鑰但連接URL沒開啟對應開關。解決辦法是URL末尾加allowPublicKeyRetrievaltrue。第四個是JSP編譯錯誤頁面報Unable to compile class for JSP這種一般是JDK版本太高Tomcat 9以下的容器無法用JDK 11編譯JSP或者是JSP文件里用了JDK 8之后移除的類比如StringUtils的舊包路徑。所以最省力的組合就是JDK 8能避開八成的兼容問題。4.3 數據一致性一個采購事務里的兩張表供應鏈系統里一次采購操作要同時影響purchase_order和goods兩張表這就涉及事務。老項目里常見的是寫只更新訂單不扣庫存或者扣了庫存但訂單失敗了庫存改不回來。SSM的事務控制要在Service方法上加Transactional注解Service public class PurchaseServiceImpl implements PurchaseService { Autowired private PurchaseOrderMapper purchaseOrderMapper; Autowired private GoodsMapper goodsMapper; Override Transactional(rollbackFor Exception.class) public boolean createPurchaseOrder(PurchaseOrder order) { int updated goodsMapper.reduceStock(order.getGid(), order.getQuantity()); if (updated 0) { throw new BusinessException(庫存不足); } return purchaseOrderMapper.insert(order) 0; } }Transactional(rollbackFor Exception.class)的語義是運行時異常和檢查異常都能觸發回滾。小坑在于Spring聲明式事務默認只對RuntimeException回滾加異常時如果不把rollbackFor配上業務拋出的Exception子類根本不會回滾數據庫里就出現訂單有了、庫存沒減的一致性問題。另一個驗證方法是看控制臺有沒有Creating new transaction日志沒有說明事務管理器沒生效檢查Spring配置文件里tx:annotation-driven transaction-managertransactionManager/是否配置。事務在并發量不高的管理系統里性能損耗可控不要為了省事去掉事務。Transactional加在private方法上是無效的這點是很多JSP老項目改造時的隱含bug——注解只有加在public方法上且通過代理調用才會被攔截同類內部調用不會走代理。5. 壓軸的優化手法庫存扣減與頁面緩存的工程化寫法5.1 用樂觀鎖改造扣庫存的最優解在2.3節的stock #{quantity}寫法基礎上再疊加一個樂觀鎖版本號字段。供應鏈系統的庫存扣減在高并發下需要更嚴謹的防線version字段每次更新加1更新條件里帶AND version #{version}影響行數為0則重試標準的CAS操作。ALTER TABLE goods ADD COLUMN version INT NOT NULL DEFAULT 0; UPDATE goods SET stock stock - #{quantity}, version version 1 WHERE gid #{gid} AND stock #{quantity} AND version #{version}Service層拿到更新行數為0就拋異常讓用戶重新提交。版本號不必暴露給前端從商品詳情查出來放在表單的隱藏字段里即可。這么做能防止ABA問題——庫存被兩個請求讀出相同的值又寫回導致丟失一次扣減。反映到JSP頁面商品詳情按鈕跳轉時帶上version參數采購表單把這個字段作為隱藏輸入項提交這條鏈路就完整了。5.2 JSP頁面響應速度的三個手段百貨系統的商品列表頁往往會隨著數據量增大變得越來越卡第一個手段是JSP片段緩存商品分類導航、供應商信息這類不常變的內容用c:import或JSTL的c:cache做片段緩存注意c:cache需要引入jstl的cache標簽庫很多老項目沒有用Apache Commons JSP Tags替代來給頁面加時間緩存。第二個手段是SQL層面及時分頁前端LIMIT只查當前頁數據禁止查出全部List再在內存里截取。第三個手段是把商品圖片、靜態CSS和JS從JSP目錄移到獨立的靜態資源路徑用Nginx這類Web服務器做靜態文件響應Tomcat只處理動態請求壓力會下降明顯。5.3 改完之后的驗證清單部署優化完成后至少要驗證三條主鏈路。先驗證一條商品瀏覽路徑點開首頁搜索商品進詳情看庫存量是否與數據庫一致。再驗證一條采購鏈路提交采購單庫存減少采購列表出現新記錄供應商名稱正確顯示。最后驗證并發扣減用JMeter或Postman并發發5個相同的采購請求庫存只會扣減成功一次訂單表里只有一條記錄其余請求提示庫存不足。驗證時把日志級別調整到DEBUG重點觀察MyBatis輸出的SQL中UPDATE goods SET stock stock - ?的affected rows返回值結合事務日志看是否有提交回滾記錄。一套SSMJSP的供應鏈系統掌握了請求從JSP到Controller再到Mapper再回到頁面的完整回路理解了庫存扣減的數據一致性問題剩下的就是在這個骨架上繼續加報表、加登錄權限、加供應商結算模塊。每個版本迭代都從最小可運行狀態開始改改一步驗證一步比推翻重來更能積累可復用的技術資產。本文還有配套的精品資源點擊獲取