簡(jiǎn)介這是一份基于前后端分離架構(gòu)的黑馬商城小項(xiàng)目適合正在學(xué)習(xí)Java Web開發(fā)的初學(xué)者也適合需要完成課程設(shè)計(jì)或畢業(yè)設(shè)計(jì)的學(xué)生。項(xiàng)目完整實(shí)現(xiàn)了電商平臺(tái)核心業(yè)務(wù)流程包括商品列表展示、商品詳情、購(gòu)物車增刪改、訂單提交與支付對(duì)接。壓縮包內(nèi)共425個(gè)文件大小44.22MB以Java源碼、Servlet編譯類、JSP頁(yè)面、HTML頁(yè)面、JavaScript腳本、樣式表以及大量商品圖片為主同時(shí)包含項(xiàng)目依賴的JAR包和數(shù)據(jù)庫(kù)配置文件。通過閱讀源碼可以清晰看到瀏覽器通過異步請(qǐng)求對(duì)象向服務(wù)器發(fā)送請(qǐng)求服務(wù)器端Servlet處理業(yè)務(wù)后返回輕量級(jí)的JSON數(shù)據(jù)前端再動(dòng)態(tài)更新頁(yè)面的全過程。資源附帶完整的工程結(jié)構(gòu)、數(shù)據(jù)庫(kù)腳本和部署說明便于直接導(dǎo)入開發(fā)工具運(yùn)行調(diào)試。已有2806人學(xué)習(xí)下載適合對(duì)照代碼逐模塊理解電商常用功能的設(shè)計(jì)與實(shí)現(xiàn)。1. 黑馬商城是什么項(xiàng)目一套能兩周吃透的 JavaWeb 電商骨架很多自學(xué) Java 的人都有這個(gè)階段Servlet、JSP、Spring 都背得出來合在一起就不知道代碼該往哪兒放。黑馬商城小項(xiàng)目解決的就是這個(gè)卡點(diǎn)。它是很多培訓(xùn)班和自學(xué)者電腦里都會(huì)躺著的教學(xué)型電商工程解壓后是一個(gè)完整的 SSMSpring SpringMVC MyBatis項(xiàng)目帶有商品列表、登錄注冊(cè)、購(gòu)物車、下單、模擬支付這幾條電商主線。它能驗(yàn)證你學(xué)過的所有 JavaWeb 組件能不能真正串起來也能直接當(dāng)課設(shè)或簡(jiǎn)歷項(xiàng)目的底子。本文按最常見版本拆開講Maven 聚合、JSP 前端、MySQL 存儲(chǔ)并會(huì)說明 SpringBoot 版改起來差在哪。2. 動(dòng)手之前先做三件事解壓、環(huán)境核對(duì)、數(shù)據(jù)庫(kù)腳本導(dǎo)入2.1 解壓后的目錄怎么讀先看結(jié)構(gòu)再寫代碼拿到 zip 之后別急著雙擊 IDEA 打開先在命令行里看一眼目錄結(jié)構(gòu)。常見做法是用tree命令Windows 下可以用tree /FmacOS/Linux 用tree -L 3。這個(gè)壓縮包解壓后通常是標(biāo)準(zhǔn)的 Maven 工程頂層目錄大概長(zhǎng)這樣heima-shop/ ├── pom.xml # 父 POM統(tǒng)一管理依賴版本和模塊 ├── heima-shop-dao/ # MyBatis Mapper 與實(shí)體類 ├── heima-shop-service/ # 業(yè)務(wù)邏輯層 ├── heima-shop-web/ # SpringMVC Controller JSP 頁(yè)面 └── sql/ └── heima_shop.sql # 建庫(kù)、建表、初始化數(shù)據(jù)腳本先看sql目錄在不在再看pom.xml里的modules。如果modules里列了三個(gè)子模塊說明這是多模塊工程導(dǎo)入時(shí)要把父 POM 作為 Maven 工程打開而不是單獨(dú)打開子模塊。很多翻車案例都是第一次直接打開了 heima-shop-web結(jié)果 Maven 找不到 dao 和 service 的依賴整個(gè)項(xiàng)目標(biāo)紅。我一般會(huì)順手檢查pom.xml里 Spring、MyBatis 的版本號(hào)。常見的組合是 Spring 5.x MyBatis 3.5 MyBatis-Spring 2.x這個(gè)組合在 JDK 8 和 Tomcat 8.5 上兼容性最好。如果看到mybatis-spring版本是 1.x就要注意和 Spring 5 存在包名沖突啟動(dòng)時(shí)容易報(bào)NoSuchBeanDefinitionException。2.2 環(huán)境版本照這個(gè)配JDK、Maven、Tomcat、MySQL版本不匹配是這個(gè)項(xiàng)目第一天的頭號(hào)殺手我踩過一次 JDK 8 編譯的項(xiàng)目放到 JDK 11 上運(yùn)行反射相關(guān)的代碼直接拋異常。建議按下面這套來不折騰組件推薦版本說明JDK1.8項(xiàng)目編譯目標(biāo)基本都是 8換更高版本要改 pom 編譯插件Maven3.6.x3.8 對(duì)中央倉(cāng)庫(kù) HTTPS 更嚴(yán)格老項(xiàng)目的鏡像配置可能失效Tomcat8.5.x支持 Servlet 3.1和 Spring 5 匹配MySQL5.7 或 8.05.7 零配置最穩(wěn)8.0 需要處理驅(qū)動(dòng)類名和時(shí)區(qū)問題先說為什么固定 JDK 8。老教學(xué)項(xiàng)目的pom.xml里經(jīng)常寫著source1.8/sourcetarget1.8/target你本地裝的是 JDK 17 也能編譯但運(yùn)行期像 CGLIB 代理、JSP 編譯這些環(huán)節(jié)在更高 JDK 上會(huì)出現(xiàn)兼容性告警對(duì)新手來說排錯(cuò)成本很高。裝雙 JDK 是常見做法IDEA 里每個(gè)工程單獨(dú)指定 SDK 即可。MySQL 是另一個(gè)變量。5.7 不用改任何參數(shù)就能連上8.0 必須在 JDBC 連接串里帶serverTimezoneAsia/Shanghai和allowPublicKeyRetrievaltrue否則啟動(dòng)就報(bào)時(shí)區(qū)錯(cuò)誤或公鑰檢索錯(cuò)誤。如果你和我一樣主力 MySQL 是 8.0建議建一個(gè)專用庫(kù)而不是復(fù)用生產(chǎn)庫(kù)。2.3 導(dǎo)入數(shù)據(jù)庫(kù)腳本手工建庫(kù)再導(dǎo)入最省事把 SQL 腳本交給 Navicat 直接運(yùn)行也沒問題但我不太建議這樣做因?yàn)槟_本里如果沒有CREATE DATABASE語(yǔ)句你在某個(gè)默認(rèn)庫(kù)里建出一堆表后面改連接串時(shí)容易對(duì)不上。手動(dòng)建庫(kù)再導(dǎo)入每一步都看得見mysql -uroot -p CREATE DATABASE heima_shop DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; USE heima_shop; SOURCE /your/path/to/heima-shop/sql/heima_shop.sql; SHOW TABLES;這段命令的邏輯先建庫(kù)并指定字符集utf8mb4是為了讓商品名稱、用戶昵稱里如果有表情符號(hào)也不會(huì)亂碼SOURCE是 MySQL 命令行執(zhí)行 SQL 文件的指令路徑不要帶中文否則偶爾會(huì)碰到編碼解析問題SHOW TABLES用來確認(rèn)表建出來了正常應(yīng)該能看到tb_user、tb_category、tb_product、tb_order、tb_order_item這五類核心表。導(dǎo)入完成后順手查三張表的數(shù)據(jù)量判斷初始化數(shù)據(jù)是否完整SELECT COUNT(*) FROM tb_product; SELECT COUNT(*) FROM tb_user; SELECT COUNT(*) FROM tb_order;如果tb_product只有幾條記錄說明腳本可能被改過或?qū)霑r(shí)中斷了后面首頁(yè)商品展示會(huì)非?？张挪闀r(shí)容易誤判是前端的問題。這一步相當(dāng)于給項(xiàng)目做一次“體檢”確保起點(diǎn)數(shù)據(jù)是對(duì)的。2.4 工程導(dǎo)入 IDEA改對(duì)數(shù)據(jù)源連接串再啟動(dòng)導(dǎo)入步驟不多但每步都有坑。先在 IDEA 里File - New - Project from Existing Sources選中解壓目錄里的pom.xmlMaven 會(huì)自動(dòng)識(shí)別多模塊結(jié)構(gòu)。然后等依賴下載完檢查右側(cè) Maven 面板里是否出現(xiàn)heima-shop-dao、heima-shop-service、heima-shop-web三個(gè)模塊。啟動(dòng)前必須改的是數(shù)據(jù)庫(kù)連接配置。老項(xiàng)目常見命名是jdbc.properties或db.properties位置在heima-shop-web/src/main/resources/下jdbc.drivercom.mysql.jdbc.Driver jdbc.urljdbc:mysql://localhost:3306/heima_shop?useUnicodetruecharacterEncodingutf8useSSLfalseserverTimezoneAsia/Shanghai jdbc.usernameroot jdbc.password123456參數(shù)說明driver在 MySQL 8.0 下要換成com.mysql.cj.jdbc.Driver5.7 用com.mysql.jdbc.Driver就行serverTimezone只針對(duì) MySQL 8.0不加的話連接層直接報(bào)The server time zone value錯(cuò)誤useSSLfalse是必須的因?yàn)榻虒W(xué)項(xiàng)目的證書配置基本不存在開著 TLS 握手反而失敗characterEncodingutf8保證中文寫入不亂碼。改完連接串啟動(dòng) Tomcat 前還要確認(rèn) IDEA 的 Deployment 里Application context是/而不是/heima-shop-web_war否則瀏覽器里所有請(qǐng)求路徑都要帶項(xiàng)目名頁(yè)面里寫死的/product/list這種絕對(duì)路徑會(huì)全部 404。這一步是新手最容易忽略的配置里改對(duì)了數(shù)據(jù)庫(kù)卻在訪問路徑上卡半小時(shí)。3. 拆解商城內(nèi)部從登錄到下單的完整調(diào)用鏈路3.1 分層架構(gòu)怎么分工Controller、Service、Mapper 各自管到哪一層Spring 系的 Web 項(xiàng)目最核心的就是分層的邊界感。黑馬商城這樣一個(gè)教學(xué)項(xiàng)目它的包結(jié)構(gòu)本身就是答案controller只管收參數(shù)和返回視圖service管業(yè)務(wù)規(guī)則和事務(wù)dao層只負(fù)責(zé)和數(shù)據(jù)庫(kù)打交道。理解這個(gè)邊界后面改造任何功能都知道代碼該寫在哪。層包名示例職責(zé)反面案例Controllercom.heima.shop.controller參數(shù)校驗(yàn)、調(diào)用 Service、跳轉(zhuǎn)頁(yè)面在 Controller 里寫 SQLServicecom.heima.shop.service業(yè)務(wù)編排、事務(wù)控制、庫(kù)存判斷一個(gè)方法里寫 200 行 SQLMappercom.heima.shop.dao單表 CRUD、復(fù)雜查詢 SQL把分頁(yè)邏輯寫在 Service 里Domaincom.heima.shop.pojo實(shí)體映射、VO 對(duì)象實(shí)體類里寫業(yè)務(wù)方法這個(gè)項(xiàng)目的 Controller 返回值通常是String配合 SpringMVC 的視圖解析器跳到對(duì)應(yīng) JSP。如果你看代碼時(shí)發(fā)現(xiàn) Controller 里返回 JSON那多半是項(xiàng)目里某個(gè)接口單獨(dú)加了ResponseBody或RestController。同一套項(xiàng)目里混用兩種返回方式很常見別覺得奇怪前端頁(yè)面用視圖跳轉(zhuǎn)異步接口用 JSON 返回。我建議你從“商品列表”這個(gè)最簡(jiǎn)單的功能入手讀代碼理由有三一是鏈路短從請(qǐng)求到 SQL 只有三個(gè)類二是覆蓋了參數(shù)綁定、Service 調(diào)用、MyBatis 查詢、數(shù)據(jù)回顯這四大基本功三是它不涉及事務(wù)和狀態(tài)流轉(zhuǎn)讀起來沒有認(rèn)知負(fù)擔(dān)。3.2 商品列表的請(qǐng)求鏈路一個(gè) URL 從瀏覽器到 SQL 的完整過程以/product/list?cid2這個(gè)地址為例一次請(qǐng)求經(jīng)歷了這些步驟Tomcat 把請(qǐng)求交給 DispatcherServlet它通過RequestMapping匹配到ProductController的list方法Controller 調(diào)用ProductService.listByCategory(cid)Service 調(diào)用ProductDao.selectByCategoryId(cid)Mapper XML 里執(zhí)行真實(shí) SQL 返回商品集合Controller 把集合放進(jìn)Model視圖解析器渲染product_list.jsp。下面兩個(gè)關(guān)鍵代碼片段是這套鏈路的前后兩段Controller RequestMapping(/product) public class ProductController { Autowired private ProductService productService; RequestMapping(/list) public String list(Integer cid, Model model) { // 按分類查商品列表cid 為空時(shí)默認(rèn)查全部 ListProduct products productService.listByCategory(cid); model.addAttribute(products, products); return product_list; } }代碼邏輯Integer cid是參數(shù)綁定SpringMVC 自動(dòng)把 URL 里的cid轉(zhuǎn)成 Integer傳空時(shí)又能拿 null 做兜底Model是 SpringMVC 的傳參容器頁(yè)面里用${products}就能遍歷輸出。這個(gè)類是最標(biāo)準(zhǔn)的 SSM 寫法你看懂這一頁(yè)后面訂單、用戶模塊的 Controller 都是同一個(gè)套路。再往下看 Mapper 層這個(gè)項(xiàng)目用的是 XML 映射文件而不是注解 SQL。XML 的好處是 SQL 可以寫復(fù)雜動(dòng)態(tài)條件不用在 Java 代碼里拼字符串select idselectByCategoryId parameterTypeint resultTypecom.heima.shop.pojo.Product SELECT id, name, price, image, stock, cid FROM tb_product where if testcid ! null AND cid #{cid} /if /where ORDER BY id DESC /selectwhere標(biāo)簽是 MyBatis 的動(dòng)態(tài) SQLcid為 null 時(shí)自動(dòng)去掉AND避免 SQL 語(yǔ)法錯(cuò)誤#{cid}是預(yù)編譯占位符可以防 SQL 注入。Order By id DESC讓新商品排在前面教學(xué)項(xiàng)目沒有做商品上架時(shí)間字段用主鍵倒序是簡(jiǎn)化處理。你以后做真實(shí)項(xiàng)目這里基本會(huì)改成create_time DESC。3.3 登錄狀態(tài)和購(gòu)物車數(shù)據(jù)放哪Session 方案與它的替代品這個(gè)項(xiàng)目的登錄態(tài)用的是 Session購(gòu)物車也是 Session 存的。邏輯很直接用戶登錄成功后session.setAttribute(user, user)每次請(qǐng)求從 Session 拿用戶購(gòu)物車用一個(gè)MapInteger, CartItem裝進(jìn) Session加購(gòu)就是往 Map 里 put。這是教學(xué)項(xiàng)目最常見的方案簡(jiǎn)單、好理解、代碼量少。但它有兩個(gè)天然的痛點(diǎn)一是用戶關(guān)掉瀏覽器再打開購(gòu)物車就沒了——Session 的生命周期是會(huì)話級(jí)別的二是集群部署下 Session 不共享用戶在服務(wù)器 A 登錄請(qǐng)求被分發(fā)到服務(wù)器 B 就變成未登錄。解決思路不復(fù)雜把購(gòu)物車持久化到數(shù)據(jù)庫(kù)表tb_cart登錄狀態(tài)換成 Token 或 Redis 共享 Session。后續(xù)章節(jié)我會(huì)給到改造方向這里先把它是什么看清楚。購(gòu)物車 Service 的典型邏輯是這樣一段public void addToCart(HttpSession session, Integer productId, Integer num) { // 從 Session 拿購(gòu)物車沒有就新建一個(gè) MapInteger, CartItem cart (MapInteger, CartItem) session.getAttribute(cart); if (cart null) { cart new HashMap(); } CartItem item cart.get(productId); if (item null) { Item itemInfo productService.findById(productId); cart.put(productId, new CartItem(itemInfo, num)); } else { // 已存在則數(shù)量累加避免重復(fù)商品出現(xiàn)兩行 item.setNum(item.getNum() num); } session.setAttribute(cart, cart); }代碼邏輯外層用 Map 以商品 ID 為 key天然去重item null判斷該商品是否已在購(gòu)物車不存在就新建存在就累計(jì)數(shù)量。這里有個(gè)隱藏問題num沒有做正整數(shù)校驗(yàn)如果前端傳入-1購(gòu)物車數(shù)量會(huì)變成負(fù)數(shù)結(jié)算金額也可能為負(fù)——真實(shí)項(xiàng)目里入?yún)⑿ｒ?yàn)不能只靠前端。你可以在 Controller 層加一層Min(1)校驗(yàn)或者參考新版里的assert判斷。3.4 下單事務(wù)為什么超賣問題會(huì)出現(xiàn)在這個(gè)教學(xué)項(xiàng)目里下單是商城項(xiàng)目里業(yè)務(wù)最重的一個(gè)方法它的完整事務(wù)鏈?zhǔn)遣樯唐?→ 扣庫(kù)存 → 生成訂單 → 生成訂單明細(xì) → 清空購(gòu)物車。大多數(shù)教學(xué)項(xiàng)目把這五步放在同一個(gè) Service 方法里方法上標(biāo)注Transactional這個(gè)注解可以保證任何一步拋異常前面已經(jīng)執(zhí)行的 SQL 全部回滾。下面是這個(gè)項(xiàng)目里常見的下單核心代碼骨架Transactional(rollbackFor Exception.class) public Order createOrder(Integer userId, Integer[] productIds, Integer[] nums) { // 1. 生成訂單主表記錄 Order order new Order(userId, totalPrice, OrderState.UNPAID); orderDao.insert(order); // 2. 循環(huán)扣減庫(kù)存同時(shí)生成明細(xì) for (int i 0; i productIds.length; i) { Product product productDao.selectByIdForUpdate(productIds[i]); if (product.getStock() nums[i]) { throw new BusinessException(庫(kù)存不足); } productDao.decreaseStock(productIds[i], nums[i]); orderItemDao.insert(new OrderItem(order.getId(), productIds[i], nums[i])); } // 3. 清空購(gòu)物車 cartDao.deleteByUserId(userId); return order; }代碼邏輯selectByIdForUpdate里的FOR UPDATE是行級(jí)鎖目的是防止兩個(gè)用戶同時(shí)下單時(shí)把庫(kù)存扣成負(fù)數(shù)——這是教學(xué)項(xiàng)目里處理超賣最關(guān)鍵的一行SQLrollbackFor Exception.class表示捕獲所有異常都回滾如果只寫Transactional其實(shí)默認(rèn)只回滾 RuntimeException業(yè)務(wù)異常BusinessException不會(huì)觸發(fā)回滾這是個(gè)很陰間的細(xì)節(jié)。但這套寫法在并發(fā)下并不是絕對(duì)安全的原因在于FOR UPDATE鎖是數(shù)據(jù)庫(kù)層的如果項(xiàng)目換了數(shù)據(jù)庫(kù)或者鎖被共享讀覆蓋超賣還是會(huì)發(fā)生。教學(xué)項(xiàng)目通常不會(huì)去壓測(cè)并發(fā)但你在簡(jiǎn)歷上寫“解決超賣問題”時(shí)至少要知道兩個(gè)進(jìn)階方案一個(gè)是用樂觀鎖版本號(hào)在UPDATE語(yǔ)句里加WHERE stock num條件另一個(gè)是預(yù)減庫(kù)存下單先扣 Redis 里的庫(kù)存支付成功后再真正落庫(kù)。前者更簡(jiǎn)單后者更接近大型系統(tǒng)的做法。4. 讓商城真正能用的關(guān)鍵配置連接池、靜態(tài)資源、分頁(yè)和訂單狀態(tài)4.1 數(shù)據(jù)庫(kù)連接池的 4 個(gè)必調(diào)參數(shù)項(xiàng)目里數(shù)據(jù)源一般用 DBCP 或 C3P0教學(xué)項(xiàng)目里 DBCP 見到最多。配置都在jdbc.properties里你改數(shù)據(jù)庫(kù)賬號(hào)密碼的同時(shí)建議順手把連接池參數(shù)也改到位。默認(rèn)配置經(jīng)常是沒寫這些參數(shù)的跑通沒問題接口一多就頻繁卡頓。參數(shù)建議值作用initialSize5啟動(dòng)時(shí)預(yù)創(chuàng)建連接避免第一個(gè)請(qǐng)求現(xiàn)連數(shù)據(jù)庫(kù)maxTotal20最大連接數(shù)超出后請(qǐng)求排隊(duì)等待maxIdle10空閑連接上限超過會(huì)被回收testWhileIdletrue空閑時(shí)檢測(cè)連接有效性防止拿到失效連接報(bào) Connection closedDBCP 的配置寫在applicationContext.xml的數(shù)據(jù)源 bean 里參數(shù)會(huì)通過${jdbc.initialSize}這類占位符引用 properties 文件。如果你發(fā)現(xiàn)啟動(dòng)時(shí)控制臺(tái)打出一大段告警說連接池初始化失敗多數(shù)是 maxTotal 與 MySQL 自帶的 max_connections 沖突或者在連接串里沒帶useSSLfalse。4.2 靜態(tài)資源放行與 JSP 路徑解析頁(yè)面 404 的一半原因在這SpringMVC 默認(rèn)攔截所有請(qǐng)求包括.js、.css、.jpg。如果springmvc.xml里沒有配置靜態(tài)資源放行瀏覽器請(qǐng)求 CSS 會(huì)返回 404頁(yè)面看起來就是裸的 HTML。很多新手以為是前端代碼的問題其實(shí)后端根本沒把資源放出去。配置是這樣寫的mvc:resources location/static/ mapping/static/** / bean classorg.springframework.web.servlet.view.InternalResourceViewResolver property nameprefix value/WEB-INF/jsp/ / property namesuffix value.jsp / /bean第一行把/static/**映射到/static/目錄這樣瀏覽器訪問/static/css/style.css就能拿到真實(shí)文件第二行是視圖解析器的標(biāo)準(zhǔn)配置Controller 里返回product_list時(shí)它會(huì)拼接成/WEB-INF/jsp/product_list.jsp。注意一個(gè)細(xì)節(jié)JSP 放在WEB-INF下面有個(gè)好處用戶不能通過地址欄直接訪問 JSP 源碼必須經(jīng)過 Controller這是項(xiàng)目里頁(yè)面跳轉(zhuǎn)都走后端的原因。很多人的 404 是這么來的Controller 返回值寫錯(cuò)了大小寫比如返回Product_List而文件名是product_list.jsp或者前綴配到了/WEB-INF/views/但 JSP 實(shí)際放在/WEB-INF/jsp/。排查時(shí)直接在瀏覽器訪問轉(zhuǎn)出的完整路徑看 Tomcat 的日志里有沒有Resource not found字樣。4.3 分頁(yè)查詢PageHelper 的兩個(gè)必填參數(shù)商品列表頁(yè)一般不會(huì)把所有商品一次查出來教學(xué)項(xiàng)目里最常見的是 PageHelper 插件幾行代碼就能把分頁(yè)邏輯接好。它是在 MyBatis 執(zhí)行層通過攔截器改寫的 SQL自動(dòng)在尾部拼接LIMIT。配置如下bean idsqlSessionFactory classorg.mybatis.spring.SqlSessionFactoryBean property nameplugins array bean classcom.github.pagehelper.PageInterceptor property nameproperties props prop keyhelperDialectmysql/prop prop keyreasonabletrue/prop /props /property /bean /array /property /beanhelperDialect告訴插件數(shù)據(jù)庫(kù)方言mysql 會(huì)生成LIMIT ?語(yǔ)句reasonable的作用是防止越界請(qǐng)求當(dāng)pageNum小于 1 時(shí)自動(dòng)置為 1大于最大頁(yè)數(shù)時(shí)自動(dòng)置為最后一頁(yè)。這個(gè)參數(shù)在你做畢設(shè)演示時(shí)特別有用別人故意輸入?pageNum999頁(yè)面不會(huì)白屏。代碼層面Service 里只在查詢前調(diào)用一次PageHelper.startPage(pageNum, pageSize)后面緊跟的第一次查詢就會(huì)被分頁(yè)攔截public PageInfoProduct listByPage(Integer cid, Integer pageNum, Integer pageSize) { PageHelper.startPage(pageNum, pageSize); ListProduct list productDao.selectByCategoryId(cid); return new PageInfo(list); }一定要記住startPage只對(duì)緊接著執(zhí)行的第一條查詢生效。如果你在它和查詢之間插入了別的數(shù)據(jù)庫(kù)操作分頁(yè)會(huì)被那個(gè)查詢搶走結(jié)果商品列表永遠(yuǎn)查不到第二頁(yè)數(shù)據(jù)。這也是這個(gè)插件最常見的誤用姿勢(shì)。4.4 訂單狀態(tài)怎么設(shè)計(jì)從待支付到已完成的狀態(tài)機(jī)這個(gè)項(xiàng)目的訂單表核心字段是status狀態(tài)值一般是數(shù)字映射關(guān)系大概是0 待支付、1 已支付待發(fā)貨、2 已發(fā)貨、3 已完成、4 已取消。整個(gè)狀態(tài)流轉(zhuǎn)是單向的不允許從已支付跳回待支付。status含義觸發(fā)方式0待支付下單成功創(chuàng)建訂單時(shí)寫入1已支付模擬支付接口回調(diào)后更新3已完成用戶點(diǎn)擊確認(rèn)收貨4已取消待支付狀態(tài)下用戶取消教學(xué)項(xiàng)目里的支付一般是模擬實(shí)現(xiàn)常見做法是點(diǎn)擊“去支付”直接跳到一個(gè)mockPay接口接口內(nèi)把訂單狀態(tài)從 0 改成 1不做真實(shí)資金流轉(zhuǎn)。你在改造成簡(jiǎn)歷項(xiàng)目時(shí)可以保留這個(gè)模擬接口并補(bǔ)一個(gè)說明文檔寫清楚真實(shí)支付替換方案是接第三方沙箱支付或本地支付網(wǎng)關(guān)。訂單超時(shí)取消通常不在教學(xué)項(xiàng)目里實(shí)現(xiàn)但這是一個(gè)很好的加分功能。思路是下單時(shí)記錄create_time用戶查詢訂單時(shí)如果狀態(tài)為 0 且創(chuàng)建時(shí)間超過 30 分鐘自動(dòng)置為 4 并釋放庫(kù)存。這個(gè)邏輯可以用 Spring 定時(shí)任務(wù)實(shí)現(xiàn)也可以只在查詢時(shí)按條件更新后者對(duì)新手更友好不需要引入消息隊(duì)列。5. 黑馬商城跑不起來這 5 個(gè)坑我踩了不止一次5.1 數(shù)據(jù)庫(kù)驅(qū)動(dòng)報(bào)錯(cuò)Public Key Retrieval is not allowed 與時(shí)區(qū)異?，F(xiàn)象項(xiàng)目啟動(dòng)或第一次查商品列表時(shí)控制臺(tái)報(bào)Public Key Retrieval is not allowed或The server time zone value й? is unrecognized連接串在正常數(shù)據(jù)庫(kù)客戶端里又能連上。原因這兩條都是 MySQL 8.0 的連接層校驗(yàn)問題前者是因?yàn)?8.0 默認(rèn)用caching_sha2_password認(rèn)證插件安全傳輸公鑰需要客戶端顯式允許后者是驅(qū)動(dòng)讀到了 MySQL 服務(wù)器的系統(tǒng)時(shí)區(qū)但本地沒有做映射。解決在jdbc.url后面加上allowPublicKeyRetrievaltrueserverTimezoneAsia/Shanghai并把驅(qū)動(dòng)改成com.mysql.cj.jdbc.Driver。如果仍然報(bào)錯(cuò)檢查你本地裝的是不是 mysql-connector 5.1.x換成 8.0.x 再試。5.2 Tomcat 端口被占用啟動(dòng)后頁(yè)面自動(dòng)跳回 IDEA 首頁(yè)現(xiàn)象啟動(dòng) Tomcat 時(shí)日志顯示Port 8080 was already in use或者瀏覽器訪問 localhost:8080 打開的是 IDEA 的歡迎頁(yè)。原因8080 被別的進(jìn)程占了最常見的是之前殘留的 Tomcat 實(shí)例或者另一個(gè)開發(fā)工具使用了默認(rèn)端口。解決兩個(gè)選擇——關(guān)掉占用進(jìn)程或者在 IDEA 的Edit Configuration里把 Tomcat 的 HTTP port 改成 8081并同步檢查Application context是否還是/。改端口后如果頁(yè)面樣式全丟了十有八九是頁(yè)面里的靜態(tài)資源路徑寫死了 8080檢查前端模板或全局配置里的端口相關(guān)常量。5.3 Maven 依賴全是紅、下載慢、找不到本地倉(cāng)庫(kù)現(xiàn)象導(dǎo)入工程后 IDEA 里spring-webmvc、mybatis等坐標(biāo)全部報(bào)紅Maven 面板刷新后卡在下載不結(jié)束。原因國(guó)內(nèi)直連中央倉(cāng)庫(kù)速度不穩(wěn)定或者老項(xiàng)目的倉(cāng)庫(kù)地址是 http 協(xié)議新版 Maven 默認(rèn)禁止非 HTTPS 倉(cāng)庫(kù)。解決在settings.xml的mirrors節(jié)點(diǎn)配置一個(gè)可用的鏡像源并確認(rèn)倉(cāng)庫(kù)地址是 https。改完鏡像后記得在 IDEA 的 Maven 配置項(xiàng)里指定本地倉(cāng)庫(kù)地址和settings.xml路徑然后執(zhí)行一次clean install把依賴真正拉下來。這一步不需要改項(xiàng)目代碼但沒做對(duì)的話后面所有操作都動(dòng)不了。5.4 頁(yè)面能打開但圖片全裂、CSS 完全裸奔現(xiàn)象商品列表頁(yè)面能顯示文字但所有圖片都是裂圖頁(yè)面沒有任何樣式控制臺(tái)一堆 404。原因多半是springmvc.xml里缺靜態(tài)資源映射或者項(xiàng)目實(shí)際目錄結(jié)構(gòu)里靜態(tài)文件根本不在/static/下。教學(xué)項(xiàng)目的 JSP 里常常用${pageContext.request.contextPath}/static/...拼路徑如果項(xiàng)目部署名不是/這個(gè)路徑會(huì)帶上應(yīng)用名后端放行配置又只匹配了/static/**的絕對(duì)路徑就會(huì)匹配失敗。解決先打開瀏覽器控制臺(tái)看具體 404 的 URL再對(duì)照springmvc.xml的mvc:resources看是否匹配。還有一種隱蔽情況圖片文件在WEB-INF下這屬于安全目錄容器不會(huì)對(duì)外暴露必須把圖片挪到webapp/static或webapp/upload下。5.5 下單后庫(kù)存沒扣或扣了庫(kù)存訂單沒生成現(xiàn)象提交訂單提示成功但商品詳情頁(yè)庫(kù)存數(shù)量沒變或者庫(kù)存變了訂單列表里查不到記錄。原因這兩種情況本質(zhì)是事務(wù)沒有生效最常見是Transactional寫在了私有方法上或是在同一個(gè)類里調(diào)用自己的方法導(dǎo)致事務(wù)代理沒有介入。另一個(gè)常見原因是用try-catch包住了異常事務(wù)捕獲不到拋出點(diǎn)默認(rèn)就不會(huì)回滾。解決把事務(wù)注解放到 public 方法上并且通過注入的 Service 對(duì)象跨類調(diào)用不要在事務(wù)方法內(nèi)部把異常吞掉要么向上拋出要么在 catch 后手動(dòng)TransactionAspectSupport.currentTransactionStatus().setRollbackOnly()。判斷事務(wù)是否生效可以在運(yùn)行時(shí)看日志里有沒有Creating new transaction字樣。6. 從跑通到變成你自己的項(xiàng)目三個(gè)改造方向與一個(gè)調(diào)試習(xí)慣如果你已經(jīng)能正常跑起來并在瀏覽器完成一次下單接下來這幾步值得做它們能讓這個(gè)教學(xué)項(xiàng)目在簡(jiǎn)歷上變得有辨識(shí)度。方向一是把 Session 購(gòu)物車改成 Redis 存儲(chǔ)。核心是把購(gòu)物車的存取從 HttpSession 換成 Redis 的 Hash 結(jié)構(gòu)用 userId 作為 key、商品 id 作為 field。改動(dòng)點(diǎn)集中在購(gòu)物車的 Service 和攔截器前端代碼不用動(dòng)。這一步要搞懂 Redis 的序列化和過期策略可以在項(xiàng)目里加一套 RedisConfig 來指定 key 的過期時(shí)間。方向二是把頁(yè)面從 JSP 遷到前后端分離。這個(gè)工作量稍大但價(jià)值也最大。先把 Controller 返回值改成RestController返回 JSON再用 Vue 或原生 JS 重寫頁(yè)面。遷移過程中會(huì)踩到跨域問題可以直接在 SpringMVC 里配置 CORS 過濾器解決。這個(gè)改造做完項(xiàng)目就從“課設(shè)”變成了“接口項(xiàng)目”面試時(shí)聊起來也更貼近團(tuán)隊(duì)實(shí)際協(xié)作方式。方向三是在模擬支付接口里增加一個(gè)簡(jiǎn)單的回調(diào)校驗(yàn)。真實(shí)支付最重要的不是頁(yè)面跳轉(zhuǎn)而是后端回調(diào)時(shí)驗(yàn)簽并更新訂單狀態(tài)。教學(xué)項(xiàng)目沒有這一環(huán)你可以模擬一個(gè)回調(diào)地址在控制器里實(shí)現(xiàn)“校驗(yàn)參數(shù) → 改變訂單狀態(tài) → 返回 success”的完整閉環(huán)順便把訂單狀態(tài)機(jī)的代碼捋一遍。養(yǎng)成一個(gè)驗(yàn)證習(xí)慣會(huì)省掉后面很多調(diào)試時(shí)間每次改完訂單相關(guān)邏輯跑一遍“加購(gòu)→下單→支付→查庫(kù)存”的閉環(huán)并在每個(gè)關(guān)鍵方法里加一條日志。我見過太多人以為頁(yè)面跳轉(zhuǎn)到了支付頁(yè)就代表下單成功結(jié)果庫(kù)存和訂單對(duì)不上。給下單方法加一個(gè) AOP 日志切面打印耗時(shí)和訂單號(hào)能快速定位是哪個(gè)環(huán)節(jié)慢。這個(gè)習(xí)慣來自我自己的一次教訓(xùn)當(dāng)時(shí)調(diào)了半天“訂單丟失”最后發(fā)現(xiàn)是事務(wù)方法內(nèi)部調(diào)用了自己代理沒生效。如果你也遇到類似問題先別懷疑業(yè)務(wù)代碼查聲明式事務(wù)的邊界。先跑通再拆開最后改成自己的樣子這條路對(duì)每個(gè)學(xué) JavaWeb 的人都是最快的成長(zhǎng)路徑。希望幫到你。本文還有配套的精品資源點(diǎn)擊獲取