場供銷系統(tǒng)源碼拆解：架構(gòu)、事務(wù)與部署實戰(zhàn))
簡介一套面向農(nóng)場管理人員和Java初學(xué)者的xx農(nóng)場供銷一體化系統(tǒng)源碼及說明文檔代碼基于SSMSpringSpringMVCMyBatis與JSP技術(shù)棧結(jié)合MySQL數(shù)據(jù)庫與Maven構(gòu)建工具實現(xiàn)農(nóng)產(chǎn)品信息管理、分類管理、在線訂購、會員管理及配送等核心功能。系統(tǒng)按角色分為管理員端與會員端管理員可維護商品與分類、處理訂購和會員數(shù)據(jù)會員則能瀏覽農(nóng)產(chǎn)品并提交訂購需求。壓縮包約23.55MB內(nèi)部源碼與說明文檔可配合IDEA或Eclipse進行部署數(shù)據(jù)庫工具可使用Navicat或SQLyog。資源已吸引104人學(xué)習(xí)適合用來理解SSM各層整合、JSP動態(tài)頁面開發(fā)、數(shù)據(jù)庫表結(jié)構(gòu)設(shè)計以及Maven項目管理流程。通過閱讀源碼和文檔讀者能掌握一套完整的農(nóng)場供銷業(yè)務(wù)閉環(huán)與前后端交互實現(xiàn)為課程設(shè)計或畢業(yè)設(shè)計提供可直接改造的參考。1. 農(nóng)場供銷一體化這套源碼核心是 JSP SSM 的分層協(xié)作“農(nóng)場供銷一體化系統(tǒng)”這個名字聽著像期末課設(shè)拆開看就是一套標準的 java SSM JSP 后臺項目Spring 管業(yè)務(wù) BeanSpringMVC 接 HTTP 請求MyBatis 讀寫 MySQL頁面用 JSP 渲染。它要解決的業(yè)務(wù)不算大但很完整——農(nóng)資采購入庫、農(nóng)產(chǎn)品銷售出庫、庫存臺賬、結(jié)算對賬四個環(huán)節(jié)在一個系統(tǒng)里閉環(huán)。這套源碼最值得看的不是頁面做得多精致而是三層架構(gòu)怎么把供銷單據(jù)串成一條可對賬的數(shù)據(jù)流。它適合三類人拿 jsp 做畢設(shè)選題的學(xué)生想搞懂 SSM 三者怎么協(xié)作的 java 學(xué)習(xí)者以及要給農(nóng)場或合作社搭內(nèi)部管理系統(tǒng)的開發(fā)。源碼本身能跑是基礎(chǔ)真正有價值的是你能照著它的分層把供銷業(yè)務(wù)的前因后果講清楚然后把數(shù)據(jù)流改造成自己的。2. 先拆工程骨架SSM 與 JSP 在供銷系統(tǒng)里各管哪一段2.1 從 Maven 工程目錄看三層職責(zé)與 JSP 的落位拿到源碼先別急著點運行先把目錄掃一遍。這類項目通常是標準的 Maven 多模塊或單模塊結(jié)構(gòu)webapp 是 JSP 的家java 包下面按 controller、service、mapper、entity 分層。我一般會先看有沒有src/main/webapp/WEB-INF/jsp這個目錄有它說明視圖層走的是 JSP 轉(zhuǎn)發(fā)不是前后端分離。farm-supply-chain ├── pom.xml ├── src/main/java/com/farm │ ├── controller # SpringMVC 的 C接收請求、校驗參數(shù)、決定跳哪個 JSP │ │ ├── LoginController.java │ │ ├── GoodsController.java │ │ └── SalesController.java │ ├── service # 業(yè)務(wù)層采購、銷售、庫存扣減的事務(wù)在這里 │ │ ├── GoodsService.java │ │ └── SalesService.java │ ├── mapper # MyBatis 的接口層只管 SQL 映射 │ │ ├── GoodsMapper.java │ │ └── SalesMapper.java │ ├── entity # 與數(shù)據(jù)庫表一一對應(yīng)的 POJO │ │ ├── Goods.java │ │ └── SalesOrder.java │ └── common # 分頁封裝、統(tǒng)一返回結(jié)果、異常類 └── src/main/resources ├── jdbc.properties ├── spring-context.xml # Spring 容器數(shù)據(jù)源、事務(wù)、Mapper 掃描 ├── spring-mvc.xml # SpringMVC視圖解析、Controller 掃描 └── mapper/GoodsMapper.xml # SQL 語句集中地 src/main/webapp ├── WEB-INF │ ├── web.xml # Servlet 容器入口版本號決定 EL 是否默認開 │ └── jsp │ ├── login.jsp │ └── goods/list.jsp這個結(jié)構(gòu)在 java 課程設(shè)計和畢設(shè)里出現(xiàn)頻率極高面試問 SSM 項目也喜歡從這棵樹開始讓你講。業(yè)務(wù)上controller 不寫 SQLmapper 不寫 if 判斷service 才是供銷規(guī)則的執(zhí)行者。判斷一個 SSM 項目寫得好不好先看 service 層是不是足夠厚。2.2 把一張銷售單變成一次事務(wù)Controller、Service、Mapper 怎么接力以“前臺提交一張銷售訂單”為例完整鏈路是 JSP 表單 POST 到 ControllerController 收參數(shù)后調(diào)用 ServiceService 先扣庫存再插單據(jù)最后返回視圖讓 JSP 展示結(jié)果。這里最容易寫錯的是把庫存扣減寫在 Controller 里然后事務(wù)注解失效。Controller RequestMapping(/sales) public class SalesController { Resource private SalesService salesService; RequestMapping(/create) public String create(SalesOrder order, Integer goodsId, Integer quantity, Model model) { try { salesService.createOrder(order, goodsId, quantity); model.addAttribute(msg, 下單成功); } catch (BizException e) { model.addAttribute(msg, e.getMessage()); } return sales/result; } }Controller 里只做了三件事接收表單參數(shù)、調(diào)用 service、把結(jié)果消息放進 Model 供 JSP 讀取。注意Integer goodsId和Integer quantity是 JSP 表單里 input 的 name 值SpringMVC 會自動綁定不用手動 request.getParameter。這樣寫的意義是 Controller 變薄出錯時你能快速定位是參數(shù)問題還是業(yè)務(wù)問題。再往下看 Service。供銷系統(tǒng)的核心邏輯都壓在 service 層尤其是庫存扣減和訂單生成的原子性。Service public class SalesServiceImpl implements SalesService { Resource private GoodsMapper goodsMapper; Resource private SalesMapper salesMapper; Transactional(rollbackFor Exception.class) public void createOrder(SalesOrder order, Integer goodsId, Integer quantity) { int rows goodsMapper.deductStock(goodsId, quantity); if (rows 0) { throw new BizException(庫存不足); } order.setTotalAmount(order.getPrice().multiply(new BigDecimal(quantity))); salesMapper.insertOrder(order); SalesItem item new SalesItem(); item.setOrderId(order.getId()); item.setGoodsId(goodsId); item.setQuantity(quantity); item.setAmount(order.getPrice().multiply(new BigDecimal(quantity))); salesMapper.insertItem(item); } }這段代碼解釋了“供銷一體化”里庫存和訂單為什么必須在一件事里完成。Transactional(rollbackFor Exception.class)表示任何異常都要回滾包括受檢異常deductStock返回 0 表示庫存扣減失敗直接拋異常后面的 insert 就不會執(zhí)行。如果這里沒用事務(wù)會出現(xiàn)庫存扣了但訂單沒生成的黑匣子賬目。2.3 依賴清單與版本邊界這套組合的默認安全區(qū)SSM 的版本搭配在 java 面試題里幾乎是個固定考點實際跑項目時選錯版本比寫錯代碼更致命。常見做法是 JDK 8 Spring 5.2.x MyBatis 3.5.x MyBatis-Spring 2.0.xTomcat 用 8.5 或 9。這套組合經(jīng)過大量項目驗證是源碼能直接跑起來的最大公約數(shù)。dependencies dependency groupIdorg.springframework/groupId artifactIdspring-webmvc/artifactId version5.2.22.RELEASE/version /dependency dependency groupIdorg.mybatis/groupId artifactIdmybatis/artifactId version3.5.10/version /dependency dependency groupIdorg.mybatis/groupId artifactIdmybatis-spring/artifactId version2.0.6/version /dependency dependency groupIdmysql/groupId artifactIdmysql-connector-java/artifactId version8.0.33/version scoperuntime/scope /dependency dependency groupIdjavax.servlet/groupId artifactIdjstl/artifactId version1.2/version /dependency dependency groupIdjavax.servlet/groupId artifactIdjavax.servlet-api/artifactId version3.1.0/version scopeprovided/scope /dependency /dependencies注意兩個細節(jié)mysql 驅(qū)動的 scope 是 runtime編譯期用不到運行時由 Tomcat 加載servlet-api 必須 provided否則和 Tomcat 自帶的沖突啟動直接報 NoSuchMethodError。如果你本機是 MySQL 5.7驅(qū)動版本可以降到 5.1.49但更省事的做法是庫和驅(qū)動都統(tǒng)一到 8.0url 里加時區(qū)參數(shù)即可。3. 數(shù)據(jù)庫建模與供銷閉環(huán)庫存、訂單、結(jié)算怎么串成一條線3.1 供銷核心表概覽把業(yè)務(wù)拆成可對賬的關(guān)系農(nóng)場供銷系統(tǒng)的復(fù)雜度不在技術(shù)在表結(jié)構(gòu)設(shè)計。設(shè)計目標是讓“采購進來多少、賣出去多少、還剩多少”三件事能互相印證。下面是核心表的分工字段以精簡夠用為準。表名職責(zé)關(guān)鍵字段與供銷的關(guān)系goods商品檔案goods_name、category、unit、price、status供銷的對象上下架狀態(tài)supplier供應(yīng)商name、contact、phone采購來源warehouse_stock庫存臺賬goods_id、quantity采購加、銷售減實時余額purchase_order采購單order_no、supplier_id、total_amount、status入庫依據(jù)purchase_item采購明細order_id、goods_id、price、quantity每筆采購的具體商品sales_order銷售單order_no、customer、total_amount、status出庫依據(jù)sales_item銷售明細order_id、goods_id、quantity、amount每筆銷貨的具體商品settlement結(jié)算對賬order_no、order_type、amount、status采購與銷售統(tǒng)一記賬這個拆分思路是“主表 明細表”模式采購單和銷售單都需要流水號明細表記錄商品級數(shù)據(jù)。庫存表是中間的賬本采購單審核通過給庫存加銷售單創(chuàng)建成功給庫存減結(jié)算表再做金額層核對。三層對上了供銷才不會出現(xiàn)賬實不符。3.2 建表 SQL明細表為什么要冗余商品名稱和單價看建表語句能判斷作者有沒有實戰(zhàn)經(jīng)驗。一個典型的 sales_item 表會把 goods_name 和 price 冗余進來而不是查詢時再去 join goods 表。原因是 JSP 列表頁經(jīng)常要展示歷史單據(jù)單據(jù)一旦生成商品改名、調(diào)價都不該影響它。CREATE TABLE goods ( id INT PRIMARY KEY AUTO_INCREMENT, goods_name VARCHAR(64) NOT NULL, category VARCHAR(32) NOT NULL DEFAULT 蔬菜, unit VARCHAR(8) NOT NULL DEFAULT kg, price DECIMAL(10,2) NOT NULL, status TINYINT NOT NULL DEFAULT 1 COMMENT 1上架 0下架, created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; CREATE TABLE warehouse_stock ( goods_id INT PRIMARY KEY, quantity INT NOT NULL DEFAULT 0, updated_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP, CONSTRAINT fk_stock_goods FOREIGN KEY (goods_id) REFERENCES goods(id) ); CREATE TABLE sales_order ( id INT PRIMARY KEY AUTO_INCREMENT, order_no VARCHAR(32) NOT NULL UNIQUE, customer VARCHAR(64) NOT NULL, total_amount DECIMAL(10,2) NOT NULL, status TINYINT NOT NULL DEFAULT 0 COMMENT 0待結(jié)算 1已結(jié)算 2已取消, created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ); CREATE TABLE sales_item ( id INT PRIMARY KEY AUTO_INCREMENT, order_id INT NOT NULL, goods_id INT NOT NULL, goods_name VARCHAR(64) NOT NULL, price DECIMAL(10,2) NOT NULL, quantity INT NOT NULL, amount DECIMAL(10,2) NOT NULL, KEY idx_order (order_id), CONSTRAINT fk_item_order FOREIGN KEY (order_id) REFERENCES sales_order(id) );這里三個設(shè)計點值得抄金額字段統(tǒng)一用 DECIMAL禁止 float 和 double否則結(jié)算對賬會因精度翻車sales_item 冗余 goods_name 和 price讓 JSP 展示訂單詳情時少兩張表 joinwarehouse_stock 以 goods_id 為主鍵天然保證一個商品只有一行庫存記錄并發(fā)扣減時好鎖。3.3 扣庫存不靠先查再減一條 UPDATE 的樂觀鎖語義很多人第一次寫庫存扣減是先 SELECT 查 quantity判斷夠不夠再 UPDATE。這套寫法在單用戶調(diào)試時看不出來一旦兩個人同時下單就超賣。正確做法是把判斷寫在 UPDATE 的 WHERE 條件里讓數(shù)據(jù)庫替你做原子校驗。UPDATE warehouse_stock SET quantity quantity - #{quantity} WHERE goods_id #{goodsId} AND quantity #{quantity}MyBatis 中這條 SQL 的返回值就是 affected rows。如果庫存夠返回 1不夠返回 0Service 層拿到 0 直接拋業(yè)務(wù)異常。它不依賴應(yīng)用鎖也不需要先 SELECT性能和對錯兩頭都占。采購入庫同理改成quantity quantity #{quantity}但要考慮并發(fā)下同一商品多筆采購單同時入庫用追加而不是賦值覆蓋。3.4 初始化數(shù)據(jù)別讓外鍵和狀態(tài)字段卡住第一次啟動源碼的說明文檔一般會附 SQL 腳本但常見坑是只建表不給初始化數(shù)據(jù)。跑供銷系統(tǒng)至少需要一條管理員賬號、兩類商品、一行初始庫存否則登錄進去全是空列表你根本分不清是功能沒實現(xiàn)還是數(shù)據(jù)沒喂進去。INSERT INTO goods (id, goods_name, category, unit, price, status) VALUES (1, 有機西紅柿, 蔬菜, kg, 5.50, 1), (2, 農(nóng)資復(fù)合肥, 農(nóng)資, 袋, 120.00, 1); INSERT INTO warehouse_stock (goods_id, quantity) VALUES (1, 200), (2, 50); INSERT INTO sys_user (id, username, password, real_name) VALUES (1, admin, MD5(123456), 系統(tǒng)管理員);注意密碼別用明文MD5 是這套老項目的常見做法雖然不夠強但至少不會一眼泄露。status 字段的取值要在代碼里統(tǒng)一商品 1 上架 0 下架訂單 0 待結(jié)算 1 已結(jié)算 2 已取消。JSP 頁面上顯示中文狀態(tài)時通常在 controller 里做映射不要在頁面寫死。4. 跑通源碼的關(guān)鍵配置Idea 導(dǎo)入、Spring 整合、JSP 聯(lián)調(diào)4.1 兩種導(dǎo)入方式直接開 Maven 工程還是手動建 JSP 項目拿到源碼后第一件事不是改代碼是把工程正確導(dǎo)入 Idea。這里因人而異如果堅持用“idea 新建 jsp 項目”的傳統(tǒng)方式需要手動把 web 目錄指到 src/main/webapp再配置 Artifacts更省事的是直接用 Maven 方式打開。常見做法是 Idea 里 File - Open選擇項目下的 pom.xml以 Maven 項目導(dǎo)入。等待依賴下載完成后檢查右側(cè) Maven 窗口有沒有出現(xiàn) spring、mybatis 相關(guān)依賴然后配置 TomcatRun - Edit Configurations - 新建 Tomcat Server LocalDeployment 里添加 Artifact。這里有個區(qū)分如果它顯示 war exploded說明是開發(fā)模式改 JSP 可以熱更新如果是 war 包每次都要重新構(gòu)建適合最終部署。提示老項目常見的問題是本地 Maven 倉庫沒有對應(yīng)版本依賴idea 會一直卡在下載。把 Maven 的 settings.xml 里的鏡像倉庫配好再重新 import 一次基本能解決。4.2 jdbc.properties 與 spring-context.xml數(shù)據(jù)源、事務(wù)、Mapper 掃描三件事數(shù)據(jù)庫連不上是啟動失敗的頭號原因而大部分是因為驅(qū)動類名和時區(qū)參數(shù)。記住 MySQL 8 用com.mysql.cj.jdbc.DriverMySQL 5 用com.mysql.jdbc.Driverurl 里必須加serverTimezoneAsia/Shanghai否則報時區(qū)錯誤。jdbc.drivercom.mysql.cj.jdbc.Driver jdbc.urljdbc:mysql://localhost:3306/farm?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/Shanghai jdbc.usernameroot jdbc.password你的密碼Spring 配置文件里要做的三件事數(shù)據(jù)源、SqlSessionFactory、事務(wù)管理器。順序不能亂事務(wù)管理器依賴數(shù)據(jù)源SqlSessionFactory 依賴 mapperLocations 指向 XML。context:property-placeholder locationclasspath:jdbc.properties/ bean iddataSource classorg.springframework.jdbc.datasource.DriverManagerDataSource property namedriverClassName value${jdbc.driver}/ property nameurl value${jdbc.url}/ property nameusername value${jdbc.username}/ property namepassword value${jdbc.password}/ /bean bean idsqlSessionFactory classorg.mybatis.spring.SqlSessionFactoryBean property namedataSource refdataSource/ property namemapperLocations valueclasspath:mapper/*.xml/ /bean bean classorg.mybatis.spring.mapper.MapperScannerConfigurer property namebasePackage valuecom.farm.mapper/ /bean bean idtransactionManager classorg.springframework.jdbc.datasource.DataSourceTransactionManager property namedataSource refdataSource/ /bean tx:annotation-driven transaction-managertransactionManager/這里的classpath:mapper/*.xml是高頻出錯點如果你的 Mapper XML 放在 resources 之外的目錄或者路徑寫成了classpath*:MyBatis 就找不到 SQL運行時直接報 Invalid bound statement。MapperScannerConfigurer 的 basePackage 是接口所在包它會把包下所有接口自動代理成 Mapper Bean。4.3 spring-mvc.xml視圖解析器決定 JSP 跳到哪里SpringMVC 與 JSP 協(xié)作的關(guān)鍵是 InternalResourceViewResolver。它負責(zé)把 Controller 返回的字符串視圖名解析成真正可訪問的 JSP 路徑。如果這個前綴后綴配置不對任何請求都會 404。mvc:annotation-driven/ context:component-scan base-packagecom.farm.controller/ bean classorg.springframework.web.servlet.view.InternalResourceViewResolver property nameprefix value/WEB-INF/jsp// property namesuffix value.jsp/ /bean mvc:resources mapping/static/** location/static// mvc:resources mapping/upload/** location/upload///WEB-INF/jsp/前綴的含義是把 JSP 藏在 WEB-INF 下外部瀏覽器直接輸入 URL 訪問不到必須經(jīng) Controller 轉(zhuǎn)發(fā)。這是 SSM 項目的標準安全姿勢也能避免 JSP 源碼直接暴露。靜態(tài)資源單獨配置是防止 DispatcherServlet 把 css/js 也當(dāng) controller 請求處理不加這段頁面會全部裸奔。4.4 web.xmlservlet 版本與編碼過濾器不能省web.xml 是第一道關(guān)卡版本聲明直接關(guān)系到 JSP 的 EL 表達式是否默認開啟。如果你的 web.xml 是 2.3 或 2.4 的老版本JSP 頁面里的${goods.name}會被原樣輸出原因就是 EL 功能默認關(guān)閉或部分支持。用 Servlet 3.1 版本聲明可以從根上避開這個坑。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_3_1.xsd version3.1 filter filter-nameencoding/filter-name filter-classorg.springframework.web.filter.CharacterEncodingFilter/filter-class init-param param-nameencoding/param-name param-valueUTF-8/param-value /init-param /filter filter-mapping filter-nameencoding/filter-name url-pattern/*/url-pattern /filter-mapping 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-mapping /web-appCharacterEncodingFilter 必須放在所有過濾器最前面且 url-pattern 寫/*否則 JSP 提交的中文表單數(shù)據(jù)到后端就是亂碼。DispatcherServlet 的 url-pattern 用/表示除了.jsp之外的所有請求都進 SpringMVC.jsp請求由 Tomcat 的 Jasper 解析這樣 JSP 頁面本身不走 Controller 也能被訪問到。4.5 跑通一次完整供銷鏈路從登錄到庫存變化配置無誤后啟動 Tomcat瀏覽器訪問http://localhost:8080/farm/正常會跳登錄頁。用 admin 登錄之后按采購入庫、銷售出庫、庫存查詢的順序走一遍驗證標準是倉庫里商品數(shù)量先增加后減少結(jié)算頁面的金額與訂單明細一致。我一般會準備一張草稿紙把初始庫存數(shù)寫下來每做一筆就核對一次頁面數(shù)字。如果下單后庫存沒變優(yōu)先懷疑事務(wù)沒生效或者 Mapper XML 的 update 語句寫成了 insert。這一步跑通比看十頁文檔都管用因為它一次性驗證了 Spring 容器、MyBatis 映射、JSP 視圖解析三條鏈路。5. 排查與避坑JSP 項目跑不起來時先查這五個地方5.1 頁面把${goods.name}原樣打印出來現(xiàn)象JSP 頁面沒有報錯但 EL 表達式?jīng)]有被解析頁面上直接顯示${goods.name}這類原文。原因絕大多數(shù)是 web.xml 的 servlet 版本聲明太低。Servlet 2.3 及以下默認 isELIgnored 為 true2.4 之后才默認支持 EL 解析。如果 web.xml 頭聲明的是 2.3 版本或者壓根沒有版本聲明被容器當(dāng)成老版本處理就會出現(xiàn)整頁表達式裸奔。解決把 web.xml 的 version 改成 3.0 或 3.1schema 換成xmlns.jcp.org的 javaee 版本。改完記得 RebuildMaven 項目里 WEB-INF/web.xml 是資源文件不重新構(gòu)建可能還在用舊的。5.2 數(shù)據(jù)庫連接報 Communications link failure現(xiàn)象Tomcat 啟動時 Spring 初始化數(shù)據(jù)源失敗控制臺出現(xiàn)Communications link failure或Access denied for user。原因驅(qū)動類名不匹配。MySQL 8 的驅(qū)動類已經(jīng)改成com.mysql.cj.jdbc.Driver連接串少了serverTimezoneAsia/Shanghai也會直接失敗。如果 pom 里引入的 mysql-connector-java 是 5.x而數(shù)據(jù)庫是 8.x協(xié)議層就不兼容怎么配都連不上。解決先把數(shù)據(jù)庫版本確認清楚再統(tǒng)一驅(qū)動。MySQL 8 配mysql-connector-java 8.0.x和com.mysql.cj.jdbc.Driver并在 url 后面拼?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/Shanghai。這個坑最常見于本地裝的是 8.0但網(wǎng)上搜到的老教程都是 5.x 寫法。5.3 MyBatis 報 Invalid bound statement (not found)現(xiàn)象項目能啟動Controller 也能進但一調(diào)用 Mapper 接口的方法就拋Invalid bound statement (not found): com.farm.mapper.GoodsMapper.getGoodsById。原因Mapper 接口和 XML 沒有綁定成功。常見三種情況XML 文件的 namespace 和接口全限定名不一致XML 沒被mapperLocations掃到比如放在了src/main/java下面而不是 resources接口方法名與 XML 里的 statement id 對不上。解決先檢查 namespace 是否等于接口的全路徑例如com.farm.mapper.GoodsMapper再確認 spring-context.xml 里mapperLocations路徑是classpath:mapper/*.xml最后看方法名和 id 是否一字不差。改完 spring 配置必須重啟Mapper 綁定是在容器啟動時完成的熱部署救不了。5.4 修改 JSP 后不生效運行的還是舊頁面現(xiàn)象改了 JSP 的標題或表格列刷新瀏覽器沒有任何變化甚至重啟 Tomcat 還是老頁面。原因JSP 是動態(tài)編譯的Tomcat 的 work 目錄緩存了上一次編譯的 Java 文件和 class 文件。開發(fā)模式下 idea 沒有把 resources 更新到 target或者瀏覽器強緩存了 .jsp 響應(yīng)。另一個隱蔽原因是代碼里對 JSP 響應(yīng)設(shè)置了Cache-Control頭導(dǎo)致瀏覽器端走了本地緩存。解決Idea 里 Build - Rebuild Project把 target 目錄清理重建Tomcat 的 deployment 選 war exploded 并打開 On frame deactivation 的 Update classes and resources瀏覽器按 CtrlF5 強制刷新。如果還不行手動刪掉 Tomcat 的work/Catalina目錄再啟動。5.5 Nginx 代理后頁面能開但接口全部 404現(xiàn)象直接訪問 Tomcat 端口一切正常接入 Nginx 做反向代理后JSP 頁面能打開但表單提交和列表查詢的路徑全 404。原因JSP 本身由 Tomcat 渲染Nginx 只是透傳所以頁面能出來。404 的通常是/sales/xxx這類 Controller 路徑大方向是請求沒轉(zhuǎn)發(fā)到 Tomcat 的上下文路徑。例如 Tomcat 應(yīng)用上下文是/farm而 Nginx 轉(zhuǎn)發(fā)時把/farm剝掉了SpringMVC 收到的請求路徑就對不上RequestMapping。解決Nginx 配置里轉(zhuǎn)發(fā)時保留原始 URI不要用 rewrite 去掉前綴。另外要明確一件事nginx 本身不支持 JSP 解析所有.jsp頁面和/api請求最終都要落到 TomcatNginx 只負責(zé)反向代理和靜態(tài)資源分發(fā)。建議把/static/、/upload/這類路徑直接用 Nginx 指向磁盤其余全部proxy_pass到 Tomcat 的 8080。6. 不推翻 JSP 的改造技巧先補接口回歸、緩存和一張對賬 SQL把 SSM JSP 這套跑通后很多人會糾結(jié)要不要推到重來換 Spring Boot。我建議先別急老系統(tǒng)最缺的不是框架是驗證手段。我接手這類供銷系統(tǒng)時第一件事不是重構(gòu)而是先給 Service 層補上單元測試再用一個 JSON 接口做聯(lián)調(diào)最后寫對賬 SQL 守住錢賬一致。先給核心 Service 寫測試。SSM 項目用 Spring Test 直接注入不啟動 Tomcat 也能驗證庫存扣減邏輯這比在頁面上點點點高效得多。RunWith(SpringJUnit4ClassRunner.class) ContextConfiguration(locations {classpath:spring-context.xml}) public class SalesServiceTest { Resource private SalesService salesService; Test public void testCreateOrderSuccess() { SalesOrder order new SalesOrder(); order.setOrderNo(SO20250101001); order.setCustomer(測試客戶); salesService.createOrder(order, 1, 10); // 斷言庫存從 200 變?yōu)?190 } }然后加一個 JSON 接口不破壞 JSP 頁面但給后續(xù)聯(lián)調(diào)留后門。在 Controller 里用ResponseBody返回商品列表 JSON前端可以用 Postman 直接測不必每次打開瀏覽器。RequestMapping(/api/goods/list) ResponseBody public MapString, Object listGoodsApi() { ListGoods list goodsService.listAll(); MapString, Object result new HashMap(); result.put(code, 0); result.put(data, list); return result; }接口驗證穩(wěn)定后再考慮緩存。JSP 頁面訪問量上來時商品列表和分類是熱點數(shù)據(jù)但注意別緩存庫存數(shù)字緩存只放商品基礎(chǔ)信息庫存仍實時查庫。這段改造是可選的重點是讓系統(tǒng)先有可回歸的測試和可對賬的 SQL。最后是守住賬目的對賬 SQL。跑完十筆訂單后用一條語句核對銷售明細金額之和與銷售單總額是否一致再查庫存為負數(shù)的商品這兩條檢查能讓供銷系統(tǒng)的數(shù)據(jù)問題在半小時內(nèi)暴露。-- 核對銷售單總額與明細是否一致 SELECT order_id, SUM(amount) AS item_total FROM sales_item GROUP BY order_id HAVING item_total (SELECT total_amount FROM sales_order WHERE id order_id); -- 找出庫存為負數(shù)的商品 SELECT goods_id, quantity FROM warehouse_stock WHERE quantity 0;老系統(tǒng)的價值不在技術(shù)新穎而在于業(yè)務(wù)閉環(huán)完整可驗證。我現(xiàn)在的習(xí)慣是不管接手什么 JSP 老項目先把對賬 SQL 和接口測試補上再談重構(gòu)。希望幫到你。本文還有配套的精品資源點擊獲取 JSP+SSM農(nóng)場供銷系統(tǒng)源碼拆解：架構(gòu)、事務(wù)與部署實戰(zhàn)
簡介一套面向農(nóng)場管理人員和Java初學(xué)者的xx農(nóng)場供銷一體化系統(tǒng)源碼及說明文檔代碼基于SSMSpringSpringMVCMyBatis與JSP技術(shù)棧結(jié)合MySQL數(shù)據(jù)庫與Maven構(gòu)建工具實現(xiàn)農(nóng)產(chǎn)品信息管理、分類管理、在線訂購、會員管理及配送等核心功能。系統(tǒng)按角色分為管理員端與會員端管理員可維護商品與分類、處理訂購和會員數(shù)據(jù)會員則能瀏覽農(nóng)產(chǎn)品并提交訂購需求。壓縮包約23.55MB內(nèi)部源碼與說明文檔可配合IDEA或Eclipse進行部署數(shù)據(jù)庫工具可使用Navicat或SQLyog。資源已吸引104人學(xué)習(xí)適合用來理解SSM各層整合、JSP動態(tài)頁面開發(fā)、數(shù)據(jù)庫表結(jié)構(gòu)設(shè)計以及Maven項目管理流程。通過閱讀源碼和文檔讀者能掌握一套完整的農(nóng)場供銷業(yè)務(wù)閉環(huán)與前后端交互實現(xiàn)為課程設(shè)計或畢業(yè)設(shè)計提供可直接改造的參考。1. 農(nóng)場供銷一體化這套源碼核心是 JSP SSM 的分層協(xié)作“農(nóng)場供銷一體化系統(tǒng)”這個名字聽著像期末課設(shè)拆開看就是一套標準的 java SSM JSP 后臺項目Spring 管業(yè)務(wù) BeanSpringMVC 接 HTTP 請求MyBatis 讀寫 MySQL頁面用 JSP 渲染。它要解決的業(yè)務(wù)不算大但很完整——農(nóng)資采購入庫、農(nóng)產(chǎn)品銷售出庫、庫存臺賬、結(jié)算對賬四個環(huán)節(jié)在一個系統(tǒng)里閉環(huán)。這套源碼最值得看的不是頁面做得多精致而是三層架構(gòu)怎么把供銷單據(jù)串成一條可對賬的數(shù)據(jù)流。它適合三類人拿 jsp 做畢設(shè)選題的學(xué)生想搞懂 SSM 三者怎么協(xié)作的 java 學(xué)習(xí)者以及要給農(nóng)場或合作社搭內(nèi)部管理系統(tǒng)的開發(fā)。源碼本身能跑是基礎(chǔ)真正有價值的是你能照著它的分層把供銷業(yè)務(wù)的前因后果講清楚然后把數(shù)據(jù)流改造成自己的。2. 先拆工程骨架SSM 與 JSP 在供銷系統(tǒng)里各管哪一段2.1 從 Maven 工程目錄看三層職責(zé)與 JSP 的落位拿到源碼先別急著點運行先把目錄掃一遍。這類項目通常是標準的 Maven 多模塊或單模塊結(jié)構(gòu)webapp 是 JSP 的家java 包下面按 controller、service、mapper、entity 分層。我一般會先看有沒有src/main/webapp/WEB-INF/jsp這個目錄有它說明視圖層走的是 JSP 轉(zhuǎn)發(fā)不是前后端分離。farm-supply-chain ├── pom.xml ├── src/main/java/com/farm │ ├── controller # SpringMVC 的 C接收請求、校驗參數(shù)、決定跳哪個 JSP │ │ ├── LoginController.java │ │ ├── GoodsController.java │ │ └── SalesController.java │ ├── service # 業(yè)務(wù)層采購、銷售、庫存扣減的事務(wù)在這里 │ │ ├── GoodsService.java │ │ └── SalesService.java │ ├── mapper # MyBatis 的接口層只管 SQL 映射 │ │ ├── GoodsMapper.java │ │ └── SalesMapper.java │ ├── entity # 與數(shù)據(jù)庫表一一對應(yīng)的 POJO │ │ ├── Goods.java │ │ └── SalesOrder.java │ └── common # 分頁封裝、統(tǒng)一返回結(jié)果、異常類 └── src/main/resources ├── jdbc.properties ├── spring-context.xml # Spring 容器數(shù)據(jù)源、事務(wù)、Mapper 掃描 ├── spring-mvc.xml # SpringMVC視圖解析、Controller 掃描 └── mapper/GoodsMapper.xml # SQL 語句集中地 src/main/webapp ├── WEB-INF │ ├── web.xml # Servlet 容器入口版本號決定 EL 是否默認開 │ └── jsp │ ├── login.jsp │ └── goods/list.jsp這個結(jié)構(gòu)在 java 課程設(shè)計和畢設(shè)里出現(xiàn)頻率極高面試問 SSM 項目也喜歡從這棵樹開始讓你講。業(yè)務(wù)上controller 不寫 SQLmapper 不寫 if 判斷service 才是供銷規(guī)則的執(zhí)行者。判斷一個 SSM 項目寫得好不好先看 service 層是不是足夠厚。2.2 把一張銷售單變成一次事務(wù)Controller、Service、Mapper 怎么接力以“前臺提交一張銷售訂單”為例完整鏈路是 JSP 表單 POST 到 ControllerController 收參數(shù)后調(diào)用 ServiceService 先扣庫存再插單據(jù)最后返回視圖讓 JSP 展示結(jié)果。這里最容易寫錯的是把庫存扣減寫在 Controller 里然后事務(wù)注解失效。Controller RequestMapping(/sales) public class SalesController { Resource private SalesService salesService; RequestMapping(/create) public String create(SalesOrder order, Integer goodsId, Integer quantity, Model model) { try { salesService.createOrder(order, goodsId, quantity); model.addAttribute(msg, 下單成功); } catch (BizException e) { model.addAttribute(msg, e.getMessage()); } return sales/result; } }Controller 里只做了三件事接收表單參數(shù)、調(diào)用 service、把結(jié)果消息放進 Model 供 JSP 讀取。注意Integer goodsId和Integer quantity是 JSP 表單里 input 的 name 值SpringMVC 會自動綁定不用手動 request.getParameter。這樣寫的意義是 Controller 變薄出錯時你能快速定位是參數(shù)問題還是業(yè)務(wù)問題。再往下看 Service。供銷系統(tǒng)的核心邏輯都壓在 service 層尤其是庫存扣減和訂單生成的原子性。Service public class SalesServiceImpl implements SalesService { Resource private GoodsMapper goodsMapper; Resource private SalesMapper salesMapper; Transactional(rollbackFor Exception.class) public void createOrder(SalesOrder order, Integer goodsId, Integer quantity) { int rows goodsMapper.deductStock(goodsId, quantity); if (rows 0) { throw new BizException(庫存不足); } order.setTotalAmount(order.getPrice().multiply(new BigDecimal(quantity))); salesMapper.insertOrder(order); SalesItem item new SalesItem(); item.setOrderId(order.getId()); item.setGoodsId(goodsId); item.setQuantity(quantity); item.setAmount(order.getPrice().multiply(new BigDecimal(quantity))); salesMapper.insertItem(item); } }這段代碼解釋了“供銷一體化”里庫存和訂單為什么必須在一件事里完成。Transactional(rollbackFor Exception.class)表示任何異常都要回滾包括受檢異常deductStock返回 0 表示庫存扣減失敗直接拋異常后面的 insert 就不會執(zhí)行。如果這里沒用事務(wù)會出現(xiàn)庫存扣了但訂單沒生成的黑匣子賬目。2.3 依賴清單與版本邊界這套組合的默認安全區(qū)SSM 的版本搭配在 java 面試題里幾乎是個固定考點實際跑項目時選錯版本比寫錯代碼更致命。常見做法是 JDK 8 Spring 5.2.x MyBatis 3.5.x MyBatis-Spring 2.0.xTomcat 用 8.5 或 9。這套組合經(jīng)過大量項目驗證是源碼能直接跑起來的最大公約數(shù)。dependencies dependency groupIdorg.springframework/groupId artifactIdspring-webmvc/artifactId version5.2.22.RELEASE/version /dependency dependency groupIdorg.mybatis/groupId artifactIdmybatis/artifactId version3.5.10/version /dependency dependency groupIdorg.mybatis/groupId artifactIdmybatis-spring/artifactId version2.0.6/version /dependency dependency groupIdmysql/groupId artifactIdmysql-connector-java/artifactId version8.0.33/version scoperuntime/scope /dependency dependency groupIdjavax.servlet/groupId artifactIdjstl/artifactId version1.2/version /dependency dependency groupIdjavax.servlet/groupId artifactIdjavax.servlet-api/artifactId version3.1.0/version scopeprovided/scope /dependency /dependencies注意兩個細節(jié)mysql 驅(qū)動的 scope 是 runtime編譯期用不到運行時由 Tomcat 加載servlet-api 必須 provided否則和 Tomcat 自帶的沖突啟動直接報 NoSuchMethodError。如果你本機是 MySQL 5.7驅(qū)動版本可以降到 5.1.49但更省事的做法是庫和驅(qū)動都統(tǒng)一到 8.0url 里加時區(qū)參數(shù)即可。3. 數(shù)據(jù)庫建模與供銷閉環(huán)庫存、訂單、結(jié)算怎么串成一條線3.1 供銷核心表概覽把業(yè)務(wù)拆成可對賬的關(guān)系農(nóng)場供銷系統(tǒng)的復(fù)雜度不在技術(shù)在表結(jié)構(gòu)設(shè)計。設(shè)計目標是讓“采購進來多少、賣出去多少、還剩多少”三件事能互相印證。下面是核心表的分工字段以精簡夠用為準。表名職責(zé)關(guān)鍵字段與供銷的關(guān)系goods商品檔案goods_name、category、unit、price、status供銷的對象上下架狀態(tài)supplier供應(yīng)商name、contact、phone采購來源warehouse_stock庫存臺賬goods_id、quantity采購加、銷售減實時余額purchase_order采購單order_no、supplier_id、total_amount、status入庫依據(jù)purchase_item采購明細order_id、goods_id、price、quantity每筆采購的具體商品sales_order銷售單order_no、customer、total_amount、status出庫依據(jù)sales_item銷售明細order_id、goods_id、quantity、amount每筆銷貨的具體商品settlement結(jié)算對賬order_no、order_type、amount、status采購與銷售統(tǒng)一記賬這個拆分思路是“主表 明細表”模式采購單和銷售單都需要流水號明細表記錄商品級數(shù)據(jù)。庫存表是中間的賬本采購單審核通過給庫存加銷售單創(chuàng)建成功給庫存減結(jié)算表再做金額層核對。三層對上了供銷才不會出現(xiàn)賬實不符。3.2 建表 SQL明細表為什么要冗余商品名稱和單價看建表語句能判斷作者有沒有實戰(zhàn)經(jīng)驗。一個典型的 sales_item 表會把 goods_name 和 price 冗余進來而不是查詢時再去 join goods 表。原因是 JSP 列表頁經(jīng)常要展示歷史單據(jù)單據(jù)一旦生成商品改名、調(diào)價都不該影響它。CREATE TABLE goods ( id INT PRIMARY KEY AUTO_INCREMENT, goods_name VARCHAR(64) NOT NULL, category VARCHAR(32) NOT NULL DEFAULT 蔬菜, unit VARCHAR(8) NOT NULL DEFAULT kg, price DECIMAL(10,2) NOT NULL, status TINYINT NOT NULL DEFAULT 1 COMMENT 1上架 0下架, created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; CREATE TABLE warehouse_stock ( goods_id INT PRIMARY KEY, quantity INT NOT NULL DEFAULT 0, updated_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP, CONSTRAINT fk_stock_goods FOREIGN KEY (goods_id) REFERENCES goods(id) ); CREATE TABLE sales_order ( id INT PRIMARY KEY AUTO_INCREMENT, order_no VARCHAR(32) NOT NULL UNIQUE, customer VARCHAR(64) NOT NULL, total_amount DECIMAL(10,2) NOT NULL, status TINYINT NOT NULL DEFAULT 0 COMMENT 0待結(jié)算 1已結(jié)算 2已取消, created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ); CREATE TABLE sales_item ( id INT PRIMARY KEY AUTO_INCREMENT, order_id INT NOT NULL, goods_id INT NOT NULL, goods_name VARCHAR(64) NOT NULL, price DECIMAL(10,2) NOT NULL, quantity INT NOT NULL, amount DECIMAL(10,2) NOT NULL, KEY idx_order (order_id), CONSTRAINT fk_item_order FOREIGN KEY (order_id) REFERENCES sales_order(id) );這里三個設(shè)計點值得抄金額字段統(tǒng)一用 DECIMAL禁止 float 和 double否則結(jié)算對賬會因精度翻車sales_item 冗余 goods_name 和 price讓 JSP 展示訂單詳情時少兩張表 joinwarehouse_stock 以 goods_id 為主鍵天然保證一個商品只有一行庫存記錄并發(fā)扣減時好鎖。3.3 扣庫存不靠先查再減一條 UPDATE 的樂觀鎖語義很多人第一次寫庫存扣減是先 SELECT 查 quantity判斷夠不夠再 UPDATE。這套寫法在單用戶調(diào)試時看不出來一旦兩個人同時下單就超賣。正確做法是把判斷寫在 UPDATE 的 WHERE 條件里讓數(shù)據(jù)庫替你做原子校驗。UPDATE warehouse_stock SET quantity quantity - #{quantity} WHERE goods_id #{goodsId} AND quantity #{quantity}MyBatis 中這條 SQL 的返回值就是 affected rows。如果庫存夠返回 1不夠返回 0Service 層拿到 0 直接拋業(yè)務(wù)異常。它不依賴應(yīng)用鎖也不需要先 SELECT性能和對錯兩頭都占。采購入庫同理改成quantity quantity #{quantity}但要考慮并發(fā)下同一商品多筆采購單同時入庫用追加而不是賦值覆蓋。3.4 初始化數(shù)據(jù)別讓外鍵和狀態(tài)字段卡住第一次啟動源碼的說明文檔一般會附 SQL 腳本但常見坑是只建表不給初始化數(shù)據(jù)。跑供銷系統(tǒng)至少需要一條管理員賬號、兩類商品、一行初始庫存否則登錄進去全是空列表你根本分不清是功能沒實現(xiàn)還是數(shù)據(jù)沒喂進去。INSERT INTO goods (id, goods_name, category, unit, price, status) VALUES (1, 有機西紅柿, 蔬菜, kg, 5.50, 1), (2, 農(nóng)資復(fù)合肥, 農(nóng)資, 袋, 120.00, 1); INSERT INTO warehouse_stock (goods_id, quantity) VALUES (1, 200), (2, 50); INSERT INTO sys_user (id, username, password, real_name) VALUES (1, admin, MD5(123456), 系統(tǒng)管理員);注意密碼別用明文MD5 是這套老項目的常見做法雖然不夠強但至少不會一眼泄露。status 字段的取值要在代碼里統(tǒng)一商品 1 上架 0 下架訂單 0 待結(jié)算 1 已結(jié)算 2 已取消。JSP 頁面上顯示中文狀態(tài)時通常在 controller 里做映射不要在頁面寫死。4. 跑通源碼的關(guān)鍵配置Idea 導(dǎo)入、Spring 整合、JSP 聯(lián)調(diào)4.1 兩種導(dǎo)入方式直接開 Maven 工程還是手動建 JSP 項目拿到源碼后第一件事不是改代碼是把工程正確導(dǎo)入 Idea。這里因人而異如果堅持用“idea 新建 jsp 項目”的傳統(tǒng)方式需要手動把 web 目錄指到 src/main/webapp再配置 Artifacts更省事的是直接用 Maven 方式打開。常見做法是 Idea 里 File - Open選擇項目下的 pom.xml以 Maven 項目導(dǎo)入。等待依賴下載完成后檢查右側(cè) Maven 窗口有沒有出現(xiàn) spring、mybatis 相關(guān)依賴然后配置 TomcatRun - Edit Configurations - 新建 Tomcat Server LocalDeployment 里添加 Artifact。這里有個區(qū)分如果它顯示 war exploded說明是開發(fā)模式改 JSP 可以熱更新如果是 war 包每次都要重新構(gòu)建適合最終部署。提示老項目常見的問題是本地 Maven 倉庫沒有對應(yīng)版本依賴idea 會一直卡在下載。把 Maven 的 settings.xml 里的鏡像倉庫配好再重新 import 一次基本能解決。4.2 jdbc.properties 與 spring-context.xml數(shù)據(jù)源、事務(wù)、Mapper 掃描三件事數(shù)據(jù)庫連不上是啟動失敗的頭號原因而大部分是因為驅(qū)動類名和時區(qū)參數(shù)。記住 MySQL 8 用com.mysql.cj.jdbc.DriverMySQL 5 用com.mysql.jdbc.Driverurl 里必須加serverTimezoneAsia/Shanghai否則報時區(qū)錯誤。jdbc.drivercom.mysql.cj.jdbc.Driver jdbc.urljdbc:mysql://localhost:3306/farm?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/Shanghai jdbc.usernameroot jdbc.password你的密碼Spring 配置文件里要做的三件事數(shù)據(jù)源、SqlSessionFactory、事務(wù)管理器。順序不能亂事務(wù)管理器依賴數(shù)據(jù)源SqlSessionFactory 依賴 mapperLocations 指向 XML。context:property-placeholder locationclasspath:jdbc.properties/ bean iddataSource classorg.springframework.jdbc.datasource.DriverManagerDataSource property namedriverClassName value${jdbc.driver}/ property nameurl value${jdbc.url}/ property nameusername value${jdbc.username}/ property namepassword value${jdbc.password}/ /bean bean idsqlSessionFactory classorg.mybatis.spring.SqlSessionFactoryBean property namedataSource refdataSource/ property namemapperLocations valueclasspath:mapper/*.xml/ /bean bean classorg.mybatis.spring.mapper.MapperScannerConfigurer property namebasePackage valuecom.farm.mapper/ /bean bean idtransactionManager classorg.springframework.jdbc.datasource.DataSourceTransactionManager property namedataSource refdataSource/ /bean tx:annotation-driven transaction-managertransactionManager/這里的classpath:mapper/*.xml是高頻出錯點如果你的 Mapper XML 放在 resources 之外的目錄或者路徑寫成了classpath*:MyBatis 就找不到 SQL運行時直接報 Invalid bound statement。MapperScannerConfigurer 的 basePackage 是接口所在包它會把包下所有接口自動代理成 Mapper Bean。4.3 spring-mvc.xml視圖解析器決定 JSP 跳到哪里SpringMVC 與 JSP 協(xié)作的關(guān)鍵是 InternalResourceViewResolver。它負責(zé)把 Controller 返回的字符串視圖名解析成真正可訪問的 JSP 路徑。如果這個前綴后綴配置不對任何請求都會 404。mvc:annotation-driven/ context:component-scan base-packagecom.farm.controller/ bean classorg.springframework.web.servlet.view.InternalResourceViewResolver property nameprefix value/WEB-INF/jsp// property namesuffix value.jsp/ /bean mvc:resources mapping/static/** location/static// mvc:resources mapping/upload/** location/upload///WEB-INF/jsp/前綴的含義是把 JSP 藏在 WEB-INF 下外部瀏覽器直接輸入 URL 訪問不到必須經(jīng) Controller 轉(zhuǎn)發(fā)。這是 SSM 項目的標準安全姿勢也能避免 JSP 源碼直接暴露。靜態(tài)資源單獨配置是防止 DispatcherServlet 把 css/js 也當(dāng) controller 請求處理不加這段頁面會全部裸奔。4.4 web.xmlservlet 版本與編碼過濾器不能省web.xml 是第一道關(guān)卡版本聲明直接關(guān)系到 JSP 的 EL 表達式是否默認開啟。如果你的 web.xml 是 2.3 或 2.4 的老版本JSP 頁面里的${goods.name}會被原樣輸出原因就是 EL 功能默認關(guān)閉或部分支持。用 Servlet 3.1 版本聲明可以從根上避開這個坑。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_3_1.xsd version3.1 filter filter-nameencoding/filter-name filter-classorg.springframework.web.filter.CharacterEncodingFilter/filter-class init-param param-nameencoding/param-name param-valueUTF-8/param-value /init-param /filter filter-mapping filter-nameencoding/filter-name url-pattern/*/url-pattern /filter-mapping 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-mapping /web-appCharacterEncodingFilter 必須放在所有過濾器最前面且 url-pattern 寫/*否則 JSP 提交的中文表單數(shù)據(jù)到后端就是亂碼。DispatcherServlet 的 url-pattern 用/表示除了.jsp之外的所有請求都進 SpringMVC.jsp請求由 Tomcat 的 Jasper 解析這樣 JSP 頁面本身不走 Controller 也能被訪問到。4.5 跑通一次完整供銷鏈路從登錄到庫存變化配置無誤后啟動 Tomcat瀏覽器訪問http://localhost:8080/farm/正常會跳登錄頁。用 admin 登錄之后按采購入庫、銷售出庫、庫存查詢的順序走一遍驗證標準是倉庫里商品數(shù)量先增加后減少結(jié)算頁面的金額與訂單明細一致。我一般會準備一張草稿紙把初始庫存數(shù)寫下來每做一筆就核對一次頁面數(shù)字。如果下單后庫存沒變優(yōu)先懷疑事務(wù)沒生效或者 Mapper XML 的 update 語句寫成了 insert。這一步跑通比看十頁文檔都管用因為它一次性驗證了 Spring 容器、MyBatis 映射、JSP 視圖解析三條鏈路。5. 排查與避坑JSP 項目跑不起來時先查這五個地方5.1 頁面把${goods.name}原樣打印出來現(xiàn)象JSP 頁面沒有報錯但 EL 表達式?jīng)]有被解析頁面上直接顯示${goods.name}這類原文。原因絕大多數(shù)是 web.xml 的 servlet 版本聲明太低。Servlet 2.3 及以下默認 isELIgnored 為 true2.4 之后才默認支持 EL 解析。如果 web.xml 頭聲明的是 2.3 版本或者壓根沒有版本聲明被容器當(dāng)成老版本處理就會出現(xiàn)整頁表達式裸奔。解決把 web.xml 的 version 改成 3.0 或 3.1schema 換成xmlns.jcp.org的 javaee 版本。改完記得 RebuildMaven 項目里 WEB-INF/web.xml 是資源文件不重新構(gòu)建可能還在用舊的。5.2 數(shù)據(jù)庫連接報 Communications link failure現(xiàn)象Tomcat 啟動時 Spring 初始化數(shù)據(jù)源失敗控制臺出現(xiàn)Communications link failure或Access denied for user。原因驅(qū)動類名不匹配。MySQL 8 的驅(qū)動類已經(jīng)改成com.mysql.cj.jdbc.Driver連接串少了serverTimezoneAsia/Shanghai也會直接失敗。如果 pom 里引入的 mysql-connector-java 是 5.x而數(shù)據(jù)庫是 8.x協(xié)議層就不兼容怎么配都連不上。解決先把數(shù)據(jù)庫版本確認清楚再統(tǒng)一驅(qū)動。MySQL 8 配mysql-connector-java 8.0.x和com.mysql.cj.jdbc.Driver并在 url 后面拼?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/Shanghai。這個坑最常見于本地裝的是 8.0但網(wǎng)上搜到的老教程都是 5.x 寫法。5.3 MyBatis 報 Invalid bound statement (not found)現(xiàn)象項目能啟動Controller 也能進但一調(diào)用 Mapper 接口的方法就拋Invalid bound statement (not found): com.farm.mapper.GoodsMapper.getGoodsById。原因Mapper 接口和 XML 沒有綁定成功。常見三種情況XML 文件的 namespace 和接口全限定名不一致XML 沒被mapperLocations掃到比如放在了src/main/java下面而不是 resources接口方法名與 XML 里的 statement id 對不上。解決先檢查 namespace 是否等于接口的全路徑例如com.farm.mapper.GoodsMapper再確認 spring-context.xml 里mapperLocations路徑是classpath:mapper/*.xml最后看方法名和 id 是否一字不差。改完 spring 配置必須重啟Mapper 綁定是在容器啟動時完成的熱部署救不了。5.4 修改 JSP 后不生效運行的還是舊頁面現(xiàn)象改了 JSP 的標題或表格列刷新瀏覽器沒有任何變化甚至重啟 Tomcat 還是老頁面。原因JSP 是動態(tài)編譯的Tomcat 的 work 目錄緩存了上一次編譯的 Java 文件和 class 文件。開發(fā)模式下 idea 沒有把 resources 更新到 target或者瀏覽器強緩存了 .jsp 響應(yīng)。另一個隱蔽原因是代碼里對 JSP 響應(yīng)設(shè)置了Cache-Control頭導(dǎo)致瀏覽器端走了本地緩存。解決Idea 里 Build - Rebuild Project把 target 目錄清理重建Tomcat 的 deployment 選 war exploded 并打開 On frame deactivation 的 Update classes and resources瀏覽器按 CtrlF5 強制刷新。如果還不行手動刪掉 Tomcat 的work/Catalina目錄再啟動。5.5 Nginx 代理后頁面能開但接口全部 404現(xiàn)象直接訪問 Tomcat 端口一切正常接入 Nginx 做反向代理后JSP 頁面能打開但表單提交和列表查詢的路徑全 404。原因JSP 本身由 Tomcat 渲染Nginx 只是透傳所以頁面能出來。404 的通常是/sales/xxx這類 Controller 路徑大方向是請求沒轉(zhuǎn)發(fā)到 Tomcat 的上下文路徑。例如 Tomcat 應(yīng)用上下文是/farm而 Nginx 轉(zhuǎn)發(fā)時把/farm剝掉了SpringMVC 收到的請求路徑就對不上RequestMapping。解決Nginx 配置里轉(zhuǎn)發(fā)時保留原始 URI不要用 rewrite 去掉前綴。另外要明確一件事nginx 本身不支持 JSP 解析所有.jsp頁面和/api請求最終都要落到 TomcatNginx 只負責(zé)反向代理和靜態(tài)資源分發(fā)。建議把/static/、/upload/這類路徑直接用 Nginx 指向磁盤其余全部proxy_pass到 Tomcat 的 8080。6. 不推翻 JSP 的改造技巧先補接口回歸、緩存和一張對賬 SQL把 SSM JSP 這套跑通后很多人會糾結(jié)要不要推到重來換 Spring Boot。我建議先別急老系統(tǒng)最缺的不是框架是驗證手段。我接手這類供銷系統(tǒng)時第一件事不是重構(gòu)而是先給 Service 層補上單元測試再用一個 JSON 接口做聯(lián)調(diào)最后寫對賬 SQL 守住錢賬一致。先給核心 Service 寫測試。SSM 項目用 Spring Test 直接注入不啟動 Tomcat 也能驗證庫存扣減邏輯這比在頁面上點點點高效得多。RunWith(SpringJUnit4ClassRunner.class) ContextConfiguration(locations {classpath:spring-context.xml}) public class SalesServiceTest { Resource private SalesService salesService; Test public void testCreateOrderSuccess() { SalesOrder order new SalesOrder(); order.setOrderNo(SO20250101001); order.setCustomer(測試客戶); salesService.createOrder(order, 1, 10); // 斷言庫存從 200 變?yōu)?190 } }然后加一個 JSON 接口不破壞 JSP 頁面但給后續(xù)聯(lián)調(diào)留后門。在 Controller 里用ResponseBody返回商品列表 JSON前端可以用 Postman 直接測不必每次打開瀏覽器。RequestMapping(/api/goods/list) ResponseBody public MapString, Object listGoodsApi() { ListGoods list goodsService.listAll(); MapString, Object result new HashMap(); result.put(code, 0); result.put(data, list); return result; }接口驗證穩(wěn)定后再考慮緩存。JSP 頁面訪問量上來時商品列表和分類是熱點數(shù)據(jù)但注意別緩存庫存數(shù)字緩存只放商品基礎(chǔ)信息庫存仍實時查庫。這段改造是可選的重點是讓系統(tǒng)先有可回歸的測試和可對賬的 SQL。最后是守住賬目的對賬 SQL。跑完十筆訂單后用一條語句核對銷售明細金額之和與銷售單總額是否一致再查庫存為負數(shù)的商品這兩條檢查能讓供銷系統(tǒng)的數(shù)據(jù)問題在半小時內(nèi)暴露。-- 核對銷售單總額與明細是否一致 SELECT order_id, SUM(amount) AS item_total FROM sales_item GROUP BY order_id HAVING item_total (SELECT total_amount FROM sales_order WHERE id order_id); -- 找出庫存為負數(shù)的商品 SELECT goods_id, quantity FROM warehouse_stock WHERE quantity 0;老系統(tǒng)的價值不在技術(shù)新穎而在于業(yè)務(wù)閉環(huán)完整可驗證。我現(xiàn)在的習(xí)慣是不管接手什么 JSP 老項目先把對賬 SQL 和接口測試補上再談重構(gòu)。希望幫到你。本文還有配套的精品資源點擊獲取