簡(jiǎn)介這是一套基于 Java 實(shí)現(xiàn)的網(wǎng)上書店及書店管理系統(tǒng)課程設(shè)計(jì)資源面向正在準(zhǔn)備畢業(yè)設(shè)計(jì)、課程設(shè)計(jì)或需要 Java Web 項(xiàng)目實(shí)戰(zhàn)的學(xué)習(xí)者。系統(tǒng)分為顧客和管理員兩類角色顧客可注冊(cè)登錄、瀏覽圖書并按圖書類別、名稱、作者三種方式查詢購(gòu)買同時(shí)支持購(gòu)物車、訂單及個(gè)人資料管理管理員則可對(duì)圖書、訂單和用戶信息進(jìn)行查看與增刪改查。前端采用 Vue Bootstrap后端使用 Java Servlet JDBC 連接 SQL Server整體技術(shù)路線典型且完整。資源包共 1664 個(gè)文件約 25.68MB涵蓋 HTML、LESS、JS、CSS 等前端源碼Java、Class 等后端邏輯以及圖片、字體和工程配置文件結(jié)構(gòu)清晰便于導(dǎo)入開發(fā)工具后理解與復(fù)用。目前已有 536 人學(xué)習(xí)下載除項(xiàng)目源碼和項(xiàng)目說(shuō)明外還適合直接作為畢設(shè)/課設(shè)方案使用也可作為 Java 學(xué)習(xí)者對(duì)照實(shí)踐、二次開發(fā)的參考藍(lán)本。1. 網(wǎng)上書店課程設(shè)計(jì)先搞清楚這行字背后的真實(shí)要求很多人在拿到「課程設(shè)計(jì)基于Java實(shí)現(xiàn)的網(wǎng)上書店及書店管理系統(tǒng)源碼項(xiàng)目說(shuō)明.zip」這個(gè)標(biāo)題時(shí)第一反應(yīng)是去找現(xiàn)成的壓縮包解壓、導(dǎo)入IDE、點(diǎn)運(yùn)行然后寫一份報(bào)告交差。但真正動(dòng)手做過(guò)的同學(xué)都知道這個(gè)流程走下來(lái)翻車的概率極高代碼能跑起來(lái)不代表知道怎么講清楚報(bào)告寫得再厚也掩蓋不了核心邏輯沒(méi)有閉環(huán)。這個(gè)題目的本質(zhì)不是「做一個(gè)賣書的網(wǎng)站」而是用Java把兩條業(yè)務(wù)鏈路走通一條是面向讀者的檢索、下單、支付模擬另一條是面向管理員的庫(kù)存、訂單、用戶維護(hù)。兩者共用同一套數(shù)據(jù)庫(kù)和業(yè)務(wù)層區(qū)別只在接口和權(quán)限邊界。這個(gè)題目適合誰(shuí)適合正在修Java課程設(shè)計(jì)、需要一個(gè)能在答辯現(xiàn)場(chǎng)講明白的項(xiàng)目的人也適合想從「跟著視頻敲代碼」過(guò)渡到「自己設(shè)計(jì)表結(jié)構(gòu)和接口」的初學(xué)者。網(wǎng)上書店的難點(diǎn)從來(lái)不在頁(yè)面而在數(shù)據(jù)一致性、狀態(tài)流轉(zhuǎn)、并發(fā)扣庫(kù)存這類平時(shí)上課不太細(xì)講的地方。這篇文章不替你寫代碼但會(huì)把表怎么建、事務(wù)怎么開、參數(shù)怎么調(diào)、哪些地方會(huì)莫名踩坑講透給你一條能復(fù)現(xiàn)、能解釋、能扛住提問(wèn)的完整路徑。2. 技術(shù)選型Servlet還是Spring Boot為什么最終這么定2.1 課程設(shè)計(jì)場(chǎng)景下的三套方案對(duì)比常見的做法是把技術(shù)路線分成三檔。第一檔是純JSPServletJDBC好處是和學(xué)校課程內(nèi)容貼合度最高從HttpServlet到PreparedStatement幾乎就是把課堂代碼放大了一遍老師問(wèn)什么你都能對(duì)上號(hào)。壞處是代碼結(jié)構(gòu)很容易變成「JSP里寫Java、Servlet里拼HTML」的意大利面項(xiàng)目一旦超過(guò)十個(gè)頁(yè)面就難以維護(hù)。第二檔是SSH或SSM這種老框架組合現(xiàn)在越來(lái)越多學(xué)校已經(jīng)不講Struts了除非你確定老師認(rèn)可這條路否則不推薦為了「顯得高級(jí)」去用一套自己都說(shuō)不清原理的東西。第三檔是Spring Boot MyBatis或MyBatis-Plus Thymeleaf這也是我實(shí)際帶課設(shè)時(shí)最常推薦的一條路線。為什么推薦Spring Boot因?yàn)樗钱?dāng)前Java后端崗位面試題里的?？妥鐾赀@個(gè)項(xiàng)目你順手就把依賴注入、自動(dòng)配置、事務(wù)注解這些概念全摸了一遍哪怕學(xué)校不強(qiáng)制要求簡(jiǎn)歷上也能寫。更現(xiàn)實(shí)的理由是Spring Boot內(nèi)嵌Tomcat打包成jar就能跑避免了在本地Tomcat里部署war包時(shí)出現(xiàn)的一堆環(huán)境變量問(wèn)題。MySQL還是H2課設(shè)答辯現(xiàn)場(chǎng)最怕的就是數(shù)據(jù)庫(kù)連不上。H2的內(nèi)存模式雖然零配置但數(shù)據(jù)類型和真實(shí)MySQL有差別而且老師可能會(huì)現(xiàn)場(chǎng)要求看數(shù)據(jù)所以我更建議用MySQL 5.7或8.0把建庫(kù)SQL腳本放進(jìn)項(xiàng)目里答辯前手動(dòng)執(zhí)行一遍即可。2.2 依賴選型與參數(shù)設(shè)置一個(gè)能直接抄的pom.xml無(wú)論你選Spring Boot 2.7還是3.x關(guān)鍵依賴就那幾個(gè)spring-boot-starter-web、spring-boot-starter-thymeleaf、mybatis-spring-boot-starter、mysql-connector-j、lombok。Spring Boot 3.x要求JDK 17如果你機(jī)器上裝的是JDK 8那就老老實(shí)實(shí)用2.7.x不然編譯都過(guò)不去這是一個(gè)最常見的啟動(dòng)失敗原因。下面這段pom.xml是我常用的配置基線parent groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-parent/artifactId version2.7.18/version relativePath/ /parent dependencies dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-web/artifactId /dependency dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-thymeleaf/artifactId /dependency dependency groupIdorg.mybatis.spring.boot/groupId artifactIdmybatis-spring-boot-starter/artifactId version2.3.1/version /dependency !-- 管理端可以使用JSP但一致性考慮建議全用Thymeleaf -- dependency groupIdmysql/groupId artifactIdmysql-connector-j/artifactId scoperuntime/scope /dependency dependency groupIdorg.projectlombok/groupId artifactIdlombok/artifactId optionaltrue/optional /dependency dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-test/artifactId scopetest/scope /dependency /dependencies版本號(hào)這里有兩個(gè)值得注意的點(diǎn)。第一mybatis-spring-boot-starter不要用太老的版本1.x系列和Spring Boot 2.7有兼容性警告直接上2.3.x就好。第二MySQL驅(qū)動(dòng)在Spring Boot 2.7里一般用mysql-connector-j而不是舊的mysql-connector-java后者在某些組合下會(huì)出現(xiàn)時(shí)區(qū)錯(cuò)誤。spring-boot-starter-parent鎖定了驅(qū)動(dòng)版本你不需要專門指定但如果你習(xí)慣手動(dòng)指定版本請(qǐng)確保它至少是8.0.33否則SSL握手報(bào)錯(cuò)會(huì)把你逼瘋。配置文件的重點(diǎn)在application.yml。spring.datasource.url里必須帶useSSLfalse和serverTimezoneAsia/Shanghai這是兩個(gè)缺一不可的參數(shù)。前者解決本機(jī)MySQL沒(méi)有配置SSL證書時(shí)連接被拒的問(wèn)題后者解決Java時(shí)區(qū)與MySQL會(huì)話時(shí)區(qū)不一致導(dǎo)致的時(shí)間錯(cuò)亂問(wèn)題后面避坑章節(jié)會(huì)再細(xì)講。3. 數(shù)據(jù)庫(kù)設(shè)計(jì)把「書店管理系統(tǒng)」拆成六張表的完整建庫(kù)腳本3.1 表結(jié)構(gòu)與字段設(shè)計(jì)用戶、圖書、購(gòu)物車、訂單網(wǎng)上書店的數(shù)據(jù)模型放在任何課程設(shè)計(jì)里都是標(biāo)準(zhǔn)的「用戶-商品-訂單」三元組但大多數(shù)人把它做成了五張互不關(guān)聯(lián)的孤立表導(dǎo)致下單時(shí)邏輯寫在Servlet里連查四張表事務(wù)還不知道怎么開。正確做法是先按業(yè)務(wù)歸屬劃分模塊用戶模塊只關(guān)心user表圖書模塊只關(guān)心book表而訂單模塊需要同時(shí)依賴order和order_item兩張表購(gòu)物車則單獨(dú)用cart表來(lái)保存臨時(shí)狀態(tài)。用戶和地址之間如果急著交作業(yè)不需要單獨(dú)建地址表直接給user表加一個(gè)address字段即可這樣能省去一對(duì)多關(guān)聯(lián)時(shí)要處理的那一堆麻煩。我給出的建表SQL遵循幾條原則主鍵用自增int不用UUID因?yàn)樵谡n設(shè)規(guī)模下UUID白白增加索引存儲(chǔ)和查詢開銷金額字段用decimal(10,2)絕不用float或double避免浮點(diǎn)誤差時(shí)間字段統(tǒng)一datetime由Java側(cè)通過(guò)LocalDateTime傳入不讓MySQL的CURRENT_TIMESTAMP在批量插入時(shí)產(chǎn)生時(shí)區(qū)歧義狀態(tài)字段用tinyint而不是varchar因?yàn)閮?nèi)存占用更小而且Java枚舉映射更自然。下面這段是建庫(kù)腳本的核心部分CREATE DATABASE IF NOT EXISTS bookstore DEFAULT CHARACTER SET utf8mb4; USE bookstore; CREATE TABLE user ( id INT AUTO_INCREMENT PRIMARY KEY, username VARCHAR(50) NOT NULL UNIQUE COMMENT 登錄名, password VARCHAR(100) NOT NULL COMMENT 加密后密碼, nickname VARCHAR(50) DEFAULT COMMENT 顯示昵稱, address VARCHAR(200) DEFAULT COMMENT 默認(rèn)收貨地址, role TINYINT NOT NULL DEFAULT 0 COMMENT 0-普通用戶 1-管理員, create_time DATETIME NOT NULL COMMENT 注冊(cè)時(shí)間 ) ENGINEInnoDB COMMENT用戶表; CREATE TABLE book ( id INT AUTO_INCREMENT PRIMARY KEY, title VARCHAR(100) NOT NULL COMMENT 書名, author VARCHAR(50) NOT NULL COMMENT 作者, price DECIMAL(10,2) NOT NULL COMMENT 定價(jià), stock INT NOT NULL DEFAULT 0 COMMENT 庫(kù)存余量, sales INT NOT NULL DEFAULT 0 COMMENT 累計(jì)銷量, publisher VARCHAR(100) DEFAULT COMMENT 出版社, cover_path VARCHAR(200) DEFAULT COMMENT 封面圖存儲(chǔ)路徑, status TINYINT NOT NULL DEFAULT 1 COMMENT 1-上架 0-下架 ) ENGINEInnoDB COMMENT圖書表;user表里的password字段長(zhǎng)度我預(yù)留到100不是因?yàn)槲掖蛩愦婷魑亩菫榱私oBCrypt加密結(jié)果留空間。很多課設(shè)項(xiàng)目用varchar(20)存密碼答辯時(shí)老師要求展示數(shù)據(jù)庫(kù)直接在Navicat里看到一串明文這是非常掉價(jià)的細(xì)節(jié)。book表的sales字段可以在每次下單成功后通過(guò)事務(wù)更新和stock做聯(lián)動(dòng)。status字段用于下架操作而非物理刪除因?yàn)闅v史訂單關(guān)聯(lián)不能斷。3.2 訂單與訂單明細(xì)為什么必須拆兩張表訂單和訂單明細(xì)一定要拆這是整個(gè)設(shè)計(jì)里最容易被問(wèn)倒的地方。如果不拆一個(gè)訂單包含三本書就要在order表里插三行每一行的總金額還都不一樣查「某用戶的歷史訂單列表」時(shí)會(huì)出現(xiàn)無(wú)數(shù)重復(fù)行更重要的是如果要改訂單狀態(tài)得同時(shí)改三行的狀態(tài)一個(gè)字段漏了數(shù)據(jù)就亂套。拆成兩張表后order表用于記錄一次購(gòu)買行為order_item用于記錄這次行為里的每一本書及其快照信息。快照的意思是下單那一刻的單價(jià)、書名、作者要原樣存進(jìn)明細(xì)表不能通過(guò)book_id去關(guān)聯(lián)查詢否則以后書改了價(jià)歷史訂單的金額也跟著變這在業(yè)務(wù)上是嚴(yán)重錯(cuò)誤。CREATE TABLE orders ( id INT AUTO_INCREMENT PRIMARY KEY, order_no VARCHAR(32) NOT NULL UNIQUE COMMENT 業(yè)務(wù)訂單號(hào), user_id INT NOT NULL COMMENT 下單用戶ID, total_amount DECIMAL(10,2) NOT NULL COMMENT 訂單總金額, status TINYINT NOT NULL DEFAULT 0 COMMENT 0-待支付 1-已支付 2-已發(fā)貨 3-已完成 4-已取消, create_time DATETIME NOT NULL COMMENT 下單時(shí)間, pay_time DATETIME DEFAULT NULL COMMENT 支付時(shí)間, KEY idx_user (user_id) ) ENGINEInnoDB COMMENT訂單主表; CREATE TABLE order_item ( id INT AUTO_INCREMENT PRIMARY KEY, order_id INT NOT NULL COMMENT 所屬訂單ID, book_id INT NOT NULL COMMENT 圖書ID, book_title VARCHAR(100) NOT NULL COMMENT 下單時(shí)書名快照, book_price DECIMAL(10,2) NOT NULL COMMENT 下單時(shí)單價(jià)快照, quantity INT NOT NULL COMMENT 購(gòu)買數(shù)量, KEY idx_order (order_id) ) ENGINEInnoDB COMMENT訂單明細(xì)表;注意order我用的是orders作為表名。order是SQL的關(guān)鍵字直接建表會(huì)報(bào)語(yǔ)法錯(cuò)誤除非你全程加反引號(hào)但那樣寫Mapper XML時(shí)很容易漏所以建表時(shí)避開關(guān)鍵字是最省心的選擇。order_no字段設(shè)計(jì)成varchar(32)業(yè)務(wù)上用于展示給用戶看一般由Java側(cè)生成格式類似20250607153012 用戶ID之類的組合比自增ID更適合復(fù)制到客服對(duì)話框里核對(duì)。3.3 購(gòu)物車與種子數(shù)據(jù)讓系統(tǒng)交付時(shí)不用手動(dòng)造數(shù)購(gòu)物車表是典型的弱實(shí)體它只做兩件事記錄用戶往購(gòu)物車?yán)锓帕四男涗浢勘緯帕藥妆尽art表不需要獨(dú)立主鍵業(yè)務(wù)含義用id自增即可(user_id, book_id)加一個(gè)唯一索引防止同一本書被重復(fù)插入兩行。管理員功能不需要單獨(dú)的表user表里的role字段已經(jīng)區(qū)分了身份管理端頁(yè)面靠攔截器控制訪問(wèn)即可。sales表如果你有時(shí)間可以做沒(méi)有也不影響核心功能因?yàn)閎ook.sales已經(jīng)能支撐「熱銷排行」這個(gè)展示位了。種子數(shù)據(jù)非常重要。你不可能把項(xiàng)目交給老師時(shí)說(shuō)「請(qǐng)先手動(dòng)往數(shù)據(jù)庫(kù)里添加20本書才能看到效果」所以建庫(kù)腳本里一定要包含一段INSERT語(yǔ)句INSERT INTO user (username, password, nickname, role, create_time) VALUES (admin, $2a$10$Eyi7lPwHONlFOT5n1x1K3uJzYVpFKTHJQ8A0Y9qH3XxY8yC7fLq, 管理員, 1, NOW()); INSERT INTO book (title, author, price, stock, sales, publisher, status) VALUES (深入理解Java虛擬機(jī), 周志明, 129.00, 50, 320, 機(jī)械工業(yè)出版社, 1), (Java并發(fā)編程實(shí)戰(zhàn), Brian Goetz, 89.00, 30, 215, 人民郵電出版社, 1), (Spring實(shí)戰(zhàn)第6版, Craig Walls, 108.00, 20, 188, 人民郵電出版社, 1);密碼那一串$2a$10$開頭的字符串是BCrypt加密后的123456對(duì)應(yīng)的明文在項(xiàng)目說(shuō)明文檔里要寫清楚。管理員賬號(hào)的role1在Java側(cè)配合攔截器可以實(shí)現(xiàn)訪問(wèn)控制。種子數(shù)據(jù)不求多每張關(guān)聯(lián)表能覆蓋典型查詢即可比如兩本書、一個(gè)用戶、一筆包含兩個(gè)明細(xì)的訂單這樣你去驗(yàn)證列表、詳情、訂單詳情時(shí)都有現(xiàn)成數(shù)據(jù)可查。4. 核心功能實(shí)現(xiàn)從登錄鑒權(quán)到下單扣庫(kù)存的完整鏈路4.1 登錄與權(quán)限控制攔截器和密碼加密的設(shè)計(jì)細(xì)節(jié)登錄鑒權(quán)在課設(shè)里最常見的寫法是用戶提交表單Servlet查詢數(shù)據(jù)庫(kù)比對(duì)用戶名和密碼比對(duì)成功就把用戶名塞進(jìn)Session。這個(gè)寫法能跑但有兩個(gè)問(wèn)題一是密碼明文存儲(chǔ)在數(shù)據(jù)庫(kù)答辯時(shí)被問(wèn)到「如何防止拖庫(kù)」答不上來(lái)二是Session里只存了用戶名每次查詢用戶信息都得再查一次數(shù)據(jù)庫(kù)。我采用的方案是密碼用BCrypt加密登錄成功后將User對(duì)象整體放入Session業(yè)務(wù)需要用戶信息時(shí)直接取管理員接口通過(guò)HandlerInterceptor統(tǒng)一攔截。Service public class UserServiceImpl implements UserService { private final UserMapper userMapper; // BCryptPasswordEncoder 是 Spring Security 提供的工具單獨(dú)引入即可 private final PasswordEncoder passwordEncoder new BCryptPasswordEncoder(); public User login(String username, String rawPassword) { User user userMapper.findByUsername(username); if (user ! null passwordEncoder.matches(rawPassword, user.getPassword())) { return user; } return null; } }上面這段代碼的邏輯說(shuō)明matches方法負(fù)責(zé)把用戶輸入的明文密碼進(jìn)行同樣的鹽值運(yùn)算然后和數(shù)據(jù)庫(kù)里的哈希結(jié)果比對(duì)全程不需要你手動(dòng)處理鹽。調(diào)用方拿到User對(duì)象后放入Session后續(xù)請(qǐng)求從Session取值即可。要注意的是BCryptPasswordEncoder來(lái)自spring-security-crypto這個(gè)依賴你不想引入全套Spring Security的話單獨(dú)引這個(gè)包就行pom.xml中加依賴即可。攔截器的寫法不展開代碼了核心就一個(gè)preHandle方法判斷當(dāng)前請(qǐng)求的URI是否以/admin開頭如果是則從Session里取user取不到就重定向到登錄頁(yè)取到但role ! 1就返回403提示頁(yè)。這個(gè)邏輯必須在WebMvcConfigurer里注冊(cè)并且要放行登錄接口、靜態(tài)資源、以及圖書列表和詳情這些匿名可訪問(wèn)的頁(yè)面。4.2 圖書檢索與分頁(yè)一套能扛住答辯追問(wèn)的Mapper寫法圖書檢索頁(yè)面是系統(tǒng)里訪客流量最大的地方搜索條件包括書名模糊匹配、作者匹配、價(jià)格區(qū)間、分類如果有還得支持分頁(yè)。很多課設(shè)項(xiàng)目在Service里先select * from book把所有數(shù)據(jù)查出來(lái)然后在內(nèi)存里做過(guò)濾和分頁(yè)這個(gè)做法數(shù)據(jù)量小的時(shí)候看不出問(wèn)題但答辯老師一句「如果有一萬(wàn)本書呢」就會(huì)讓你很難受。正確的做法是在SQL層面完成過(guò)濾和分頁(yè)數(shù)據(jù)庫(kù)只返回當(dāng)前頁(yè)需要的數(shù)據(jù)。select idsearchBooks resultTypecom.example.bookstore.entity.Book SELECT * FROM book where if testkeyword ! null and keyword ! (title LIKE CONCAT(%, #{keyword}, %) OR author LIKE CONCAT(%, #{keyword}, %)) /if if testminPrice ! null AND price gt; #{minPrice} /if if testmaxPrice ! null AND price lt; #{maxPrice} /if AND status 1 /where ORDER BY id DESC LIMIT #{offset}, #{pageSize} /select這里有幾個(gè)細(xì)節(jié)值得跟評(píng)委講清楚。where標(biāo)簽會(huì)自動(dòng)去掉第一個(gè)多余的AND這是MyBatis的動(dòng)態(tài)SQL特性你不需要在XML里手動(dòng)拼接where 11。LIKE模糊查詢必須用CONCAT(%, #{keyword}, %)如果用%${keyword}%用戶輸入一個(gè)%就會(huì)查出全表這是經(jīng)典的SQL注入點(diǎn)。OFFSET的計(jì)算放在Service層完成入?yún)⑹莗ageNum和pageSize在Service里算出offset (pageNum - 1) * pageSize傳入Mapper。LIMIT后面只能用#{}參數(shù)不能直接寫死一個(gè)變量名因?yàn)樗鼤?huì)被當(dāng)作預(yù)編譯參數(shù)處理。4.3 下單與扣庫(kù)存為什么必須用事務(wù)保住數(shù)據(jù)一致性用戶點(diǎn)「提交訂單」按鈕后后端做的事比你表面上看到的多得多先生成訂單號(hào)和訂單主記錄再遍歷購(gòu)物車?yán)锏拿恳豁?xiàng)往order_item插明細(xì)然后更新對(duì)應(yīng)圖書的stock和sales最后清空購(gòu)物車。這四步里任何一步失敗都不能允許前面已經(jīng)執(zhí)行的部分保留下來(lái)。比如插入了訂單主記錄但扣庫(kù)存失敗下次用戶查詢訂單時(shí)就會(huì)看到一筆幽靈訂單。課程設(shè)計(jì)階段不要求你實(shí)現(xiàn)分布式事務(wù)但本地事務(wù)必須用對(duì)也就是在Service方法上加Transactional并把事務(wù)控制放在Service層而不是Controller層。Spring Boot默認(rèn)的事務(wù)管理機(jī)制是遇到RuntimeException或Error時(shí)自動(dòng)回滾遇到受檢異常默認(rèn)不回滾。所以你在業(yè)務(wù)代碼里要養(yǎng)成一個(gè)習(xí)慣數(shù)據(jù)校驗(yàn)失敗時(shí)直接拋出RuntimeException的子類而不是返回false或null讓調(diào)用方判斷。.NET或PHP背景的老師可能會(huì)問(wèn)事務(wù)隔離級(jí)別你可以說(shuō)默認(rèn)用REPEATABLE_READInnoDB的行鎖能保證兩筆并發(fā)下單不會(huì)互相覆蓋庫(kù)存。下面這段代碼展示了下單Service層的核心結(jié)構(gòu)Transactional(rollbackFor Exception.class) public Long createOrder(Long userId, MapLong, Integer cartMap) { // 1. 生成訂單號(hào)時(shí)間戳 隨機(jī)數(shù)避免并發(fā)重復(fù) String orderNo BO System.currentTimeMillis() String.format(%03d, ThreadLocalRandom.current().nextInt(1000)); BigDecimal total BigDecimal.ZERO; for (Map.EntryLong, Integer entry : cartMap.entrySet()) { Book book bookMapper.selectById(entry.getKey()); BigDecimal itemTotal book.getPrice().multiply(BigDecimal.valueOf(entry.getValue())); total total.add(itemTotal); } Orders order new Orders(); order.setOrderNo(orderNo); order.setUserId(userId); order.setTotalAmount(total); order.setStatus(0); // 待支付 order.setCreateTime(LocalDateTime.now()); orderMapper.insert(order); // 2. 插入訂單明細(xì)并扣減庫(kù)存 for (Map.EntryLong, Integer entry : cartMap.entrySet()) { OrderItem item new OrderItem(); item.setOrderId(order.getId()); item.setBookId(entry.getKey()); Book book bookMapper.selectById(entry.getKey()); item.setBookTitle(book.getTitle()); item.setBookPrice(book.getPrice()); item.setQuantity(entry.getValue()); orderItemMapper.insert(item); int updated bookMapper.deductStock(entry.getKey(), entry.getValue()); if (updated 0) { throw new RuntimeException(庫(kù)存不足: book.getTitle()); } } cartMapper.deleteByUserId(userId); return order.getId(); }rollbackFor Exception.class這個(gè)參數(shù)是必須寫的不寫的話默認(rèn)策略只對(duì)RuntimeException生效。數(shù)據(jù)庫(kù)層做一個(gè)deductStock的SQLUPDATE book SET stock stock - #{quantity} WHERE id #{id} AND stock #{quantity}然后判斷影響行數(shù)是否為0為0說(shuō)明庫(kù)存不足直接拋異常觸發(fā)整體回滾。這種寫法天然解決并發(fā)超賣問(wèn)題兩筆請(qǐng)求同時(shí)進(jìn)來(lái)InnoDB行鎖會(huì)串行化這一行第二個(gè)事務(wù)執(zhí)行時(shí)已經(jīng)扣過(guò)一次庫(kù)存條件不滿足就不會(huì)誤扣。這個(gè)方案雖然簡(jiǎn)單卻足以在答辯現(xiàn)場(chǎng)講清楚「樂(lè)觀鎖思路」。4.4 管理端功能圖書上下架與訂單狀態(tài)流轉(zhuǎn)書店管理系統(tǒng)給管理員提供四塊功能圖書列表包含搜索和狀態(tài)篩選、新增/編輯圖書、處理訂單發(fā)貨、完成、取消、查看銷售概況。這里最容易被做成「只寫了增刪改查」而失去管理意義。你要清楚每一項(xiàng)操作背后的業(yè)務(wù)規(guī)則圖書下架不能物理刪除只能把status置為0否則歷史訂單關(guān)聯(lián)查詢時(shí)會(huì)查不到書名訂單狀態(tài)必須是單向流轉(zhuǎn)待支付 - 已支付 - 已發(fā)貨 - 已完成是正向待支付 - 已取消是分支不允許把已發(fā)貨的訂單改回待支付單價(jià)和庫(kù)存可以由管理員編輯但sales字段必須由系統(tǒng)自動(dòng)累加不能手工修改。5. 避坑排查課程設(shè)計(jì)階段最容易翻車的五個(gè)真實(shí)場(chǎng)景5.1 MySQL連接報(bào)錯(cuò)Public Key Retrieval is not allowed報(bào)名時(shí)數(shù)據(jù)庫(kù)連接一直報(bào)這個(gè)錯(cuò)application.yml里用戶名密碼都沒(méi)問(wèn)題Navicat能連但Java連不上而且報(bào)錯(cuò)信息不完整一會(huì)兒說(shuō)SSL握手失敗一會(huì)兒說(shuō)公鑰檢索不允許。這個(gè)問(wèn)題的根源在于MySQL 8.0默認(rèn)使用caching_sha2_password認(rèn)證插件而JDBC驅(qū)動(dòng)在沒(méi)有拿到服務(wù)器公鑰時(shí)不允許發(fā)送加密密碼。解決方法是給MySQL連接URL加上兩個(gè)參數(shù)allowPublicKeyRetrievaltrueuseSSLfalse兩個(gè)缺一不可。前者允許客戶端從服務(wù)器請(qǐng)求公鑰后者避免在本地開發(fā)環(huán)境下走SSL加密通道。這樣改完之后再啟動(dòng)連接就正常了。5.2 時(shí)間字段差8小時(shí)DATETIME和時(shí)區(qū)設(shè)置頁(yè)面顯示的下單時(shí)間和數(shù)據(jù)庫(kù)里查出來(lái)的時(shí)間差了整整8小時(shí)你可能會(huì)懷疑代碼里L(fēng)ocalDateTime.now()有問(wèn)題實(shí)際上代碼沒(méi)問(wèn)題。根本原因是JDBC連接串里沒(méi)有指定時(shí)區(qū)Java側(cè)的LocalDateTime不帶時(shí)區(qū)信息而MySQL的serverTimezone默認(rèn)取系統(tǒng)時(shí)區(qū)如果本機(jī)是UTC寫入時(shí)就會(huì)按UTC轉(zhuǎn)碼。解決方法是把serverTimezoneAsia/Shanghai加進(jìn)JDBC URL同時(shí)檢查MySQL服務(wù)器的time_zone變量是否也設(shè)成了08:00。順便提一個(gè)進(jìn)階點(diǎn)建表時(shí)時(shí)間字段用DATETIME而不用TIMESTAMP因?yàn)門IMESTAMP有2038年問(wèn)題雖然在課設(shè)場(chǎng)景里不會(huì)遇到但這個(gè)問(wèn)題本身可以作為答辯加分項(xiàng)講出來(lái)證明你關(guān)注過(guò)真實(shí)生產(chǎn)環(huán)境。5.3 前端提交表單中文亂碼過(guò)濾器配置位置不對(duì)Spring Boot項(xiàng)目里表單提交中文亂碼最典型的場(chǎng)景是搜索框輸入「深入理解」查不出任何結(jié)果。如果用的是POST提交Spring Boot的CharacterEncodingFilter理論上會(huì)自動(dòng)處理UTF-8編碼但失效的常見原因是你在Controller里手動(dòng)讀取了getParameter()之前沒(méi)有設(shè)置request.setCharacterEncoding(UTF-8)導(dǎo)致容器已經(jīng)按ISO-8859-1解碼了。更隱蔽的情況是你寫了自定義的Filter并且執(zhí)行順序在CharacterEncodingFilter之前那你的過(guò)濾器如果沒(méi)有強(qiáng)制設(shè)置編碼后續(xù)的編碼過(guò)濾器也不會(huì)生效因?yàn)檎?qǐng)求參數(shù)已經(jīng)在你的過(guò)濾器里被讀取過(guò)了。解決思路是不要自定義全局FilterSpring Boot自帶的就夠了如果你真的需要設(shè)置spring.characterEncoding.forcetrue讓編碼過(guò)濾器優(yōu)先執(zhí)行并覆蓋請(qǐng)求和響應(yīng)編碼。5.4org.thymeleaf.exceptions.TemplateInputException模板路徑拼寫問(wèn)題Thymeleaf頁(yè)面渲染時(shí)報(bào)模板找不到提示TemplateInputException而且錯(cuò)誤信息里給出的路徑和你templates目錄下的文件看起來(lái)一模一樣。這個(gè)問(wèn)題的常見原因是Controller返回的視圖名帶上了.html后綴比如return admin/book-list.html而Thymeleaf默認(rèn)的視圖解析器會(huì)拼接前綴classpath:/templates/和后綴.html結(jié)果變成了classpath:/templates/admin/book-list.html.html自然找不到。解決方法是去掉后綴只返回邏輯視圖名admin/book-list。另外要檢查pom.xml里是否引入了spring-boot-starter-thymeleaf如果只引入了spring-boot-starter-web模板引擎根本沒(méi)注冊(cè)返回字符串會(huì)被當(dāng)作普通文本寫到響應(yīng)體里頁(yè)面內(nèi)容看起來(lái)就是一行結(jié)構(gòu)化的字符串。5.5 并發(fā)下單導(dǎo)致的超賣stock #{quantity}條件策略要寫對(duì)在測(cè)試階段你可能用Postman同時(shí)發(fā)兩個(gè)請(qǐng)求下單同一本書最后發(fā)現(xiàn)庫(kù)存被扣成了負(fù)數(shù)。原因是你的扣庫(kù)存SQL寫成了先查在內(nèi)存判斷再執(zhí)行更新。就算在Service層開了事務(wù)兩個(gè)請(qǐng)求同時(shí)讀到庫(kù)存還剩1本各自判斷通過(guò)然后都去更新結(jié)果是兩次更新都成功庫(kù)存變?yōu)榱素?fù)值。正確做法是把判斷條件寫進(jìn)UPDATE語(yǔ)句里即WHERE stock #{quantity}這一條數(shù)據(jù)庫(kù)行鎖會(huì)讓第二個(gè)更新事務(wù)等待第一個(gè)事務(wù)提交后再執(zhí)行此時(shí)庫(kù)存已扣減條件不滿足影響行數(shù)直接為0在MyBatis里映射的結(jié)果就是updated 0再結(jié)合Transactional的回滾機(jī)制整個(gè)訂單創(chuàng)建失敗。這段代碼就是第4章末尾展示的那個(gè)deductStock方法如果你的項(xiàng)目里沒(méi)寫這個(gè)條件趁現(xiàn)在趕緊補(bǔ)上。6. 項(xiàng)目說(shuō)明文檔怎么寫從「源碼壓縮包」到「能答辯的作品」6.1 項(xiàng)目說(shuō)明文檔的目錄結(jié)構(gòu)與每部分必須有的內(nèi)容很多同學(xué)在最后一天才開始寫文檔寫出來(lái)的東西老板看了想退款老師看了想打回。項(xiàng)目說(shuō)明文檔的核心目的不是記錄代碼而是證明你理解了這個(gè)系統(tǒng)的每一個(gè)設(shè)計(jì)決策。一個(gè)推薦的文檔目錄是項(xiàng)目背景與需求分析、技術(shù)架構(gòu)圖與選型理由、數(shù)據(jù)庫(kù)設(shè)計(jì)說(shuō)明含E-R圖和關(guān)鍵表注釋、核心功能實(shí)現(xiàn)說(shuō)明登錄鑒權(quán)、下單事務(wù)、庫(kù)存扣減、測(cè)試方案與測(cè)試用例、部署步驟與運(yùn)行環(huán)境。這個(gè)結(jié)構(gòu)里最容易被忽略的是「測(cè)試方案」但答辯現(xiàn)場(chǎng)老師最愛(ài)問(wèn)的就是「你怎么驗(yàn)證你的系統(tǒng)是對(duì)的」如果你能現(xiàn)場(chǎng)跑一遍測(cè)試用例把輸入、預(yù)期結(jié)果、實(shí)際結(jié)果列成表格分?jǐn)?shù)會(huì)拉開一截。部署步驟這一節(jié)不要只寫「用IDEA打開項(xiàng)目配置數(shù)據(jù)庫(kù)運(yùn)行」要寫清楚JDK版本、Maven版本、MySQL版本、數(shù)據(jù)庫(kù)初始化的命令行或SQL腳本路徑、配置文件里的哪些參數(shù)需要改。例如環(huán)境項(xiàng)要求說(shuō)明JDK1.8或17根據(jù)Spring Boot版本選擇Maven3.6用IDEA自帶Maven也可MySQL5.7或8.0執(zhí)行bookstore.sql初始化端口8080避免和本機(jī)其他服務(wù)沖突6.2 答辯前的驗(yàn)證腳本一條命令測(cè)一個(gè)業(yè)務(wù)閉環(huán)答辯最常見的尷尬是現(xiàn)場(chǎng)演示時(shí)數(shù)據(jù)對(duì)不上或者功能點(diǎn)忘詞了。我習(xí)慣的做法是準(zhǔn)備一個(gè)「業(yè)務(wù)驗(yàn)證順序清單」每一步做什么、預(yù)期看到什么提前在本地跑通兩遍。推薦的順序是管理員登錄進(jìn)入圖書管理新增一本測(cè)試書設(shè)置價(jià)格為19.9、庫(kù)存為5退出管理員注冊(cè)一個(gè)新用戶搜索這本測(cè)試書加入購(gòu)物車數(shù)量改2提交訂單確認(rèn)訂單狀態(tài)為待支付回到管理員后臺(tái)看到訂單金額為39.8、庫(kù)存變?yōu)?點(diǎn)擊發(fā)貨回到用戶端確認(rèn)訂單狀態(tài)變?yōu)橐寻l(fā)貨。這一個(gè)閉環(huán)把你系統(tǒng)的用戶端、管理端、訂單、庫(kù)存全部覆蓋了而且每一步都能對(duì)應(yīng)到數(shù)據(jù)庫(kù)里的數(shù)據(jù)變化。還有一個(gè)容易被忽略的準(zhǔn)備工作把你的項(xiàng)目打成可執(zhí)行jar包在命令行用java -jar跑一遍確認(rèn)靜態(tài)資源和模板引擎都正常加載。很多項(xiàng)目在IDEA里跑得好好的一打包就找不到頁(yè)面原因是模板文件或者M(jìn)apper XML沒(méi)有正確打包進(jìn)jar。檢查target/classes目錄下有沒(méi)有mapper目錄和templates目錄如果沒(méi)有就是pom.xml的resources配置把XML文件排除掉了需要在build里顯式聲明包含。這個(gè)檢查只需要一分鐘但能避免答辯當(dāng)天「現(xiàn)場(chǎng)換了臺(tái)電腦打不開項(xiàng)目」的悲劇。6.3 一個(gè)加分技巧用Logback記錄關(guān)鍵操作日志如果你的項(xiàng)目說(shuō)明文檔里寫了「系統(tǒng)安全性」但是代碼里連一行日志都沒(méi)有老師追問(wèn)時(shí)你很難自圓其說(shuō)。我建議在登錄、下單、支付、發(fā)貨這幾個(gè)核心操作上加上日志輸出使用SLF4J的Logger即可不需要引入額外組件。日志的作用有兩個(gè)一是你自己排查問(wèn)題時(shí)能看清請(qǐng)求參數(shù)和處理結(jié)果二是答辯時(shí)可以現(xiàn)場(chǎng)打開logs/bookstore.log向老師展示「我可以通過(guò)日志追蹤一筆訂單從創(chuàng)建到發(fā)貨的全過(guò)程」。這個(gè)技巧花10分鐘就能做完但呈現(xiàn)出來(lái)的工程素養(yǎng)和一個(gè)「只寫了CRUD的課設(shè)」完全不是一個(gè)段位。private static final Logger log LoggerFactory.getLogger(OrderServiceImpl.class); log.info(用戶[{}]創(chuàng)建訂單訂單號(hào)[{}]總金額[{}]包含{}項(xiàng)明細(xì), userId, orderNo, total, cartMap.size());注意日志里不要打用戶密碼、完整收貨地址這類敏感信息打印訂單號(hào)和金額是沒(méi)有問(wèn)題的。日志文件的大小和保留策略不用刻意配置Spring Boot默認(rèn)的logback-spring.xml配置足夠應(yīng)付課設(shè)場(chǎng)景了。我自己的習(xí)慣是每寫完一個(gè)模塊先跑一遍完整業(yè)務(wù)流打開日志文件確認(rèn)關(guān)鍵步驟都有輸出再寫下一塊這樣最后寫項(xiàng)目說(shuō)明文檔時(shí)測(cè)試記錄是現(xiàn)成的不是臨時(shí)編的。希望這份實(shí)戰(zhàn)拆解能讓你做完的不只是一個(gè)能運(yùn)行的課設(shè)而是一個(gè)能講清楚設(shè)計(jì)決策、能扛住現(xiàn)場(chǎng)提問(wèn)、哪怕以后寫進(jìn)簡(jiǎn)歷也不心虛的作品。本文還有配套的精品資源點(diǎn)擊獲取