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