簡(jiǎn)介一套基于Java技術(shù)實(shí)現(xiàn)的菜鳥驛站快遞分發(fā)管理系統(tǒng)面向計(jì)算機(jī)專業(yè)畢業(yè)設(shè)計(jì)或課程設(shè)計(jì)人群可用于快速搭建演示項(xiàng)目或作為二次開發(fā)基線。資源圍繞用戶下單、快件入庫(kù)、取件、物流跟蹤等典型業(yè)務(wù)場(chǎng)景完整覆蓋了需求分析、總體設(shè)計(jì)、詳細(xì)設(shè)計(jì)及功能測(cè)試等環(huán)節(jié)涉及前端頁(yè)面、后端邏輯與數(shù)據(jù)庫(kù)交互。壓縮包內(nèi)共385個(gè)文件以111個(gè)Java源文件、20個(gè)XML配置、2個(gè)SQL數(shù)據(jù)庫(kù)腳本為主體同時(shí)集成162個(gè)SVG圖標(biāo)、16個(gè)JS及13個(gè)PNG前端資源并附有BAT構(gòu)建腳本和環(huán)境配置說明整體僅10.65MB部署輕量。項(xiàng)目?jī)?nèi)置1-install.bat、2-run.bat、3-build.bat等自動(dòng)化腳本結(jié)合清晰目錄分層可快速啟動(dòng)并觀察系統(tǒng)運(yùn)行效果無需復(fù)雜環(huán)境調(diào)試。已有832人學(xué)習(xí)適合希望參考完整管理系統(tǒng)源碼、掌握J(rèn)avaWeb工程化開發(fā)步驟的在校生與初級(jí)開發(fā)者。1. 拿到zip之后菜鳥驛站快遞分發(fā)系統(tǒng)到底是個(gè)什么畢設(shè)很多人拿到這類zip第一反應(yīng)是解壓然后找“論文”或“使用說明”這個(gè)動(dòng)作不算錯(cuò)但更該先想清楚標(biāo)題里的“菜鳥驛站”是業(yè)務(wù)場(chǎng)景“快遞分發(fā)系統(tǒng)”是軟件類型“計(jì)算機(jī)畢業(yè)生設(shè)計(jì)”是使用場(chǎng)景zip只是交付形式。把它組合起來就是一套典型的Web畢設(shè)管理員后臺(tái)負(fù)責(zé)快遞入庫(kù)、生成取件碼、處理逾期用戶端負(fù)責(zé)憑手機(jī)號(hào)和取件碼取件。它出現(xiàn)在畢業(yè)生手里是因?yàn)闃I(yè)務(wù)邊界清楚、能落地的功能點(diǎn)夠多、演示又直觀屬于萬能選題里比較討巧的一種。這套系統(tǒng)值不值得往深做取決于你怎么回答三個(gè)問題包裹從進(jìn)站到出庫(kù)的狀態(tài)在系統(tǒng)里怎么流轉(zhuǎn)取件碼如何生成、如何保證不重復(fù)逾期件和統(tǒng)計(jì)報(bào)表怎么在不堆功能的前提下自圓其說。這篇筆記按“業(yè)務(wù)設(shè)計(jì)—核心流程—工程改造—部署避坑—答辯自檢”的順序把能直接照著改的做法寫清楚新手跟得上熟手能直接拿去當(dāng)checklist。2. 先別寫代碼快遞狀態(tài)機(jī)與六張核心表的設(shè)計(jì)很多人拿到zip就直接mvn spring-boot:run跑是能跑但答辯老師一問“你這套系統(tǒng)的核心狀態(tài)是怎么設(shè)計(jì)的”就卡殼。這類項(xiàng)目看起來功能多本質(zhì)只有一個(gè)核心業(yè)務(wù)包裹到達(dá)驛站后如何入庫(kù)、暫存、被取走以及在這個(gè)過程里如何把狀態(tài)和動(dòng)作留在數(shù)據(jù)庫(kù)里。這一章先把業(yè)務(wù)拆成一個(gè)狀態(tài)機(jī)再落到表結(jié)構(gòu)上后面寫代碼才不翻車。2.1 三個(gè)角色、六種狀態(tài)把業(yè)務(wù)流程變成數(shù)據(jù)流轉(zhuǎn)先分清角色。菜鳥驛站快遞分發(fā)系統(tǒng)里通常有三類使用者快遞員或入庫(kù)員負(fù)責(zé)把包裹錄入系統(tǒng)、打印/生成取件碼、放到貨架站內(nèi)管理員負(fù)責(zé)處理逾期、異常退回、看統(tǒng)計(jì)報(bào)表用戶憑手機(jī)號(hào)和取件碼取件。常見實(shí)現(xiàn)里快遞員和管理員共用一張admin表用role字段區(qū)分前端少一套登錄頁(yè)面后端也能少寫一套登錄過濾器答辯時(shí)講“按角色收斂權(quán)限”反而更好說。角色核心動(dòng)作頁(yè)面入口入庫(kù)員/快遞員錄單號(hào)、選貨架、生成取件碼、入庫(kù)入庫(kù)頁(yè)面站內(nèi)管理員查看滯留件、處理逾期/退回、統(tǒng)計(jì)管理后臺(tái)取件用戶輸手機(jī)號(hào)取件碼取件、查我的包裹取件/查詢頁(yè)面包裹的狀態(tài)建議按六態(tài)理解已入庫(kù)、已提醒、已出庫(kù)、逾期、異常退貨、丟失。實(shí)際zip包里的表可能只落前三態(tài)后三態(tài)用狀態(tài)字段和查詢條件推導(dǎo)也夠用但在論文里的狀態(tài)圖可以按六態(tài)畫一頁(yè)圖撐起來了答辯也有東西講。狀態(tài)推移的規(guī)則是入庫(kù)產(chǎn)生“已入庫(kù)”通知用戶后變“已提醒”取件成功變“已出庫(kù)”超時(shí)未取變“逾期”用戶要求退回就變“異常退貨”。出庫(kù)和退回是終態(tài)不能再被取走這一條要在寫代碼時(shí)徹底鎖死。2.2 六張核心表字段怎么給、哪里要加唯一索引這里有個(gè)常見誤區(qū)把用戶表設(shè)計(jì)得很重。驛站場(chǎng)景下大多數(shù)人沒有賬號(hào)只有一個(gè)手機(jī)號(hào)所以不要在表里堆昵稱、頭像、積分這類字段。用戶表只留id、phone、create_time就夠。真正要花心思的是快遞表和取件記錄表。下面這套建表語句是按通用畢設(shè)方案整理的拿到zip后先對(duì)著它查一遍缺什么補(bǔ)什么-- 快遞表核心表所有流程都圍繞它轉(zhuǎn) CREATE TABLE express ( id BIGINT NOT NULL AUTO_INCREMENT COMMENT 主鍵, tracking_no VARCHAR(32) NOT NULL COMMENT 快遞單號(hào), phone VARCHAR(20) NOT NULL COMMENT 收件人手機(jī)號(hào)取件判斷依據(jù), status TINYINT NOT NULL DEFAULT 1 COMMENT 1已入庫(kù) 2已提醒 3已出庫(kù) 4逾期 5退回, pickup_code VARCHAR(10) DEFAULT NULL COMMENT 取件碼入庫(kù)時(shí)生成, shelf_no VARCHAR(20) DEFAULT NULL COMMENT 貨架編號(hào)例如A-01, in_time DATETIME DEFAULT NULL COMMENT 入庫(kù)時(shí)間, notify_time DATETIME DEFAULT NULL COMMENT 通知時(shí)間, take_time DATETIME DEFAULT NULL COMMENT 出庫(kù)時(shí)間, PRIMARY KEY (id), UNIQUE KEY uk_tracking (tracking_no), KEY idx_phone_status (phone, status) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT快遞表;-- 取件記錄表每次出庫(kù)動(dòng)作落一條用于統(tǒng)計(jì)和答辯時(shí)講對(duì)賬 CREATE TABLE take_record ( id BIGINT NOT NULL AUTO_INCREMENT, express_id BIGINT NOT NULL COMMENT 快遞ID, phone VARCHAR(20) NOT NULL COMMENT 取件人手機(jī)號(hào), take_time DATETIME NOT NULL COMMENT 出庫(kù)時(shí)間, operator_type TINYINT DEFAULT 0 COMMENT 0-用戶自助 1-管理員代取, PRIMARY KEY (id), KEY idx_express (express_id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT取件記錄表;注意三個(gè)關(guān)鍵點(diǎn)也是答辯常考題。tracking_no必須加唯一索引同一個(gè)單號(hào)不能入兩次庫(kù)這是快遞場(chǎng)景的硬約束idx_phone_status是為了支撐“我的包裹”查詢頁(yè)讓查詢走索引而不是全表掃描pickup_code在業(yè)務(wù)層生成后最好也加唯一索引兜底并發(fā)場(chǎng)景下兩個(gè)請(qǐng)求撞相同取件碼的概率才能壓下去。其余四張表——admin管理員表、user用戶表、notice通知表、overdue_log逾期處理表設(shè)計(jì)上保持“誰在什么時(shí)間做了什么”即可。通知表不要做成短信平臺(tái)對(duì)接畢業(yè)生設(shè)計(jì)一般只落庫(kù)留一個(gè)send_flag字段表示已推送就行。3. 寫通入庫(kù)、取件、出庫(kù)最小可用的核心流程代碼有些zip的代碼跑得起來但讀不動(dòng)Controller里直接寫SQLService方法兩百行事務(wù)注解一個(gè)沒有。這不是風(fēng)格問題是模塊邊界沒立住。如果包里的代碼沒法讓你在答辯時(shí)講清楚職責(zé)我的建議是保留外部接口按下面這套方案重寫核心Service。三塊足夠閉環(huán)入庫(kù)、取件出庫(kù)、逾期統(tǒng)計(jì)。3.1 入庫(kù)從錄制快遞到生成取件碼的一串決策入庫(kù)接口的輸入有三個(gè)trackingNo快遞單號(hào)、phone收件人手機(jī)號(hào)、shelfNo貨架編號(hào)輸出是一個(gè)取件碼。取件碼的生成方案常見的有三種純6位隨機(jī)數(shù)、基于快遞ID編碼、時(shí)間戳低位拼接。純隨機(jī)最簡(jiǎn)單但碰撞后要循環(huán)重查基于ID編碼的碼面穩(wěn)定還能在答辯時(shí)講出“為什么這么設(shè)計(jì)”。我一般用ID末四位加隨機(jī)段生成效果如下public String generatePickupCode(long expressId) { // 取主鍵ID末四位做前綴保證同一天入庫(kù)的快遞碼有一定辨識(shí)度 // 后綴用4位隨機(jī)數(shù)把碰撞范圍壓到極小區(qū)間 String prefix String.format(%04d, expressId % 10000); String suffix String.format(%04d, ThreadLocalRandom.current().nextInt(10000)); String code prefix suffix; // 查庫(kù)確認(rèn)不重復(fù)撞碼后重新生成隨機(jī)部分 while (expressMapper.countByPickupCode(code) 0) { suffix String.format(%04d, ThreadLocalRandom.current().nextInt(10000)); code prefix suffix; } return code; }邏輯說明expressId是主鍵自增ID用它的末四位做前綴可以讓取件碼看起來有序且好記ThreadLocalRandom在高并發(fā)下比Random更省資源也不要為了省事用Math.random()拼字符串位數(shù)控制容易出錯(cuò)。參數(shù)說明%04d是Java格式化輸出不足四位左補(bǔ)零保證碼位固定countByPickupCode是Mapper層的一個(gè)計(jì)數(shù)查詢返回0才認(rèn)為碼可用。入庫(kù)Service建議按“先查重—再插入—后生成碼—最后回更”四步走。第一步查tracking_no是否已存在第二步插入基礎(chǔ)狀態(tài)第三步調(diào)用上面的方法生成取件碼并更新第四步任何一步失敗都回滾。這套順序能講成“先約束業(yè)務(wù)字段再落庫(kù)再分配業(yè)務(wù)編碼”是一個(gè)完整的事務(wù)邊界答辯時(shí)非常好解釋。3.2 取件出庫(kù)一個(gè)請(qǐng)求里要處理的三件事用戶取件的入?yún)⑹莗hone pickupCode。一個(gè)合格的出庫(kù)方法不是“查到就改狀態(tài)”它必須一次性完成三件事驗(yàn)證手機(jī)號(hào)與取件碼匹配校驗(yàn)當(dāng)前狀態(tài)是否允許出庫(kù)在狀態(tài)變更的同時(shí)寫一條take_record。下面這段是核心邏輯public boolean takeExpress(String phone, String pickupCode) { // 第一步按手機(jī)號(hào)和取件碼精確鎖定快遞 Express exist expressMapper.selectOne( new LambdaQueryWrapperExpress() .eq(Express::getPhone, phone) .eq(Express::getPickupCode, pickupCode)); if (exist null) { return fail(取件碼與手機(jī)號(hào)不匹配或該快遞已被取走); } // 第二步狀態(tài)機(jī)校驗(yàn)只允許已入庫(kù)/已提醒狀態(tài)出庫(kù) if (exist.getStatus() TAKEN) { return fail(該包裹已出庫(kù)請(qǐng)勿重復(fù)操作); } if (exist.getStatus() RETURNED) { return fail(該包裹已辦理退回請(qǐng)聯(lián)系驛站管理員); } // 第三步先寫取件記錄再更新快遞狀態(tài) TakeRecord record new TakeRecord(); record.setExpressId(exist.getId()); record.setPhone(phone); record.setTakeTime(new Date()); takeRecordMapper.insert(record); exist.setStatus(TAKEN); exist.setTakeTime(new Date()); expressMapper.updateById(exist); return success(取件成功); }邏輯說明第一步的selectOne依賴數(shù)據(jù)庫(kù)唯一性如果庫(kù)里已經(jīng)出現(xiàn)多條相同phonepickup_code的記錄這里會(huì)直接拋異常所以上一章里給pickup_code加唯一索引是這步的前置保障。第二步的狀態(tài)判斷是防止重復(fù)出庫(kù)的關(guān)鍵很多翻車現(xiàn)場(chǎng)就是少了這個(gè) if前端雙擊提交兩次請(qǐng)求狀態(tài)就亂了。第三步先插記錄再改主表記住包在Transactional里中間任何異常整體回滾。參數(shù)說明phone建議前端做一次1[3-9]\\d{9}正則校驗(yàn)減少無效請(qǐng)求進(jìn)后端pickupCode后端取參后先trim()用戶手輸多一個(gè)空格就會(huì)查出空結(jié)果這類問題在演示現(xiàn)場(chǎng)很常見。3.3 逾期與統(tǒng)計(jì)讓答辯PPT有東西可寫的兩個(gè)功能驛站業(yè)務(wù)有兩個(gè)隱藏指標(biāo)值得做進(jìn)系統(tǒng)包裹滯留周期和日取件高峰時(shí)段。前者對(duì)應(yīng)“逾期提醒”后者對(duì)應(yīng)“統(tǒng)計(jì)圖表”。逾期判斷不推薦用定時(shí)任務(wù)每分鐘掃全表畢設(shè)場(chǎng)景下沒必要也扛不住大數(shù)據(jù)量。常見做法是查詢時(shí)用SQL算差值超過閾值的記錄自然出現(xiàn)在“待提醒”頁(yè)面。-- 超過48小時(shí)未取件的快遞按庫(kù)齡倒序展示 select id, tracking_no, phone, pickup_code, in_time, timestampdiff(HOUR, in_time, now()) as stay_hours from express where status in (1, 2) and timestampdiff(HOUR, in_time, now()) 48 order by stay_hours desc;參數(shù)說明status in (1, 2)對(duì)應(yīng)已入庫(kù)和已提醒意思是“還在站里”的包裹48 是滯留閾值可以抽成一個(gè)配置項(xiàng)答辯時(shí)演示改為24看效果更直觀。timestampdiff(HOUR, ...)是MySQL函數(shù)不做索引優(yōu)化也能在萬級(jí)數(shù)據(jù)下秒回夠畢業(yè)設(shè)計(jì)用。統(tǒng)計(jì)功能同理從take_record里按小時(shí)分組就能得到取件高峰select hour(take_time) as hour_no, count(*) as cnt from take_record where take_time date_sub(now(), interval 7 day) group by hour(take_time) order by cnt desc;到這里核心流程已經(jīng)閉環(huán)。下一步把整套工程“換殼”讓它從別人的zip變成你能講清楚、也敢理直氣壯說是自己改造的畢設(shè)。4. 技術(shù)選型與改名換面把別人的工程變成能答辯的項(xiàng)目很多畢業(yè)生不敢用zip里的代碼怕雷同。實(shí)際上論文查重主要看正文文字代碼相似不是致命問題但項(xiàng)目必須能自圓其說。讓它變成“你的項(xiàng)目”不是大改業(yè)務(wù)而是動(dòng)包名、動(dòng)表前綴、動(dòng)配置、重寫關(guān)鍵注釋。這一章把選型理由和換殼步驟一次講完。4.1 為什么選 Spring Boot MyBatis-Plus夠用、好講、容易加?xùn)|西市面上這類zip打包的后端主要是兩塊Spring Boot MyBatis/MyBatis-Plus MySQL或者老一點(diǎn)兒的SSHStrutsSpringHibernate。SSH配置太重、注解散亂、演示前還得單獨(dú)裝Tomcat現(xiàn)在基本不在推薦范圍。Spring Boot 是畢業(yè)設(shè)計(jì)的及格線理由不是“新”而是三句話能講清內(nèi)嵌Tomcat開發(fā)機(jī)不用單獨(dú)裝容器注解式開發(fā)Controller/Service邊界一眼可見配置在application.yml集中管理演示前改端口、改數(shù)據(jù)庫(kù)連接都很快。前端常見三種LayUI、Bootstrap、VueElementUI。zip里如果給了Vue版前后端分離的架構(gòu)足夠你多講五分鐘如果只是靜態(tài)HTMLJQuery也不影響業(yè)務(wù)演示畢竟老師看的是流程完整性不是前端框架新不新。無論哪種記住一個(gè)原則不要再引入微服務(wù)、消息隊(duì)列、分布式事務(wù)這些概念。畢業(yè)設(shè)計(jì)的核心是讓系統(tǒng)穩(wěn)定運(yùn)行并把業(yè)務(wù)講透架構(gòu)越簡(jiǎn)單翻車概率越低。下面這套配置是我在同類項(xiàng)目里常用的最小模板server: # 避免和同學(xué)演示撞端口建議改成8081或8082 port: 8080 spring: datasource: driver-class-name: com.mysql.cj.jdbc.Driver # serverTimezone 必須寫否則新版MySQL驅(qū)動(dòng)啟動(dòng)時(shí)報(bào)時(shí)區(qū)錯(cuò)誤 url: jdbc:mysql://127.0.0.1:3306/express_db?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/Shanghai username: root password: 123456 # 很多zip自帶 schema.sql data.sql 每次啟動(dòng)重建數(shù)據(jù)演示前務(wù)必關(guān)掉 sql: init: mode: never mybatis-plus: configuration: map-underscore-to-camel-case: true global-config: db-config: logic-delete-field: deleted logic-delete-value: 1 logic-not-delete-value: 0參數(shù)設(shè)置有三個(gè)坑都是實(shí)操里碰過的serverTimezoneAsia/Shanghai是防時(shí)區(qū)報(bào)錯(cuò)的固定寫法少了它啟動(dòng)時(shí)大概率拋The server time zone value相關(guān)異常sql.init.modenever非常重要有的zip為了讓評(píng)委打開就有數(shù)據(jù)會(huì)在啟動(dòng)時(shí)執(zhí)行建表和初始化腳本副作用是每次重啟都會(huì)清庫(kù)重來演示到一半數(shù)據(jù)沒了直接現(xiàn)場(chǎng)翻車map-underscore-to-camel-case: true讓表字段take_time自動(dòng)映射到實(shí)體屬性takeTime也能少寫一堆XML映射標(biāo)簽。4.2 改包名、改庫(kù)名前綴、重寫注釋三個(gè)半小時(shí)的換殼工作把別人工程變成自己的至少做三件事。第一件改包名。假設(shè)原包是com.example.express改成com.yourname.express。不要只改文件夾名還要檢查三個(gè)位置pom.xml的groupId、啟動(dòng)類上的SpringBootApplication掃描根包、MyBatis的mapper-locations路徑。這三處漏一處啟動(dòng)時(shí)都會(huì)報(bào)Invalid bound statement (not found)一類的錯(cuò)。第二件改庫(kù)名與表前綴。把express表改成yp_express這樣帶個(gè)人標(biāo)識(shí)的名字。建表腳本同步改實(shí)體類上的TableName(express)注解也要改。這一步的意義不是防查重而是讓答辯老師掃一眼表名就知道這套庫(kù)是經(jīng)過你重構(gòu)的而不是原zip直接拿來用。第三件重寫關(guān)鍵注釋。不是把每個(gè)類注釋拉長(zhǎng)而是把“為什么這么寫”補(bǔ)清楚。以下面這段為例/** * 快遞入庫(kù)接口 * 為什么返回封裝對(duì)象 ResponseResult * 前端需要統(tǒng)一拿到 code/msg/data 三個(gè)字段便于統(tǒng)一處理超時(shí)和錯(cuò)誤提示。 * 為什么在 Service 層生成取件碼 * Controller 只做參數(shù)綁定與登錄校驗(yàn)避免把業(yè)務(wù)規(guī)則堆在接口層。 */這樣做之后哪怕代碼骨架與原zip高度相似你也多了一層“能回答設(shè)計(jì)考量”的能力。答辯問“哪些是你寫的”你可以指著注釋和狀態(tài)機(jī)講這處的接口結(jié)構(gòu)是我定的表索引是我加的取件碼生成邏輯是我重寫的。底氣比背一篇文章足得多。5. 跑zip的避坑清單解壓、環(huán)境、數(shù)據(jù)三輪排查這類項(xiàng)目的啟動(dòng)失敗九成集中在文件損壞、端口與靜態(tài)資源、數(shù)據(jù)庫(kù)連接、業(yè)務(wù)狀態(tài)錯(cuò)亂這幾類。下面按排查順序?qū)懰慕M高頻坑每一條都給現(xiàn)象、原因和解決方式。5.1 解壓就報(bào)錯(cuò)eocd問題與文件損壞的三個(gè)檢查現(xiàn)象解壓時(shí)報(bào)invalid zip archive: could not find eocd或者提示壓縮包末端缺少結(jié)束標(biāo)記有的文件能解壓但漏文件。原因zip本身沒下載完整網(wǎng)盤下載中途斷流殺毒軟件把包內(nèi)某個(gè)文件當(dāng)風(fēng)險(xiǎn)文件直接隔離打包工具生成的zip與本地解壓工具版本不兼容。解決先看文件大小和下載頁(yè)面標(biāo)注做對(duì)比差幾MB基本就是沒下完換 7-Zip 或命令行unzip -t 文件名.zip測(cè)試完整性比圖形界面報(bào)錯(cuò)更明確還是不行就清掉下載緩存重新下載別在同一個(gè)源上反復(fù)試。畢業(yè)生拿到包的第一步其實(shí)是這個(gè)別一開始就在代碼層排查。5.2 界面打不開或404先按四層排查別急著改代碼現(xiàn)象啟動(dòng)日志顯示Tomcat已啟動(dòng)瀏覽器訪問http://localhost:8080/login卻404或頁(yè)面白屏。排查順序 第一層看端口。如果端口被占用啟動(dòng)日志里會(huì)有Port 8080 was already in use。Windows用netstat -ano | findstr 8080找占用PIDtaskkill /PID xxx /F結(jié)束進(jìn)程或直接改server.port為8081。 第二層看上下文路徑。server.servlet.context-path如果被配置過訪問要帶前綴比如/demo/login別憑直覺訪問根路徑。 第三層看靜態(tài)資源位置。純HTML放在src/main/resources/static下可直接用/login.html訪問如果頁(yè)面在templates目錄走的是模板引擎渲染必須匹配Controller里的GetMapping路徑。 第四層看攔截器。很多zip寫了登錄攔截器所有未登錄請(qǐng)求都會(huì)被302到登錄頁(yè)頁(yè)面表現(xiàn)為白屏或反復(fù)跳轉(zhuǎn)。這時(shí)候看瀏覽器Network面板里的301/302狀態(tài)碼比看后端日志更快。攔截器代碼要確認(rèn)靜態(tài)資源放行Override public void addInterceptors(InterceptorRegistry registry) { registry.addInterceptor(new LoginInterceptor()) // 放行登錄與靜態(tài)資源其余全部攔截 .addPathPatterns(/**) .excludePathPatterns(/login, /api/login, /css/**, /js/**, /images/**); }參數(shù)說明excludePathPatterns如果漏了/css/**和/js/**頁(yè)面HTML能打開但樣式全丟演示效果很差登錄接口路徑以你controller里的實(shí)際映射為準(zhǔn)。5.3 數(shù)據(jù)庫(kù)連不上與中文亂碼改三處就不再翻車現(xiàn)象啟動(dòng)報(bào)Access denied for user rootlocalhost或Unknown database express_db數(shù)據(jù)寫入后中文變成問號(hào)。原因與解決一口氣查三處。一是賬號(hào)密碼不對(duì)先用命令行mysql -uroot -p手動(dòng)登錄驗(yàn)證別在配置里反復(fù)猜二是MySQL 8要用com.mysql.cj.jdbc.Driver別用com.mysql.jdbc.Driver后者在新版驅(qū)動(dòng)下會(huì)報(bào)加載失敗三是庫(kù)可能不存在手動(dòng)建庫(kù)CREATE DATABASE express_db CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;建庫(kù)時(shí)明確指定utf8mb4再用數(shù)據(jù)庫(kù)客戶端導(dǎo)入建表腳本中文列名和數(shù)據(jù)都不會(huì)亂。最后檢查數(shù)據(jù)源URL里有沒有characterEncodingutf8這個(gè)參數(shù)不寫連接層默認(rèn)用服務(wù)器字符集中文寫入MySQL大概率亂碼。改動(dòng)順序建議是庫(kù)字符集 → 連接串 → 表字符集一層層確認(rèn)。5.4 取件碼重復(fù)、狀態(tài)錯(cuò)亂、依賴沖突三個(gè)黑匣子的定位思路取件碼重復(fù)。原因往往是生成方法用了純Random.nextInt(100000)且沒查重或查重語句寫在錯(cuò)誤分支里形同虛設(shè)。解決方法是把生成邏輯改成第3章的“先查再寫”同時(shí)給pickup_code加唯一索引兜底。排查時(shí)直接執(zhí)行select pickup_code, count(*) from express group by pickup_code having count(*) 1;一條SQL就能看出是歷史臟數(shù)據(jù)還是新生成的沖突。狀態(tài)錯(cuò)亂比如快遞沒被取走卻出現(xiàn)在已出庫(kù)列表。原因幾乎都是出庫(kù)接口直接update express set status3 where id?不校驗(yàn)前置狀態(tài)或者前端雙擊請(qǐng)求兩個(gè)請(qǐng)求先后進(jìn)來第二個(gè)依然進(jìn)入更新邏輯。解決方法是出庫(kù)方法里按phone pickup_code鎖記錄、判斷狀態(tài)、加Transactional重復(fù)取件第二次必須返回“已取件”。依賴沖突典型報(bào)錯(cuò)是ClassNotFoundException: com.mysql.cj.jdbc.Driver但代碼里明明有依賴。原因是pom.xml中多個(gè)MySQL驅(qū)動(dòng)坐標(biāo)沖突。解決方式是在項(xiàng)目根目錄執(zhí)行mvn dependency:tree -Dincludesmysql:mysql-connector-java看實(shí)際生效版本把多余坐標(biāo)注釋掉。這類問題不能靠反復(fù)重啟碰運(yùn)氣日志第一行堆棧是唯一權(quán)威。6. 答辯前做一次自檢用冒煙腳本把完整流程過一遍演示前最后一次排練我一般不再手動(dòng)點(diǎn)頁(yè)面而是寫一個(gè)冒煙腳本把“登錄—入庫(kù)—重復(fù)入庫(kù)失敗—取件—重復(fù)取件失敗”整條鏈路自動(dòng)跑一遍。這個(gè)方法是從聯(lián)調(diào)環(huán)境里學(xué)來的手動(dòng)點(diǎn)擊容易漏步驟腳本每次都從同一個(gè)初始狀態(tài)出發(fā)結(jié)果可復(fù)現(xiàn)。#!/bin/bash # 冒煙測(cè)試驗(yàn)證菜鳥驛站快遞分發(fā)系統(tǒng)核心鏈路 # 使用方法先啟動(dòng)項(xiàng)目再執(zhí)行 bash smoke_test.sh BASEhttp://localhost:8080 # 1. 管理員登錄拿token TOKEN$(curl -s -X POST $BASE/api/login -H Content-Type: application/json \ -d {username:admin,password:123456} \ | sed -n s/.*token:\([^]*\).*/\1/p) # 2. 入庫(kù)一筆快遞響應(yīng)里提取取件碼 TRACKINGSM$(date %s) RESP$(curl -s -X POST $BASE/api/express/in -H Authorization: Bearer $TOKEN \ -H Content-Type: application/json \ -d {\trackingNo\:\$TRACKING\,\phone\:\13900001111\,\shelfNo\:\A-01\}) CODE$(echo $RESP | sed -n s/.*pickupCode:\([^]*\).*/\1/p) echo 入庫(kù)結(jié)果$RESP # 3. 同一單號(hào)再次入庫(kù)預(yù)期返回重復(fù)錯(cuò)誤 echo 重復(fù)入庫(kù)結(jié)果 curl -s -X POST $BASE/api/express/in -H Authorization: Bearer $TOKEN \ -H Content-Type: application/json \ -d {\trackingNo\:\$TRACKING\,\phone\:\13900001111\,\shelfNo\:\A-01\} echo # 4. 取件預(yù)期成功 echo 取件結(jié)果 curl -s -X POST $BASE/api/express/take -H Content-Type: application/json \ -d {\phone\:\13900001111\,\pickupCode\:\$CODE\} echo # 5. 重復(fù)取件預(yù)期失敗 echo 重復(fù)取件結(jié)果 curl -s -X POST $BASE/api/express/take -H Content-Type: application/json \ -d {\phone\:\13900001111\,\pickupCode\:\$CODE\} echo邏輯說明腳本第1步從登錄接口取token第2步用時(shí)間戳拼單號(hào)保證每次運(yùn)行不撞歷史數(shù)據(jù)第3步驗(yàn)證單號(hào)唯一約束第4和第5步驗(yàn)證狀態(tài)機(jī)的冪等判斷。如果項(xiàng)目接口路徑和字段名與腳本不一致改BASE、/api/login、/api/express/in、/api/express/take這幾處即可。參數(shù)說明sed -n s/.*token:\([^]*\).*/\1/p是輕量正則提取不依賴jqdate %s生成秒級(jí)時(shí)間戳確保測(cè)試單號(hào)不重復(fù)。跑這個(gè)腳本時(shí)注意觀察第3步必須返回“重復(fù)”類提示、第5步必須返回“已取件”類提示兩步失敗說明核心約束沒生效答辯前必須修。核心鏈路用腳本驗(yàn)證過我還會(huì)把數(shù)據(jù)庫(kù)重置為空庫(kù)再跑一次確保從干凈環(huán)境啟動(dòng)也能通過。這樣做的好處不是腳本本身多高級(jí)而是它逼著你把“環(huán)境怎么搭、數(shù)據(jù)怎么重置、接口怎么調(diào)用”全部落實(shí)成動(dòng)作而不是臨時(shí)記在腦子里。答辯現(xiàn)場(chǎng)總會(huì)有意外腳本能兜住系統(tǒng)翻車剩下的就靠你對(duì)每個(gè)方法、每個(gè)狀態(tài)的熟悉程度來兜底了。希望這份自檢腳本幫到你祝答辯順利。本文還有配套的精品資源點(diǎn)擊獲取