1. 救災(zāi)物品捐贈(zèng)系統(tǒng)的定位與技術(shù)框架選擇帶過(guò)不少畢業(yè)設(shè)計(jì)項(xiàng)目的開(kāi)發(fā)者應(yīng)該都有過(guò)一樣的糾結(jié)給學(xué)生推薦題目時(shí)最怕選到那種表面看著挺完整實(shí)際跑起來(lái)一堆問(wèn)題或者只有簡(jiǎn)單增刪改查答辯時(shí)一問(wèn)三不知的“半成品”。Spring Boot救災(zāi)物品捐贈(zèng)系統(tǒng)之所以能成為穩(wěn)定的畢業(yè)設(shè)計(jì)選題是因?yàn)樗臉I(yè)務(wù)不算復(fù)雜但又足夠完整用戶登錄、物品登記、入庫(kù)、庫(kù)存扣減、發(fā)放記錄、統(tǒng)計(jì)報(bào)表幾乎是真實(shí)業(yè)務(wù)系統(tǒng)的濃縮版。把它當(dāng)成畢業(yè)設(shè)計(jì)也好當(dāng)成練手項(xiàng)目也好都能把常見(jiàn)的后端技術(shù)串起來(lái)。這篇內(nèi)容我按一套可以直接拿去做項(xiàng)目的思路來(lái)拆項(xiàng)目該怎么定位、技術(shù)棧怎么選更省事、數(shù)據(jù)庫(kù)表怎么設(shè)計(jì)才不容易在答辯時(shí)被問(wèn)倒、核心代碼到底怎么寫(xiě)以及最重要的部署教程。所有步驟都盡量給到可復(fù)制可執(zhí)行的方案不是只講概念。文章后面還會(huì)把我在多個(gè)項(xiàng)目里遇到的高頻報(bào)錯(cuò)和避坑習(xí)慣整理到一起你照著排查比自己瞎改配置快得多。我之所以特別推薦這個(gè)題材還有一個(gè)原因救災(zāi)捐贈(zèng)系統(tǒng)天然自帶“公益屬性”在畢業(yè)設(shè)計(jì)開(kāi)題和報(bào)告里容易表達(dá)項(xiàng)目?jī)r(jià)值不用硬編造商業(yè)場(chǎng)景。另一方面它的數(shù)據(jù)流也很清晰——物資從捐贈(zèng)人手里進(jìn)來(lái)經(jīng)由系統(tǒng)登記入庫(kù)再通過(guò)發(fā)放流程到達(dá)受助人手中整個(gè)過(guò)程有記錄、有追溯能夠很自然地引入事務(wù)處理、庫(kù)存一致性這些進(jìn)階話題。1.1 這個(gè)系統(tǒng)到底解決什么問(wèn)題先不急著寫(xiě)代碼我們把“捐贈(zèng)”這個(gè)線下場(chǎng)景翻譯成線上系統(tǒng)的需求。假設(shè)有一個(gè)救災(zāi)物資接收點(diǎn)每天會(huì)收到許多箱飲用水、方便食品、帳篷、棉被同時(shí)也會(huì)有當(dāng)?shù)鼐用窕蚯胺骄仍?duì)按需領(lǐng)取物資。如果沒(méi)有系統(tǒng)登記全靠Excel或者手寫(xiě)你就很難回答幾個(gè)基本問(wèn)題現(xiàn)在庫(kù)存還剩多少某批物資收進(jìn)來(lái)多久了誰(shuí)在什么時(shí)候領(lǐng)走了什么是不是有物資積壓或者即將斷貨所以一個(gè)救災(zāi)物品捐贈(zèng)系統(tǒng)的核心是維護(hù)好兩條鏈路。第一條是入庫(kù)鏈路捐贈(zèng)人到場(chǎng)、登記捐贈(zèng)信息、確認(rèn)物資種類(lèi)和數(shù)量、庫(kù)存增加。第二條是出庫(kù)鏈路受助人或救援隊(duì)?wèi){申請(qǐng)來(lái)領(lǐng)取、登記領(lǐng)取人信息和數(shù)量、庫(kù)存減少。兩條鏈路共用同一份“庫(kù)存臺(tái)賬”這就是整個(gè)系統(tǒng)的數(shù)據(jù)中臺(tái)。從這個(gè)角度倒推系統(tǒng)必須包含的角色就很清楚了。管理員負(fù)責(zé)登錄后管理物資分類(lèi)、記錄捐贈(zèng)入庫(kù)、審核并執(zhí)行發(fā)放、查看統(tǒng)計(jì)報(bào)表和發(fā)布公告。普通用戶可以理解為捐贈(zèng)人或領(lǐng)取登記人在多數(shù)教學(xué)項(xiàng)目里只擁有瀏覽和登記申請(qǐng)權(quán)限。很多同學(xué)在這里容易犯一個(gè)錯(cuò)誤就是不區(qū)分角色把所有功能都堆在一起。但答辯時(shí)考官問(wèn)的第一個(gè)問(wèn)題往往就是“你這個(gè)系統(tǒng)的用戶角色是怎么劃分的”所以這一步值得先想明白。1.2 技術(shù)選型怎么選既要能跑通又要能講清楚按照近幾年的畢業(yè)設(shè)計(jì)主流組合我建議用 Spring Boot MyBatis Plus MySQL 這一套頁(yè)面層選服務(wù)端模板渲染或者前后端分離都可以但如果你想省事、少踩部署坑用模板渲染會(huì)更穩(wěn)。為什么推薦 Spring Boot因?yàn)樗鼉?nèi)嵌了 Tomcat開(kāi)發(fā)時(shí)直接在 IDEA 里運(yùn)行一個(gè) main 方法就能訪問(wèn)不需要單獨(dú)配置服務(wù)器也簡(jiǎn)化了部署過(guò)程。Spring Boot 的配置風(fēng)格又是約定大于配置大多數(shù)場(chǎng)景下只需要修改一個(gè) application.yml就能把數(shù)據(jù)庫(kù)、端口、日志都管起來(lái)適合對(duì)底層容器不太熟悉的在校學(xué)生。對(duì)比用 Spring 傳統(tǒng)配置或者 SSM 手寫(xiě) XML 的方式Spring Boot 可以幫你把精力集中在業(yè)務(wù)代碼上而不是和一堆配置文件搏斗。MyBatis Plus 的價(jià)值在于把單表 CRUD 的重復(fù)代碼消滅掉。捐贈(zèng)系統(tǒng)里很多操作仍然是基礎(chǔ)的“查詢物品列表”“按分類(lèi)篩選”“插入一條捐贈(zèng)記錄”如果用原生 MyBatis 寫(xiě)需要維護(hù)大量 XML頁(yè)面做起來(lái)又急又容易出錯(cuò)。MyBatis Plus 自帶 BaseMapper像 selectById、insert、updateById、selectPage 這些方法開(kāi)箱即用能明顯縮短開(kāi)發(fā)周期。這不只是省事的問(wèn)題答辯時(shí)考官看到你能用 ORM 框架干練地處理大部分查詢也是一個(gè)加分點(diǎn)。數(shù)據(jù)庫(kù)方面就選 MySQL 8.0。相比 MySQL 5.78.0 的默認(rèn)編碼和性能表現(xiàn)更好而且學(xué)校機(jī)房、個(gè)人電腦都常見(jiàn)。實(shí)際部署時(shí)只要留意驅(qū)動(dòng)名是 com.mysql.cj.jdbc.Driver以及連接串要帶上 serverTimezone 參數(shù)基本不會(huì)卡在這一步。再說(shuō)一個(gè)很多同學(xué)踩過(guò)的坑到底要不要做前后端分離。我的觀點(diǎn)是如果導(dǎo)師沒(méi)有強(qiáng)制要求畢業(yè)設(shè)計(jì)階段優(yōu)先考慮單體 模板渲染。前后端分離意味著你還要解決跨域問(wèn)題、準(zhǔn)備 Node 環(huán)境、打包前端代碼、把靜態(tài)資源扔到 Nginx對(duì)不熟悉前端工程化的同學(xué)來(lái)說(shuō)這些額外環(huán)節(jié)帶來(lái)的問(wèn)題遠(yuǎn)大于收益。答辯時(shí)間只有十分鐘左右與其花力氣解釋 CORS不如把時(shí)間用在講清楚核心業(yè)務(wù)邏輯上。下面是技術(shù)棧清單和選擇理由可以直接寫(xiě)進(jìn)項(xiàng)目報(bào)告技術(shù)組件版本建議用途和選擇理由Spring Boot2.7.x內(nèi)嵌容器、配置簡(jiǎn)單社區(qū)資料最全MyBatis Plus3.5.x簡(jiǎn)化單表操作分頁(yè)插件很好用MySQL8.0免費(fèi)、穩(wěn)定畢業(yè)設(shè)計(jì)通用數(shù)據(jù)庫(kù)Thymeleaf Bootstrap適配 Spring Boot 2.7服務(wù)端渲染部署簡(jiǎn)單頁(yè)面整潔Lombok隨 Spring Boot 管理省掉實(shí)體類(lèi)的 Getter/Setter 樣板代碼Hutool5.x工具類(lèi)方便像日期處理、隨機(jī)ID都比較省事2. 需求拆解與數(shù)據(jù)庫(kù)表結(jié)構(gòu)設(shè)計(jì)從登錄到統(tǒng)計(jì)技術(shù)棧定下來(lái)之后第二步就是把需求拆成可落地的功能模塊再映射成數(shù)據(jù)庫(kù)表結(jié)構(gòu)。這一步直接決定項(xiàng)目能不能朝著“完整可運(yùn)行”的方向推進(jìn)也決定答辯時(shí)你能不能邏輯清楚地講出系統(tǒng)設(shè)計(jì)思路。2.1 功能模塊拆解每個(gè)模塊解決什么問(wèn)題我習(xí)慣把功能拆成七個(gè)模塊來(lái)看這樣也方便分配開(kāi)發(fā)時(shí)間第一是登錄與權(quán)限模塊。管理員登錄后維護(hù)倉(cāng)庫(kù)數(shù)據(jù)游客或普通用戶只能瀏覽公開(kāi)公告和物資動(dòng)態(tài)。這個(gè)模塊雖然代碼量不大但它決定了系統(tǒng)的訪問(wèn)邊界是答辯時(shí)一定會(huì)被問(wèn)到的安全問(wèn)題。第二是公告管理模塊。用于發(fā)布物資需求公告或捐贈(zèng)感謝信息一般是管理員編輯、發(fā)布前臺(tái)展示列表和詳情。部分畢業(yè)設(shè)計(jì)會(huì)把這個(gè)模塊做成簡(jiǎn)單的富文本編輯但考慮到部署精力用普通文本域配合數(shù)據(jù)庫(kù)字段存儲(chǔ)就足夠。第三是物資分類(lèi)模塊。衣物、食品、醫(yī)療用品、日常用品等通過(guò)分類(lèi)表維護(hù)一個(gè)層級(jí)即可不需要做無(wú)限級(jí)分類(lèi)省得把復(fù)雜度抬到自己頭上。第四是庫(kù)存臺(tái)賬模塊。這是系統(tǒng)的核心主數(shù)據(jù)記錄物資名稱(chēng)、規(guī)格、單位、總?cè)霂?kù)量、剩余可發(fā)放量。所有入出庫(kù)操作最終都要落到這張表上。第五是捐贈(zèng)入庫(kù)模塊。記錄捐贈(zèng)人姓名、聯(lián)系方式、捐贈(zèng)物資、數(shù)量和時(shí)間。業(yè)務(wù)上要同時(shí)寫(xiě)入捐贈(zèng)記錄和更新庫(kù)存臺(tái)賬必須用事務(wù)保證一致性。第六是領(lǐng)取發(fā)放模塊。記錄受助人或受助單位、領(lǐng)取物品、數(shù)量和時(shí)間。同樣要更新庫(kù)存并且在庫(kù)存不足時(shí)要能給出明確提示。第七是統(tǒng)計(jì)報(bào)表模塊。按日、按月或按物資分類(lèi)展示入庫(kù)量和發(fā)放量通常用聚合查詢實(shí)現(xiàn)提供給管理員用于決策展示。答辯時(shí)這一塊的截圖最有說(shuō)服力因?yàn)樗庇^顯示了系統(tǒng)的“數(shù)據(jù)能力”。每一塊模塊都不大但組合起來(lái)就是一個(gè)完整的業(yè)務(wù)閉環(huán)。開(kāi)發(fā)順序上我建議先做登錄權(quán)限再做物資分類(lèi)和庫(kù)存臺(tái)賬然后是入庫(kù)、出庫(kù)最后補(bǔ)上公告和統(tǒng)計(jì)。如果先做花哨的公告頁(yè)面再回頭補(bǔ)庫(kù)存邏輯很容易出現(xiàn)功能半天搭不起來(lái)、數(shù)據(jù)卻沒(méi)有閉環(huán)的尷尬情況。2.2 數(shù)據(jù)庫(kù)表怎么設(shè)計(jì)最小閉環(huán)的 7 張表數(shù)據(jù)庫(kù)設(shè)計(jì)是畢業(yè)設(shè)計(jì)答辯的重頭戲我不建議直接套一個(gè)五六十張字段的復(fù)雜表結(jié)構(gòu)應(yīng)該用最小閉環(huán)的方式把每個(gè)表的存在必要性講清楚。我們需要的核心表大概有7張結(jié)構(gòu)和作用如下表名核心字段作用userid, username, password, real_name, phone, role系統(tǒng)用戶表區(qū)分管理員與普通用戶categoryid, name, sort物資分類(lèi)表如食品類(lèi)、衣物類(lèi)itemid, category_id, name, spec, unit, total_quantity, remain_quantity庫(kù)存臺(tái)賬表記錄每個(gè)物資的出入庫(kù)累計(jì)數(shù)donation_recordid, item_id, quantity, donor_name, donor_phone, donate_time, remark捐贈(zèng)入庫(kù)記錄表receive_recordid, item_id, quantity, receiver_name, receiver_phone, receive_time, remark領(lǐng)取發(fā)放記錄表announcementid, title, content, create_time公告表system_logid, user_id, action, detail, create_time操作日志表記錄關(guān)鍵動(dòng)作可選但推薦這里重點(diǎn)說(shuō)一下 item 表。很多同學(xué)容易把庫(kù)存直接放在 donation_record 或者 receive_record 里靠 SQL 臨時(shí)算這樣不是不行但每次查詢都要把所有歷史記錄重新聚合數(shù)據(jù)量大之后會(huì)越來(lái)越慢而且很難保證并發(fā)下的準(zhǔn)確性。更好的方式是在 item 表里維護(hù)兩個(gè)累計(jì)字段total_quantity 表示歷史累計(jì)入庫(kù)remain_quantity 表示當(dāng)前剩余可發(fā)放量。每次入庫(kù)就在事務(wù)里“總庫(kù)存加、剩余加”每次出庫(kù)就在事務(wù)里“剩余減”并且查一下剩余是否夠用。這種設(shè)計(jì)在業(yè)務(wù)上可以簡(jiǎn)單理解為“臺(tái)賬 流水”的模式流水記錄事件臺(tái)賬保存最終狀態(tài)兩者相互印證是數(shù)據(jù)庫(kù)設(shè)計(jì)里很常見(jiàn)的思路。其他表之間的關(guān)系并不復(fù)雜。捐贈(zèng)記錄表通過(guò) item_id 關(guān)聯(lián)到庫(kù)存臺(tái)賬領(lǐng)取記錄表也一樣。這樣的好處是以后按物資名稱(chēng)篩選所有入庫(kù)或出庫(kù)流水只需要從記錄表帶條件查不需要冗余存儲(chǔ)物資描述減少了數(shù)據(jù)不一致的風(fēng)險(xiǎn)。公告表相對(duì)獨(dú)立用來(lái)做信息展示。操作日志表雖然很多同學(xué)嫌麻煩不做但加上之后在答辯現(xiàn)場(chǎng)可以演示“任何關(guān)鍵操作都有日志可查”這往往是評(píng)委比較認(rèn)可的一個(gè)亮點(diǎn)。建表腳本的編碼統(tǒng)一用 utf8mb4排序規(guī)則用 utf8mb4_general_ci這樣才能保證頁(yè)面上填的中文備注不亂碼。主鍵使用自增 ID時(shí)間字段用 datetime金額相關(guān)的字段如果以后擴(kuò)展一定要用 decimal這里沒(méi)有金額字段庫(kù)存數(shù)量使用 int 就可以了。3. 核心業(yè)務(wù)代碼實(shí)現(xiàn)登錄鑒權(quán)、庫(kù)存事務(wù)與統(tǒng)計(jì)查詢模塊拆完、表結(jié)構(gòu)也定好了接下來(lái)就是把代碼主框架搭起來(lái)。我建議不要一上來(lái)就悶頭寫(xiě)業(yè)務(wù)先把項(xiàng)目骨架跑起來(lái)確認(rèn)和數(shù)據(jù)庫(kù)的連接是通的再按模塊一個(gè)一個(gè)填充。3.1 登錄鑒權(quán)和訪問(wèn)控制一個(gè)攔截器就能搞定很多畢業(yè)設(shè)計(jì)喜歡引入 Spring Security 或 Sa-Token這當(dāng)然沒(méi)問(wèn)題但如果時(shí)間緊張用 Spring Boot 原生的攔截器加 Session 也完全足夠。核心思路是用戶登錄成功后把用戶信息寫(xiě)入 Session同時(shí)添加一個(gè)攔截器判斷每個(gè)請(qǐng)求是否能找到已登錄的 Session如果找不到就跳轉(zhuǎn)到登錄頁(yè)。這里給你一份可以直接照著寫(xiě)的攔截器代碼Component public class LoginInterceptor implements HandlerInterceptor { Override public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws IOException { // 允許登錄接口直接訪問(wèn) if (request.getRequestURI().contains(/login)) { return true; } Object user request.getSession().getAttribute(loginUser); if (user null) { // 前端頁(yè)面訪問(wèn)時(shí)重定向到登錄頁(yè)接口訪問(wèn)時(shí)返回 401 response.setStatus(401); response.sendRedirect(/login); return false; } return true; } }再寫(xiě)一個(gè)配置類(lèi)把攔截器注冊(cè)到指定路徑上Configuration public class WebConfig implements WebMvcConfigurer { Resource private LoginInterceptor loginInterceptor; Override public void addInterceptors(InterceptorRegistry registry) { registry.addInterceptor(loginInterceptor) .addPathPatterns(/**) .excludePathPatterns(/login, /css/**, /js/**, /img/**); } }登錄 Controller 里只需要做一件事用用戶名和密碼去查 user 表密碼校驗(yàn)通過(guò)后把對(duì)象放入 Session。密碼記得加密存儲(chǔ)不要用明文?？梢赃x BCrypt也可以在畢業(yè)設(shè)計(jì)里用 MD5 加鹽雖然沒(méi)有 BCrypt 安全但只要在報(bào)告里講清楚你做了加鹽處理也比明文強(qiáng)很多。3.2 捐贈(zèng)入庫(kù)和領(lǐng)取發(fā)放事務(wù)與原子更新這一塊是整個(gè)系統(tǒng)的技術(shù)核心也是畢業(yè)答辯時(shí)最值得展開(kāi)的點(diǎn)。捐贈(zèng)入庫(kù)的流程是接收一條入庫(kù)請(qǐng)求包含物資 ID 和入庫(kù)數(shù)量然后完成兩件事在 donation_record 表插入流水更新 item 表的 total_quantity 和 remain_quantity。兩個(gè)操作必須同時(shí)成功或者同時(shí)失敗所以要用 Transactional 注解。但是事務(wù)不能只解決一致性問(wèn)題還面臨另一個(gè)隱藏坑并發(fā)扣減。如果你先查詢剩余庫(kù)存判斷數(shù)量夠不夠再執(zhí)行更新在兩個(gè)用戶同時(shí)領(lǐng)取時(shí)可能兩個(gè)請(qǐng)求都讀到“剩余還有 100”然后各自扣 10最后庫(kù)存變成了 90 而不是 80。這種問(wèn)題在演示環(huán)境不一定暴露但一旦面試官問(wèn)到“你如何保證庫(kù)存不超發(fā)”答不上來(lái)就會(huì)很尷尬。正確的做法是使用帶條件的 SQL 原子更新示例代碼如下Transactional(rollbackFor Exception.class) public void receiveItem(ReceiveRequest request) { // 原子扣減庫(kù)存如果剩余庫(kù)存不足更新行數(shù)為0 int updated itemMapper.deductStock(request.getItemId(), request.getQuantity()); if (updated 0) { throw new BizException(庫(kù)存不足或物資不存在); } ReceiveRecord record new ReceiveRecord(); record.setItemId(request.getItemId()); record.setQuantity(request.getQuantity()); record.setReceiverName(request.getReceiverName()); record.setReceiverPhone(request.getReceiverPhone()); record.setReceiveTime(LocalDateTime.now()); receiveRecordMapper.insert(record); }對(duì)應(yīng)的 Mapper 寫(xiě)法是Update(UPDATE item SET remain_quantity remain_quantity - #{quantity}, total_quantity total_quantity WHERE id #{itemId} AND remain_quantity #{quantity}) int deductStock(Param(itemId) Long itemId, Param(quantity) Integer quantity);注意這里的關(guān)鍵是 WHERE 條件里帶上了 remain_quantity #{quantity}。數(shù)據(jù)庫(kù)在每次更新時(shí)會(huì)自動(dòng)檢查剩余庫(kù)存如果條件不滿足影響行數(shù)就是 0代碼里再根據(jù) updated 數(shù)量拋異常并回滾。入庫(kù)邏輯也是類(lèi)似的對(duì)稱(chēng)代碼只是把扣減換成增加并且多更新一個(gè) total_quantity 字段而已。這段代碼看起來(lái)不多但它能同時(shí)解決三個(gè)問(wèn)題事務(wù)一致性、并發(fā)安全、庫(kù)存不足提示。在答辯時(shí)講這三層邏輯比說(shuō)什么“我用了事務(wù)”要具體得多。3.3 分頁(yè)和統(tǒng)計(jì)讓頁(yè)面有真實(shí)數(shù)據(jù)可用畢業(yè)設(shè)計(jì)非常容易犯的毛病是頁(yè)面上的列表只有幾條測(cè)試數(shù)據(jù)而且沒(méi)有分頁(yè)。一個(gè)正常的系統(tǒng)數(shù)據(jù)量上來(lái)之后列表必須分頁(yè)。MyBatis Plus 自帶分頁(yè)插件配置一個(gè)攔截器就可以使用 selectPage 方法這里不再重復(fù)完整配置代碼但有一個(gè)容易被忽略的小問(wèn)題分頁(yè)查詢最好帶上排序條件比如按創(chuàng)建時(shí)間倒序否則相同數(shù)據(jù)分布在不同頁(yè)時(shí)會(huì)顯得很亂。統(tǒng)計(jì)模塊也是很多同學(xué)頭疼的地方。最簡(jiǎn)單的實(shí)現(xiàn)是寫(xiě)一個(gè) Mapper 聚合查詢按日期分組統(tǒng)計(jì)每天入庫(kù)總量和發(fā)放總量。下面的 SQL 可以作為參考select idselectReceiveStatistics resultTypemap SELECT DATE(receive_time) AS stat_date, SUM(quantity) AS total_quantity FROM receive_record GROUP BY DATE(receive_time) ORDER BY stat_date DESC /select同樣的思路也可以統(tǒng)計(jì)捐贈(zèng)排行、物資分類(lèi)占比。前端用一個(gè)簡(jiǎn)單的 echarts 或者 Chart.js 就能把圖表畫(huà)出來(lái)。如果你是做服務(wù)端模板渲染也可以只把聚合數(shù)據(jù)渲染到表格里都能達(dá)到效果。這里的原則是報(bào)表的數(shù)據(jù)不要造假要讓報(bào)表和庫(kù)存表的數(shù)據(jù)對(duì)得上否則現(xiàn)場(chǎng)演示時(shí)很容易被仔細(xì)的評(píng)委抓到漏洞。4. 從零部署到完整運(yùn)行Spring Boot項(xiàng)目部署教程這一章才是很多人最關(guān)心的部分。代碼寫(xiě)得再好跑不起來(lái)等于零。部署整體可以分為三步本地環(huán)境準(zhǔn)備、數(shù)據(jù)庫(kù)初始化、項(xiàng)目啟動(dòng)和打包運(yùn)行。每一步都不難但順序和細(xì)節(jié)很重要。4.1 本地開(kāi)發(fā)環(huán)境準(zhǔn)備JDK、Maven、MySQL我推薦使用 JDK 1.8 搭配 Spring Boot 2.7.x兼容性最好。如果你電腦裝的是 JDK 17也可以用但要注意部分老版本 Mysql 驅(qū)動(dòng)或者 Lombok 版本可能不兼容最好按我表格里的版本準(zhǔn)備。軟件版本建議備注JDK1.8 或 11安裝后檢查 java -versionMaven3.6.3 或更高IDEA 自帶也可以但建議單獨(dú)安裝MySQL8.0安裝時(shí)選擇密碼記住賬號(hào)和密碼IDEA任意較新版本Ultimate 或 Community 均可Maven 依賴(lài)下載慢是新手最常見(jiàn)的痛點(diǎn)解決辦法是在 Maven 的 settings.xml 里配置一個(gè)國(guó)內(nèi)鏡像源例如在 mirrors 節(jié)點(diǎn)加入一個(gè)可用的鏡像地址。這個(gè)動(dòng)作雖然簡(jiǎn)單但能顯著減少導(dǎo)入項(xiàng)目時(shí)的等待時(shí)間和失敗率。數(shù)據(jù)庫(kù)方面安裝完成后建議把編碼設(shè)置成 utf8mb4。創(chuàng)建數(shù)據(jù)庫(kù)時(shí)可以使用命令行也可以使用 Navicat 等圖形工具。命令如下CREATE DATABASE IF NOT EXISTS rescue_donation DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;4.2 初始化數(shù)據(jù)庫(kù)和修改 application.yml 配置拿到源碼后第一步不是直接啟動(dòng)而是先把項(xiàng)目里的 SQL 腳本跑一遍。通常源碼包里會(huì)有一個(gè) schema.sql 或者 init.sql里面包含了建表語(yǔ)句以及初始數(shù)據(jù)。這個(gè)腳本要在數(shù)據(jù)庫(kù)里完整執(zhí)行最好直接先刪掉舊表再重建這樣可以避免重復(fù)執(zhí)行導(dǎo)致字段沖突。執(zhí)行完后打開(kāi)項(xiàng)目的 src/main/resources/application.yml核心要改的就是數(shù)據(jù)源配置。下面是一個(gè)通用模板server: port: 8080 spring: datasource: driver-class-name: com.mysql.cj.jdbc.Driver url: jdbc:mysql://localhost:3306/rescue_donation?useUnicodetruecharacterEncodingutf8useSSLfalseserverTimezoneAsia/ShanghaiallowPublicKeyRetrievaltrue username: root password: 你的數(shù)據(jù)庫(kù)密碼 jackson: date-format: yyyy-MM-dd HH:mm:ss time-zone: GMT8 mybatis-plus: configuration: log-impl: org.apache.ibatis.logging.stdout.StdOutImpl map-underscore-to-camel-case: true這里有幾個(gè)細(xì)節(jié)值得強(qiáng)調(diào)。第一url 中的 serverTimezone 必須設(shè)置否則高版本 MySQL 驅(qū)動(dòng)會(huì)報(bào)時(shí)區(qū)錯(cuò)誤。第二allowPublicKeyRetrieval 在 MySQL 8 的某些連接方式下需要設(shè)置為 true。第三日志配置里的 StdOutImpl 適合在開(kāi)發(fā)時(shí)看 SQL 語(yǔ)句但生產(chǎn)環(huán)境建議去掉或改成 slf4j避免日志刷屏。4.3 IDEA啟動(dòng)與生產(chǎn)環(huán)境打包運(yùn)行本地啟動(dòng)非常簡(jiǎn)單用 IDEA 導(dǎo)入源碼后找到標(biāo)注了 SpringBootApplication 的啟動(dòng)類(lèi)右鍵運(yùn)行。啟動(dòng)日志里出現(xiàn)“Started Application in x.xxx seconds”之后瀏覽器訪問(wèn) http://localhost:8080就能看到系統(tǒng)登錄頁(yè)。第一次運(yùn)行如果連不上數(shù)據(jù)庫(kù)優(yōu)先檢查三處MySQL 服務(wù)有沒(méi)有啟動(dòng)、密碼是否正確、庫(kù)名是否和配置里一致。如果沒(méi)有美化頁(yè)面就直接顯示白屏或 404大概率是模板文件放錯(cuò)了位置。Spring Boot 的 Thymeleaf 模板需要放在 src/main/resources/templates 目錄靜態(tài)資源放在 static 目錄千萬(wàn)不要把頁(yè)面放在根目錄或者 Java 包目錄里否則無(wú)法被掃描到。線上部署時(shí)我們要先打成 jar 包。在項(xiàng)目根目錄執(zhí)行mvn clean package -DskipTests執(zhí)行成功之后target 目錄下會(huì)出現(xiàn)一個(gè)類(lèi)似 rescue-donation-0.0.1-SNAPSHOT.jar 的文件。把 jar 包上傳到服務(wù)器在 jar 包同級(jí)目錄下運(yùn)行nohup java -jar rescue-donation-0.0.1-SNAPSHOT.jar app.log 21 這樣項(xiàng)目就在后臺(tái)運(yùn)行了。如果要看日志執(zhí)行 tail -f app.log 即可。停止項(xiàng)目時(shí)用 jps 找到進(jìn)程號(hào)再執(zhí)行 kill 命令。生產(chǎn)環(huán)境如果服務(wù)器有防火墻還需要記得在安全組里放行 8080 端口否則外部訪問(wèn)不到。5. 常見(jiàn)問(wèn)題排查與畢業(yè)設(shè)計(jì)答辯避坑經(jīng)驗(yàn)這一部分我整理了一份高頻問(wèn)題速查表很多是我在帶學(xué)生項(xiàng)目時(shí)反復(fù)遇到的真實(shí)場(chǎng)景。如果啟動(dòng)失敗或頁(yè)面異常先不要急著改代碼對(duì)著表格一步步排查通常能節(jié)省一晚上的調(diào)試時(shí)間。5.1 高頻報(bào)錯(cuò)速查表啟動(dòng)失敗和接口報(bào)錯(cuò)報(bào)錯(cuò)或現(xiàn)象可能原因解決方案java.sql.SQLException: Access denied for user數(shù)據(jù)庫(kù)賬號(hào)密碼錯(cuò)誤檢查 application.yml 中的 username/passwordCommunications link failureMySQL 服務(wù)未啟動(dòng)或端口不對(duì)啟動(dòng) MySQL檢查端口是否是 3306Unknown database數(shù)據(jù)庫(kù)沒(méi)創(chuàng)建先執(zhí)行建庫(kù)語(yǔ)句再執(zhí)行 schema.sqlPort 8080 was already in use本地端口被占用換端口或結(jié)束占用進(jìn)程netstat -ano 查 PID再 taskkillWhitelabel Error Page頁(yè)面路徑?jīng)]匹配到 Controller檢查控制器映射和 templates 目錄結(jié)構(gòu)java.lang.ClassNotFoundException: com.mysql.jdbc.Driver驅(qū)動(dòng)類(lèi)名寫(xiě)錯(cuò)MySQL 8 用 com.mysql.cj.jdbc.Driver頁(yè)面中文亂碼編碼不一致數(shù)據(jù)庫(kù)連接串加 characterEncodingutf8表結(jié)構(gòu)用 utf8mb4Thymeleaf 模板打不開(kāi)模板放錯(cuò)目錄確認(rèn)放在 src/main/resources/templates 下mvn 命令找不到Maven 未配置環(huán)境變量配置 MAVEN_HOME或用 IDEA 內(nèi)建 Maven靜態(tài)資源 404路徑或目錄不對(duì)靜態(tài)資源放 static 目錄路徑不要帶 static 前綴如果你第一次導(dǎo)入項(xiàng)目就出現(xiàn)大量依賴(lài)報(bào)紅多半是 Maven 沒(méi)有下載完依賴(lài)。這時(shí)候優(yōu)先檢查網(wǎng)絡(luò)狀態(tài)和鏡像配置然后在 IDEA 里打開(kāi) Maven 面板點(diǎn)擊刷新按鈕重新導(dǎo)入。不要急著反復(fù)重裝環(huán)境越重裝越亂。5.2 答辯演示和源碼講解的5個(gè)建議項(xiàng)目能跑起來(lái)了最后一步就是答辯現(xiàn)場(chǎng)。很多同學(xué)代碼寫(xiě)得好但演示時(shí)卻容易緊張地說(shuō)不出設(shè)計(jì)思路。我根據(jù)自己的經(jīng)驗(yàn)給幾個(gè)比較實(shí)在的建議。第一演示數(shù)據(jù)提前準(zhǔn)備好。給你的系統(tǒng)放一批看起來(lái)真實(shí)但又不容易混淆的數(shù)據(jù)比如 50 箱礦泉水、20 頂帳篷、30 件棉衣。演示捐贈(zèng)入庫(kù)時(shí)輸入一個(gè)數(shù)量然后立刻切到庫(kù)存列表指明庫(kù)存數(shù)字的變化。演示領(lǐng)取發(fā)放時(shí)先故意輸入一個(gè)超大數(shù)量讓系統(tǒng)提示庫(kù)存不足這比反復(fù)強(qiáng)調(diào)“我做了異常處理”更有說(shuō)服力。第二核心代碼你要能不看文檔講出來(lái)。答辯時(shí)評(píng)委最?lèi)?ài)問(wèn)的就是庫(kù)存扣減怎么保證安全、事務(wù)加在哪里、為什么用這個(gè)設(shè)計(jì)。我建議你把 3.2 節(jié)那段 deductStock 的 SQL 背熟講明白“剩余庫(kù)存作為更新條件”的原理這幾乎是全局最亮眼的技術(shù)點(diǎn)。第三把數(shù)據(jù)庫(kù)表關(guān)系圖打印出來(lái)或者放在 PPT 里。現(xiàn)場(chǎng)畫(huà)表太費(fèi)時(shí)間提前準(zhǔn)備好一張簡(jiǎn)潔的表關(guān)系圖講表設(shè)計(jì)時(shí)鼠標(biāo)一指就能展示出你的全局設(shè)計(jì)能力。第四日志和操作記錄千萬(wàn)不要?jiǎng)h。比如系統(tǒng)里有操作日志表演示前可以先查一下 log 表給大家看剛才入庫(kù)的記錄已經(jīng)自動(dòng)寫(xiě)入。小細(xì)節(jié)越真實(shí)整體可信度越高。第五不要背太多項(xiàng)目背景的套話。答辯時(shí)間有限重點(diǎn)永遠(yuǎn)是“你做了什么、怎么做的、遇到什么難點(diǎn)、怎么解決”。講清楚 2 到 3 個(gè)難點(diǎn)和對(duì)應(yīng)的解決方案比把功能列表念一遍要有效得多。如果你能把“為什么選服務(wù)端渲染而不是前后端分離”、“為什么庫(kù)存要維護(hù)累計(jì)字段”這些點(diǎn)講出理由評(píng)委對(duì)項(xiàng)目的接受度會(huì)明顯更高。我個(gè)人在做這類(lèi)項(xiàng)目時(shí)最后還會(huì)做一件事把整個(gè) MySQL 數(shù)據(jù)庫(kù)導(dǎo)出一份備份腳本保存到源碼包的 sql 目錄里。這樣不管項(xiàng)目拷到哪臺(tái)電腦只要執(zhí)行一份 SQL再改一下數(shù)據(jù)庫(kù)密碼項(xiàng)目就能完整跑起來(lái)。這個(gè)習(xí)慣雖說(shuō)只是舉手之勞但在畢業(yè)設(shè)計(jì)交接、項(xiàng)目歸檔、甚至以后想放簡(jiǎn)歷項(xiàng)目鏈接時(shí)都會(huì)讓整個(gè)交付顯得專(zhuān)業(yè)很多。