場(chǎng)供銷系統(tǒng)源碼拆解:架構(gòu)、事務(wù)與部署實(shí)戰(zhàn))
簡介一套面向農(nóng)場(chǎng)管理人員和Java初學(xué)者的xx農(nóng)場(chǎng)供銷一體化系統(tǒng)源碼及說明文檔代碼基于SSMSpringSpringMVCMyBatis與JSP技術(shù)棧結(jié)合MySQL數(shù)據(jù)庫與Maven構(gòu)建工具實(shí)現(xiàn)農(nóng)產(chǎn)品信息管理、分類管理、在線訂購、會(huì)員管理及配送等核心功能。系統(tǒng)按角色分為管理員端與會(huì)員端管理員可維護(hù)商品與分類、處理訂購和會(huì)員數(shù)據(jù)會(huì)員則能瀏覽農(nóng)產(chǎn)品并提交訂購需求。壓縮包約23.55MB內(nèi)部源碼與說明文檔可配合IDEA或Eclipse進(jìn)行部署數(shù)據(jù)庫工具可使用Navicat或SQLyog。資源已吸引104人學(xué)習(xí)適合用來理解SSM各層整合、JSP動(dòng)態(tài)頁面開發(fā)、數(shù)據(jù)庫表結(jié)構(gòu)設(shè)計(jì)以及Maven項(xiàng)目管理流程。通過閱讀源碼和文檔讀者能掌握一套完整的農(nóng)場(chǎng)供銷業(yè)務(wù)閉環(huán)與前后端交互實(shí)現(xiàn)為課程設(shè)計(jì)或畢業(yè)設(shè)計(jì)提供可直接改造的參考。1. 農(nóng)場(chǎng)供銷一體化這套源碼核心是 JSP SSM 的分層協(xié)作“農(nóng)場(chǎng)供銷一體化系統(tǒng)”這個(gè)名字聽著像期末課設(shè)拆開看就是一套標(biāo)準(zhǔn)的 java SSM JSP 后臺(tái)項(xiàng)目Spring 管業(yè)務(wù) BeanSpringMVC 接 HTTP 請(qǐng)求MyBatis 讀寫 MySQL頁面用 JSP 渲染。它要解決的業(yè)務(wù)不算大但很完整——農(nóng)資采購入庫、農(nóng)產(chǎn)品銷售出庫、庫存臺(tái)賬、結(jié)算對(duì)賬四個(gè)環(huán)節(jié)在一個(gè)系統(tǒng)里閉環(huán)。這套源碼最值得看的不是頁面做得多精致而是三層架構(gòu)怎么把供銷單據(jù)串成一條可對(duì)賬的數(shù)據(jù)流。它適合三類人拿 jsp 做畢設(shè)選題的學(xué)生想搞懂 SSM 三者怎么協(xié)作的 java 學(xué)習(xí)者以及要給農(nóng)場(chǎng)或合作社搭內(nèi)部管理系統(tǒng)的開發(fā)。源碼本身能跑是基礎(chǔ)真正有價(jià)值的是你能照著它的分層把供銷業(yè)務(wù)的前因后果講清楚然后把數(shù)據(jù)流改造成自己的。2. 先拆工程骨架SSM 與 JSP 在供銷系統(tǒng)里各管哪一段2.1 從 Maven 工程目錄看三層職責(zé)與 JSP 的落位拿到源碼先別急著點(diǎn)運(yùn)行先把目錄掃一遍。這類項(xiàng)目通常是標(biāo)準(zhǔn)的 Maven 多模塊或單模塊結(jié)構(gòu)webapp 是 JSP 的家java 包下面按 controller、service、mapper、entity 分層。我一般會(huì)先看有沒有src/main/webapp/WEB-INF/jsp這個(gè)目錄有它說明視圖層走的是 JSP 轉(zhuǎn)發(fā)不是前后端分離。farm-supply-chain ├── pom.xml ├── src/main/java/com/farm │ ├── controller # SpringMVC 的 C接收請(qǐng)求、校驗(yàn)參數(shù)、決定跳哪個(gè) 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ù)庫表一一對(duì)應(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 容器入口版本號(hào)決定 EL 是否默認(rèn)開 │ └── jsp │ ├── login.jsp │ └── goods/list.jsp這個(gè)結(jié)構(gòu)在 java 課程設(shè)計(jì)和畢設(shè)里出現(xiàn)頻率極高面試問 SSM 項(xiàng)目也喜歡從這棵樹開始讓你講。業(yè)務(wù)上controller 不寫 SQLmapper 不寫 if 判斷service 才是供銷規(guī)則的執(zhí)行者。判斷一個(gè) SSM 項(xiàng)目寫得好不好先看 service 層是不是足夠厚。2.2 把一張銷售單變成一次事務(wù)Controller、Service、Mapper 怎么接力以“前臺(tái)提交一張銷售訂單”為例完整鏈路是 JSP 表單 POST 到 ControllerController 收參數(shù)后調(diào)用 ServiceService 先扣庫存再插單據(jù)最后返回視圖讓 JSP 展示結(jié)果。這里最容易寫錯(cuò)的是把庫存扣減寫在 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é)果消息放進(jìn) Model 供 JSP 讀取。注意Integer goodsId和Integer quantity是 JSP 表單里 input 的 name 值SpringMVC 會(huì)自動(dòng)綁定不用手動(dòng) request.getParameter。這樣寫的意義是 Controller 變薄出錯(cuò)時(shí)你能快速定位是參數(shù)問題還是業(yè)務(wù)問題。再往下看 Service。供銷系統(tǒng)的核心邏輯都?jí)涸?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 就不會(huì)執(zhí)行。如果這里沒用事務(wù)會(huì)出現(xiàn)庫存扣了但訂單沒生成的黑匣子賬目。2.3 依賴清單與版本邊界這套組合的默認(rèn)安全區(qū)SSM 的版本搭配在 java 面試題里幾乎是個(gè)固定考點(diǎn)實(shí)際跑項(xiàng)目時(shí)選錯(cuò)版本比寫錯(cuò)代碼更致命。常見做法是 JDK 8 Spring 5.2.x MyBatis 3.5.x MyBatis-Spring 2.0.xTomcat 用 8.5 或 9。這套組合經(jīng)過大量項(xiàng)目驗(yàn)證是源碼能直接跑起來的最大公約數(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注意兩個(gè)細(xì)節(jié)mysql 驅(qū)動(dòng)的 scope 是 runtime編譯期用不到運(yùn)行時(shí)由 Tomcat 加載servlet-api 必須 provided否則和 Tomcat 自帶的沖突啟動(dòng)直接報(bào) NoSuchMethodError。如果你本機(jī)是 MySQL 5.7驅(qū)動(dòng)版本可以降到 5.1.49但更省事的做法是庫和驅(qū)動(dòng)都統(tǒng)一到 8.0url 里加時(shí)區(qū)參數(shù)即可。3. 數(shù)據(jù)庫建模與供銷閉環(huán)庫存、訂單、結(jié)算怎么串成一條線3.1 供銷核心表概覽把業(yè)務(wù)拆成可對(duì)賬的關(guān)系農(nóng)場(chǎng)供銷系統(tǒng)的復(fù)雜度不在技術(shù)在表結(jié)構(gòu)設(shè)計(jì)。設(shè)計(jì)目標(biāo)是讓“采購進(jìn)來多少、賣出去多少、還剩多少”三件事能互相印證。下面是核心表的分工字段以精簡夠用為準(zhǔn)。表名職責(zé)關(guān)鍵字段與供銷的關(guān)系goods商品檔案goods_name、category、unit、price、status供銷的對(duì)象上下架狀態(tài)supplier供應(yīng)商name、contact、phone采購來源warehouse_stock庫存臺(tái)賬goods_id、quantity采購加、銷售減實(shí)時(shí)余額purchase_order采購單order_no、supplier_id、total_amount、status入庫依據(jù)purchase_item采購明細(xì)order_id、goods_id、price、quantity每筆采購的具體商品sales_order銷售單order_no、customer、total_amount、status出庫依據(jù)sales_item銷售明細(xì)order_id、goods_id、quantity、amount每筆銷貨的具體商品settlement結(jié)算對(duì)賬order_no、order_type、amount、status采購與銷售統(tǒng)一記賬這個(gè)拆分思路是“主表 明細(xì)表”模式采購單和銷售單都需要流水號(hào)明細(xì)表記錄商品級(jí)數(shù)據(jù)。庫存表是中間的賬本采購單審核通過給庫存加銷售單創(chuàng)建成功給庫存減結(jié)算表再做金額層核對(duì)。三層對(duì)上了供銷才不會(huì)出現(xiàn)賬實(shí)不符。3.2 建表 SQL明細(xì)表為什么要冗余商品名稱和單價(jià)看建表語句能判斷作者有沒有實(shí)戰(zhàn)經(jīng)驗(yàn)。一個(gè)典型的 sales_item 表會(huì)把 goods_name 和 price 冗余進(jìn)來而不是查詢時(shí)再去 join goods 表。原因是 JSP 列表頁經(jīng)常要展示歷史單據(jù)單據(jù)一旦生成商品改名、調(diào)價(jià)都不該影響它。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) );這里三個(gè)設(shè)計(jì)點(diǎn)值得抄金額字段統(tǒng)一用 DECIMAL禁止 float 和 double否則結(jié)算對(duì)賬會(huì)因精度翻車sales_item 冗余 goods_name 和 price讓 JSP 展示訂單詳情時(shí)少兩張表 joinwarehouse_stock 以 goods_id 為主鍵天然保證一個(gè)商品只有一行庫存記錄并發(fā)扣減時(shí)好鎖。3.3 扣庫存不靠先查再減一條 UPDATE 的樂觀鎖語義很多人第一次寫庫存扣減是先 SELECT 查 quantity判斷夠不夠再 UPDATE。這套寫法在單用戶調(diào)試時(shí)看不出來一旦兩個(gè)人同時(shí)下單就超賣。正確做法是把判斷寫在 UPDATE 的 WHERE 條件里讓數(shù)據(jù)庫替你做原子校驗(yàn)。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性能和對(duì)錯(cuò)兩頭都占。采購入庫同理改成quantity quantity #{quantity}但要考慮并發(fā)下同一商品多筆采購單同時(shí)入庫用追加而不是賦值覆蓋。3.4 初始化數(shù)據(jù)別讓外鍵和狀態(tài)字段卡住第一次啟動(dòng)源碼的說明文檔一般會(huì)附 SQL 腳本但常見坑是只建表不給初始化數(shù)據(jù)。跑供銷系統(tǒng)至少需要一條管理員賬號(hào)、兩類商品、一行初始庫存否則登錄進(jìn)去全是空列表你根本分不清是功能沒實(shí)現(xiàn)還是數(shù)據(jù)沒喂進(jìn)去。INSERT INTO goods (id, goods_name, category, unit, price, status) VALUES (1, 有機(jī)西紅柿, 蔬菜, 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 是這套老項(xiàng)目的常見做法雖然不夠強(qiáng)但至少不會(huì)一眼泄露。status 字段的取值要在代碼里統(tǒng)一商品 1 上架 0 下架訂單 0 待結(jié)算 1 已結(jié)算 2 已取消。JSP 頁面上顯示中文狀態(tài)時(shí)通常在 controller 里做映射不要在頁面寫死。4. 跑通源碼的關(guān)鍵配置Idea 導(dǎo)入、Spring 整合、JSP 聯(lián)調(diào)4.1 兩種導(dǎo)入方式直接開 Maven 工程還是手動(dòng)建 JSP 項(xiàng)目拿到源碼后第一件事不是改代碼是把工程正確導(dǎo)入 Idea。這里因人而異如果堅(jiān)持用“idea 新建 jsp 項(xiàng)目”的傳統(tǒng)方式需要手動(dòng)把 web 目錄指到 src/main/webapp再配置 Artifacts更省事的是直接用 Maven 方式打開。常見做法是 Idea 里 File - Open選擇項(xiàng)目下的 pom.xml以 Maven 項(xiàng)目導(dǎo)入。等待依賴下載完成后檢查右側(cè) Maven 窗口有沒有出現(xiàn) spring、mybatis 相關(guān)依賴然后配置 TomcatRun - Edit Configurations - 新建 Tomcat Server LocalDeployment 里添加 Artifact。這里有個(gè)區(qū)分如果它顯示 war exploded說明是開發(fā)模式改 JSP 可以熱更新如果是 war 包每次都要重新構(gòu)建適合最終部署。提示老項(xiàng)目常見的問題是本地 Maven 倉庫沒有對(duì)應(yīng)版本依賴idea 會(huì)一直卡在下載。把 Maven 的 settings.xml 里的鏡像倉庫配好再重新 import 一次基本能解決。4.2 jdbc.properties 與 spring-context.xml數(shù)據(jù)源、事務(wù)、Mapper 掃描三件事數(shù)據(jù)庫連不上是啟動(dòng)失敗的頭號(hào)原因而大部分是因?yàn)轵?qū)動(dòng)類名和時(shí)區(qū)參數(shù)。記住 MySQL 8 用com.mysql.cj.jdbc.DriverMySQL 5 用com.mysql.jdbc.Driverurl 里必須加serverTimezoneAsia/Shanghai否則報(bào)時(shí)區(qū)錯(cuò)誤。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是高頻出錯(cuò)點(diǎn)如果你的 Mapper XML 放在 resources 之外的目錄或者路徑寫成了classpath*:MyBatis 就找不到 SQL運(yùn)行時(shí)直接報(bào) Invalid bound statement。MapperScannerConfigurer 的 basePackage 是接口所在包它會(huì)把包下所有接口自動(dòng)代理成 Mapper Bean。4.3 spring-mvc.xml視圖解析器決定 JSP 跳到哪里SpringMVC 與 JSP 協(xié)作的關(guān)鍵是 InternalResourceViewResolver。它負(fù)責(zé)把 Controller 返回的字符串視圖名解析成真正可訪問的 JSP 路徑。如果這個(gè)前綴后綴配置不對(duì)任何請(qǐng)求都會(huì) 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 項(xiàng)目的標(biāo)準(zhǔn)安全姿勢(shì)也能避免 JSP 源碼直接暴露。靜態(tài)資源單獨(dú)配置是防止 DispatcherServlet 把 css/js 也當(dāng) controller 請(qǐng)求處理不加這段頁面會(huì)全部裸奔。4.4 web.xmlservlet 版本與編碼過濾器不能省web.xml 是第一道關(guān)卡版本聲明直接關(guān)系到 JSP 的 EL 表達(dá)式是否默認(rèn)開啟。如果你的 web.xml 是 2.3 或 2.4 的老版本JSP 頁面里的${goods.name}會(huì)被原樣輸出原因就是 EL 功能默認(rèn)關(guān)閉或部分支持。用 Servlet 3.1 版本聲明可以從根上避開這個(gè)坑。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之外的所有請(qǐng)求都進(jìn) SpringMVC.jsp請(qǐng)求由 Tomcat 的 Jasper 解析這樣 JSP 頁面本身不走 Controller 也能被訪問到。4.5 跑通一次完整供銷鏈路從登錄到庫存變化配置無誤后啟動(dòng) Tomcat瀏覽器訪問http://localhost:8080/farm/正常會(huì)跳登錄頁。用 admin 登錄之后按采購入庫、銷售出庫、庫存查詢的順序走一遍驗(yàn)證標(biāo)準(zhǔn)是倉庫里商品數(shù)量先增加后減少結(jié)算頁面的金額與訂單明細(xì)一致。我一般會(huì)準(zhǔn)備一張草稿紙把初始庫存數(shù)寫下來每做一筆就核對(duì)一次頁面數(shù)字。如果下單后庫存沒變優(yōu)先懷疑事務(wù)沒生效或者 Mapper XML 的 update 語句寫成了 insert。這一步跑通比看十頁文檔都管用因?yàn)樗淮涡则?yàn)證了 Spring 容器、MyBatis 映射、JSP 視圖解析三條鏈路。5. 排查與避坑JSP 項(xiàng)目跑不起來時(shí)先查這五個(gè)地方5.1 頁面把${goods.name}原樣打印出來現(xiàn)象JSP 頁面沒有報(bào)錯(cuò)但 EL 表達(dá)式?jīng)]有被解析頁面上直接顯示${goods.name}這類原文。原因絕大多數(shù)是 web.xml 的 servlet 版本聲明太低。Servlet 2.3 及以下默認(rèn) isELIgnored 為 true2.4 之后才默認(rèn)支持 EL 解析。如果 web.xml 頭聲明的是 2.3 版本或者壓根沒有版本聲明被容器當(dāng)成老版本處理就會(huì)出現(xiàn)整頁表達(dá)式裸奔。解決把 web.xml 的 version 改成 3.0 或 3.1schema 換成xmlns.jcp.org的 javaee 版本。改完記得 RebuildMaven 項(xiàng)目里 WEB-INF/web.xml 是資源文件不重新構(gòu)建可能還在用舊的。5.2 數(shù)據(jù)庫連接報(bào) Communications link failure現(xiàn)象Tomcat 啟動(dòng)時(shí) Spring 初始化數(shù)據(jù)源失敗控制臺(tái)出現(xiàn)Communications link failure或Access denied for user。原因驅(qū)動(dòng)類名不匹配。MySQL 8 的驅(qū)動(dòng)類已經(jīng)改成com.mysql.cj.jdbc.Driver連接串少了serverTimezoneAsia/Shanghai也會(huì)直接失敗。如果 pom 里引入的 mysql-connector-java 是 5.x而數(shù)據(jù)庫是 8.x協(xié)議層就不兼容怎么配都連不上。解決先把數(shù)據(jù)庫版本確認(rèn)清楚再統(tǒng)一驅(qū)動(dòng)。MySQL 8 配mysql-connector-java 8.0.x和com.mysql.cj.jdbc.Driver并在 url 后面拼?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/Shanghai。這個(gè)坑最常見于本地裝的是 8.0但網(wǎng)上搜到的老教程都是 5.x 寫法。5.3 MyBatis 報(bào) Invalid bound statement (not found)現(xiàn)象項(xiàng)目能啟動(dòng)Controller 也能進(jìn)但一調(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 對(duì)不上。解決先檢查 namespace 是否等于接口的全路徑例如com.farm.mapper.GoodsMapper再確認(rèn) spring-context.xml 里mapperLocations路徑是classpath:mapper/*.xml最后看方法名和 id 是否一字不差。改完 spring 配置必須重啟Mapper 綁定是在容器啟動(dòng)時(shí)完成的熱部署救不了。5.4 修改 JSP 后不生效運(yùn)行的還是舊頁面現(xiàn)象改了 JSP 的標(biāo)題或表格列刷新瀏覽器沒有任何變化甚至重啟 Tomcat 還是老頁面。原因JSP 是動(dòng)態(tài)編譯的Tomcat 的 work 目錄緩存了上一次編譯的 Java 文件和 class 文件。開發(fā)模式下 idea 沒有把 resources 更新到 target或者瀏覽器強(qiáng)緩存了 .jsp 響應(yīng)。另一個(gè)隱蔽原因是代碼里對(duì) 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 強(qiáng)制刷新。如果還不行手動(dòng)刪掉 Tomcat 的work/Catalina目錄再啟動(dòng)。5.5 Nginx 代理后頁面能開但接口全部 404現(xiàn)象直接訪問 Tomcat 端口一切正常接入 Nginx 做反向代理后JSP 頁面能打開但表單提交和列表查詢的路徑全 404。原因JSP 本身由 Tomcat 渲染Nginx 只是透?jìng)魉皂撁婺艹鰜怼?04 的通常是/sales/xxx這類 Controller 路徑大方向是請(qǐng)求沒轉(zhuǎn)發(fā)到 Tomcat 的上下文路徑。例如 Tomcat 應(yīng)用上下文是/farm而 Nginx 轉(zhuǎn)發(fā)時(shí)把/farm剝掉了SpringMVC 收到的請(qǐng)求路徑就對(duì)不上RequestMapping。解決Nginx 配置里轉(zhuǎn)發(fā)時(shí)保留原始 URI不要用 rewrite 去掉前綴。另外要明確一件事nginx 本身不支持 JSP 解析所有.jsp頁面和/api請(qǐng)求最終都要落到 TomcatNginx 只負(fù)責(zé)反向代理和靜態(tài)資源分發(fā)。建議把/static/、/upload/這類路徑直接用 Nginx 指向磁盤其余全部proxy_pass到 Tomcat 的 8080。6. 不推翻 JSP 的改造技巧先補(bǔ)接口回歸、緩存和一張對(duì)賬 SQL把 SSM JSP 這套跑通后很多人會(huì)糾結(jié)要不要推到重來換 Spring Boot。我建議先別急老系統(tǒng)最缺的不是框架是驗(yàn)證手段。我接手這類供銷系統(tǒng)時(shí)第一件事不是重構(gòu)而是先給 Service 層補(bǔ)上單元測(cè)試再用一個(gè) JSON 接口做聯(lián)調(diào)最后寫對(duì)賬 SQL 守住錢賬一致。先給核心 Service 寫測(cè)試。SSM 項(xiàng)目用 Spring Test 直接注入不啟動(dòng) Tomcat 也能驗(yàn)證庫存扣減邏輯這比在頁面上點(diǎn)點(diǎn)點(diǎn)高效得多。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(測(cè)試客戶); salesService.createOrder(order, 1, 10); // 斷言庫存從 200 變?yōu)?190 } }然后加一個(gè) JSON 接口不破壞 JSP 頁面但給后續(xù)聯(lián)調(diào)留后門。在 Controller 里用ResponseBody返回商品列表 JSON前端可以用 Postman 直接測(cè)不必每次打開瀏覽器。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; }接口驗(yàn)證穩(wěn)定后再考慮緩存。JSP 頁面訪問量上來時(shí)商品列表和分類是熱點(diǎn)數(shù)據(jù)但注意別緩存庫存數(shù)字緩存只放商品基礎(chǔ)信息庫存仍實(shí)時(shí)查庫。這段改造是可選的重點(diǎn)是讓系統(tǒng)先有可回歸的測(cè)試和可對(duì)賬的 SQL。最后是守住賬目的對(duì)賬 SQL。跑完十筆訂單后用一條語句核對(duì)銷售明細(xì)金額之和與銷售單總額是否一致再查庫存為負(fù)數(shù)的商品這兩條檢查能讓供銷系統(tǒng)的數(shù)據(jù)問題在半小時(shí)內(nèi)暴露。-- 核對(duì)銷售單總額與明細(xì)是否一致 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); -- 找出庫存為負(fù)數(shù)的商品 SELECT goods_id, quantity FROM warehouse_stock WHERE quantity 0;老系統(tǒng)的價(jià)值不在技術(shù)新穎而在于業(yè)務(wù)閉環(huán)完整可驗(yàn)證。我現(xiàn)在的習(xí)慣是不管接手什么 JSP 老項(xiàng)目先把對(duì)賬 SQL 和接口測(cè)試補(bǔ)上再談重構(gòu)。希望幫到你。本文還有配套的精品資源點(diǎn)擊獲取