前前后后帶了不少同學(xué)跑完這個(gè)項(xiàng)目從環(huán)境搭建到答辯演示踩過的坑攢了一堆。趁著周末有空把這套SpringBoot Vue的車輛管理系統(tǒng)管理平臺(tái)的完整思路、核心實(shí)現(xiàn)和排坑經(jīng)驗(yàn)整理出來給正在做畢設(shè)、課設(shè)或者想拿Java全棧練手的朋友一份可以直接照著做的參考。這套系統(tǒng)解決的問題很實(shí)在把車輛檔案、駕駛員信息、維修保養(yǎng)、加油記錄、保險(xiǎn)年檢這些瑣碎事務(wù)集中管理起來替代Excel表格和紙質(zhì)臺(tái)賬。對(duì)于學(xué)生項(xiàng)目來說它的業(yè)務(wù)邊界清晰CRUD覆蓋全面又有權(quán)限區(qū)分和報(bào)表統(tǒng)計(jì)非常適合作為畢業(yè)設(shè)計(jì)或課程設(shè)計(jì)的選題。全文不繞彎子直接按項(xiàng)目搭建順序講你能在半小時(shí)內(nèi)搞懂整體架構(gòu)跟著步驟把項(xiàng)目跑起來也知道怎么往里面加自己的亮點(diǎn)功能。1. 項(xiàng)目整體設(shè)計(jì)與技術(shù)選型解析1.1 為什么是這個(gè)技術(shù)組合現(xiàn)在Java后端崗位的主流技術(shù)棧就是SpringBoot 關(guān)系型數(shù)據(jù)庫前端則是Vue生態(tài)的天下。這套組合能成為畢設(shè)項(xiàng)目的經(jīng)典選擇不是因?yàn)樗囔趴岫撬銐驑?biāo)準(zhǔn)。后端用SpringBoot最直接的理由是零XML配置、內(nèi)嵌Tomcat、起步依賴一站式搞定。你不用像早年的SSH框架那樣配一堆bean.xml一個(gè)啟動(dòng)類就能把服務(wù)跑起來對(duì)新手非常友好。配合Spring MVC的注解開發(fā)寫接口的效率很高。MyBatis Plus作為ORM框架把單表CRUD的SQL幾乎都省了內(nèi)置的分頁插件、條件構(gòu)造器能覆蓋90%以上的數(shù)據(jù)操作場景。前端選Vue核心原因是組件化開發(fā)和響應(yīng)式數(shù)據(jù)綁定。配合Element UI組件庫表格、表單、彈窗、分頁這些后臺(tái)管理頁面最常用的功能都有現(xiàn)成組件拖出來拼裝就行。Vue Router負(fù)責(zé)頁面路由Vuex或Pinia管理登錄狀態(tài)和全局?jǐn)?shù)據(jù)。前后端通過HTTP JSON交互接口聯(lián)調(diào)和后期維護(hù)都比較順暢。1.2 系統(tǒng)模塊劃分與功能清單一套合格的車輛管理系統(tǒng)業(yè)務(wù)上要能支撐管車、管人、管錢、管檔案四條線。我拆解這套系統(tǒng)時(shí)的模塊劃分如下模塊核心功能對(duì)應(yīng)數(shù)據(jù)表系統(tǒng)管理用戶登錄、角色權(quán)限、菜單管理sys_user, sys_role, sys_menu車輛檔案車輛信息增刪改查、狀態(tài)篩選vehicle_info駕駛員管理駕駛員信息維護(hù)、證照到期提醒driver_info維修保養(yǎng)維修記錄登記、費(fèi)用統(tǒng)計(jì)、保養(yǎng)提醒maintenance_record加油管理加油記錄登記、油耗統(tǒng)計(jì)fuel_record保險(xiǎn)年檢保險(xiǎn)到期、年檢到期預(yù)警insurance_record出車管理出車申請(qǐng)、審批、回場登記vehicle_use_record如果你是按畢設(shè)標(biāo)準(zhǔn)來做我特別建議保留審批這條鏈路。出車申請(qǐng)經(jīng)管理員審核通過后才能出車這個(gè)流程讓系統(tǒng)從純記錄工具升級(jí)為有業(yè)務(wù)流程的管理平臺(tái)在答辯時(shí)講起來也更有的聊。而且這個(gè)模塊可以順帶演示SpringBoot的事務(wù)處理、狀態(tài)流轉(zhuǎn)判斷、多表關(guān)聯(lián)查詢都是面試官和評(píng)審老師愛問的點(diǎn)。1.3 數(shù)據(jù)庫設(shè)計(jì)與核心表結(jié)構(gòu)數(shù)據(jù)庫設(shè)計(jì)是這類項(xiàng)目的根基設(shè)計(jì)得好后面寫代碼會(huì)非常順暢。車輛管理系統(tǒng)最核心的幾張表我按從主到次的關(guān)系畫一下思路。第一張是車輛信息表(vehicle_info)這是全系統(tǒng)的主表。字段至少包含車牌號(hào)、車輛類型、品牌型號(hào)、購買日期、車輛狀態(tài)、當(dāng)前里程、所屬部門。車牌號(hào)建議設(shè)置唯一索引作為業(yè)務(wù)的自然主鍵來用表里另有自增id作為物理主鍵。第二張是駕駛員表(driver_info)通過vehicle_id外鍵關(guān)聯(lián)到車輛表因?yàn)閷?shí)際業(yè)務(wù)中一輛車主要對(duì)應(yīng)一個(gè)固定駕駛員當(dāng)然你也能設(shè)計(jì)成多對(duì)多關(guān)系但畢設(shè)階段用一對(duì)多更簡潔清晰。駕駛證號(hào)、準(zhǔn)駕車型、證件到期日期這幾個(gè)字段是必備的到期提醒功能就靠它們。第三類是業(yè)務(wù)流水表包括維修保養(yǎng)表、加油表、保險(xiǎn)表等。它們都有一個(gè)共通的設(shè)計(jì)要點(diǎn)必須冗余存一份車牌號(hào)和關(guān)聯(lián)車輛id。這樣做的原因是報(bào)表統(tǒng)計(jì)時(shí)直接查流水表就能拿到車牌而不需要每次join車輛表。以維修保養(yǎng)表為例核心字段設(shè)計(jì)如下CREATE TABLE maintenance_record ( id BIGINT PRIMARY KEY AUTO_INCREMENT, vehicle_id BIGINT NOT NULL COMMENT 關(guān)聯(lián)車輛id, plate_number VARCHAR(20) NOT NULL COMMENT 車牌號(hào)冗余字段, maintenance_type TINYINT COMMENT 1-維修 2-保養(yǎng), maintenance_date DATE NOT NULL, cost DECIMAL(10,2) NOT NULL, mileage INT COMMENT 送修時(shí)里程, repair_shop VARCHAR(100), description TEXT, create_time DATETIME DEFAULT CURRENT_TIMESTAMP );字段類型上用DECIMAL(10,2)存金額用DATE存日期這些都是經(jīng)驗(yàn)之談。之前見過有人用VARCHAR存費(fèi)用和日期排序和求和全是坑吃過虧的人才會(huì)在意這種細(xì)節(jié)。2. 后端核心實(shí)現(xiàn)拆解2.1 項(xiàng)目結(jié)構(gòu)搭建后端工程結(jié)構(gòu)我習(xí)慣按功能包來組織雖然按層分包c(diǎn)ontroller/service/mapper也常見但項(xiàng)目里功能一多按層分包會(huì)讓包越來越臃腫。對(duì)比下來功能分包的內(nèi)聚性更好找文件和加功能都方便。com.example.vehiclemgr ├── VehicleApplication.java // 啟動(dòng)類 ├── common // 通用模塊返回結(jié)果封裝、異常處理、常量 │ ├── Result.java │ ├── ResultCode.java │ └── GlobalExceptionHandler.java ├── config // 配置類MyBatis Plus、跨域、JWT攔截器 │ ├── MybatisPlusConfig.java │ ├── WebMvcConfig.java │ └── JwtInterceptor.java ├── controller // 控制層接收請(qǐng)求、參數(shù)校驗(yàn) │ ├── VehicleController.java │ ├── DriverController.java │ ├── MaintenanceController.java │ ├── FuelController.java │ └── SystemController.java ├── service // 業(yè)務(wù)邏輯層 │ ├── VehicleService.java │ └── impl │ └── VehicleServiceImpl.java ├── mapper // 數(shù)據(jù)訪問層 ├── entity // 數(shù)據(jù)庫實(shí)體類 ├── dto // 數(shù)據(jù)傳輸對(duì)象 ├── vo // 視圖對(duì)象 └── utils // 工具類JWT工具、日期工具啟動(dòng)類要留意MapperScan注解很多新手的項(xiàng)目起不來就是掃描不到Mapper接口SpringBootApplication MapperScan(com.example.vehiclemgr.mapper) public class VehicleApplication { public static void main(String[] args) { SpringApplication.run(VehicleApplication.class, args); } }2.2 權(quán)限認(rèn)證方案JWT畢設(shè)項(xiàng)目做權(quán)限認(rèn)證主流方案就是JWTJSON Web Token。我用生活化的類比解釋一下它的原理JWT就是給用戶發(fā)一張帶簽名的通行證用戶每次進(jìn)門前亮一下這張證服務(wù)端驗(yàn)證簽名沒問題就放行。它和Session方案最大的區(qū)別是服務(wù)端不需要存儲(chǔ)登錄狀態(tài)天然適合前后端分離架構(gòu)。這套系統(tǒng)里JWT的落地分成三塊第一塊是登錄接口用戶提交用戶名密碼后服務(wù)端校驗(yàn)通過生成token返回給前端。生成時(shí)把用戶id、用戶名和角色編碼放進(jìn)去過期時(shí)間我設(shè)置的是24小時(shí)足夠日常演示使用。第二塊是攔截器用Spring的HandlerInterceptor實(shí)現(xiàn)。前端每次請(qǐng)求帶上Authorization請(qǐng)求頭攔截器里校驗(yàn)token有效性通過后放行不通過直接返回401狀態(tài)碼。這里有個(gè)細(xì)節(jié)值得注意我額外放了token續(xù)期邏輯。如果校驗(yàn)時(shí)發(fā)現(xiàn)token剩余有效期不足兩小時(shí)就重新簽發(fā)一個(gè)token放到響應(yīng)頭里返回前端Axios攔截到新token就替換掉本地存儲(chǔ)。這個(gè)續(xù)期機(jī)制雖然代碼量不大但答辯時(shí)提出來會(huì)顯得你考慮問題很全面。第三塊是接口權(quán)限通過用戶角色來控制。比如管理員才能刪除車輛數(shù)據(jù)普通操作員只能新增和修改。實(shí)現(xiàn)上有兩種思路一種是在代碼里判斷角色另一種是用Spring Security或自定義注解做聲明式權(quán)限控制。畢設(shè)項(xiàng)目用自定義攔截器加角色判斷就夠用引入Spring Security會(huì)把學(xué)習(xí)成本和復(fù)雜度拉高不少不太劃算。2.3 核心業(yè)務(wù)接口設(shè)計(jì)我挑兩個(gè)最核心的接口來講實(shí)現(xiàn)思路一個(gè)是分頁查詢一個(gè)是多表聯(lián)動(dòng)統(tǒng)計(jì)。分頁查詢是所有管理系統(tǒng)的基本功。用MyBatis Plus的分頁插件后代碼極簡Override public PageResultVehicleVO queryVehiclePage(PageQuery query) { PageVehicle page new Page(query.getPageNum(), query.getPageSize()); LambdaQueryWrapperVehicle wrapper new LambdaQueryWrapper(); wrapper.like(StringUtils.hasText(query.getPlateNumber()), Vehicle::getPlateNumber, query.getPlateNumber()) .eq(query.getStatus() ! null, Vehicle::getStatus, query.getStatus()) .orderByDesc(Vehicle::getCreateTime); PageVehicle result vehicleMapper.selectPage(page, wrapper); // 將實(shí)體列表轉(zhuǎn)換為VO補(bǔ)充部門名稱等關(guān)聯(lián)信息 return PageResult.of(result.getRecords(), result.getTotal()); }這里L(fēng)ambdaQueryWrapper的條件構(gòu)造器是MyBatis Plus的精髓它允許你通過鏈?zhǔn)秸{(diào)用動(dòng)態(tài)拼接SQL不同組合條件查同一張表不需要寫一堆XML。第一行創(chuàng)建Page對(duì)象第二行封裝查詢條件第一個(gè)參數(shù)的boolean表達(dá)式為true時(shí)才會(huì)拼接這個(gè)條件這正是應(yīng)對(duì)表單篩選場景的最佳方式。多表聯(lián)動(dòng)統(tǒng)計(jì)我舉車輛費(fèi)用匯總這個(gè)例子。頁面要求展示每輛車在某個(gè)時(shí)間段內(nèi)的維修費(fèi)用、加油費(fèi)用、保險(xiǎn)費(fèi)用合計(jì)并且支持按費(fèi)用金額排序。這個(gè)功能如果把費(fèi)用項(xiàng)目做成一張通用流水表會(huì)簡單很多但業(yè)務(wù)上維修保養(yǎng)、加油、保險(xiǎn)是三個(gè)獨(dú)立模塊表結(jié)構(gòu)分開反而更清晰。實(shí)現(xiàn)上我用了一條UNION查詢把三張表的數(shù)據(jù)合到一起再按車牌分組SELECT plate_number, SUM(cost) AS total_cost, 維修保養(yǎng) AS cost_type FROM maintenance_record WHERE create_time BETWEEN #{startTime} AND #{endTime} GROUP BY plate_number UNION ALL SELECT plate_number, SUM(amount), 加油 FROM fuel_record WHERE create_time BETWEEN #{startTime} AND #{endTime} GROUP BY plate_number UNION ALL SELECT plate_number, SUM(premium), 保險(xiǎn) FROM insurance_record WHERE create_time BETWEEN #{startTime} AND #{endTime} GROUP BY plate_number這個(gè)思路學(xué)生在答辯時(shí)被問的頻率很高因?yàn)樵u(píng)審老師喜歡看表關(guān)聯(lián)和聚合分析。為什么不直接用一條大查詢關(guān)聯(lián)三張表答案很明確三張表的費(fèi)用字段含義不同直接join會(huì)產(chǎn)生笛卡爾積一條車記錄關(guān)聯(lián)出多條維修和加油記錄費(fèi)用被重復(fù)計(jì)算而UNION先各自聚合再合并結(jié)果才是真實(shí)的。這段講解會(huì)讓你看起來真懂這個(gè)系統(tǒng)而不只是會(huì)抄代碼。3. 前端實(shí)現(xiàn)要點(diǎn)3.1 Vue項(xiàng)目結(jié)構(gòu)與路由設(shè)計(jì)前端我用的是Vue 2 Element UI之所以不推薦Vue 3版本主要是因?yàn)槭忻嫔洗蟛糠之厴I(yè)設(shè)計(jì)參考項(xiàng)目和現(xiàn)成模板都是Vue 2遇到問題搜解決方案更容易命中。如果你自己有Vue 3經(jīng)驗(yàn)換成Vue 3 Element Plus也沒問題核心思路完全一致。前端工程結(jié)構(gòu)src ├── api // 接口請(qǐng)求封裝 │ ├── vehicle.js │ ├── driver.js │ ├── maintenance.js │ ├── login.js │ └── request.js // Axios統(tǒng)一封裝 ├── assets // 靜態(tài)資源 ├── components // 通用組件 ├── router │ └── index.js // 路由配置 ├── store // 狀態(tài)管理 │ └── user.js ├── views // 頁面視圖 │ ├── login │ ├── dashboard │ ├── vehicle │ ├── driver │ ├── maintenance │ ├── fuel │ ├── insurance │ └── system └── main.js路由設(shè)計(jì)上要利用路由守衛(wèi)這是Vue項(xiàng)目權(quán)限控制的關(guān)鍵點(diǎn)。在跳轉(zhuǎn)路由之前判斷本地有沒有token沒有就強(qiáng)制跳轉(zhuǎn)到登錄頁router.beforeEach((to, from, next) { const token localStorage.getItem(token) if (to.path ! /login !token) { next(/login) } else { next() } })同時(shí)根據(jù)用戶的角色前端要?jiǎng)討B(tài)過濾菜單項(xiàng)。我的做法是在路由表里給每個(gè)路由加meta字段標(biāo)記需要的角色在菜單渲染時(shí)判斷當(dāng)前用戶的角色是否在允許列表里。這里有一個(gè)白名單配置的小經(jīng)驗(yàn)登錄頁、404頁這些無需鑒權(quán)的路由單獨(dú)維護(hù)一個(gè)白名單數(shù)組防止登錄失效后反復(fù)跳轉(zhuǎn)死循環(huán)。3.2 核心頁面實(shí)現(xiàn)頁面實(shí)現(xiàn)上最值得細(xì)講的是車輛列表頁它是這類管理系統(tǒng)的門面做得好看和好用能加分不少。列表頁的標(biāo)準(zhǔn)搭配是頂部搜索欄 主表格 分頁器 新增/編輯彈窗。搜索欄放車牌號(hào)輸入框、車輛狀態(tài)下拉框、查詢和重置按鈕。表格列用Element UI的el-table實(shí)現(xiàn)車牌號(hào)列固定寬度狀態(tài)列用el-tag加顏色標(biāo)簽操作列放編輯和刪除按鈕。分頁這塊有個(gè)關(guān)鍵點(diǎn)需要注意分頁組件的位置狀態(tài)要和查詢參數(shù)綁定。常見問題是點(diǎn)擊第5頁后修改搜索條件重新查詢結(jié)果還是停留在第5頁但總頁數(shù)變少了頁面直接空白。解決方式是點(diǎn)擊查詢時(shí)強(qiáng)制把當(dāng)前頁碼重置為第1頁。表單校驗(yàn)方面我用Element UI的rules來做。車牌號(hào)的正則校驗(yàn)是個(gè)典型場景例如校驗(yàn)收起格式是否符合普通藍(lán)牌規(guī)則漢字字母5位數(shù)字/字母組合。正則如下const plateNumberPattern /^[\u4e00-\u9fa5][A-Z][A-Z0-9]{5,6}$/彈窗表單提交后要手動(dòng)刷新列表數(shù)據(jù)而不是整頁刷新這也是一個(gè)體驗(yàn)細(xì)節(jié)。我用了一個(gè)調(diào)研發(fā)現(xiàn)的思路在父組件里調(diào)用子組件的加載方法或者通過事件總線通知列表刷新。兩種方案都可行我用的是第一種在新增和編輯彈窗內(nèi)部維護(hù)loading狀態(tài)提交成功后emit一個(gè)refresh事件父組件監(jiān)聽后執(zhí)行列表查詢方法。3.3 前后端聯(lián)調(diào)經(jīng)驗(yàn)前后端聯(lián)調(diào)是新手最頭疼的環(huán)節(jié)問題多半出在接口對(duì)接不通前端報(bào)401或跨域錯(cuò)誤。這套系統(tǒng)我使用Vue CLI開發(fā)服務(wù)器來配置代理把前端的/api請(qǐng)求代理到后端的8080端口// vue.config.js module.exports { devServer: { port: 3000, proxy: { /api: { target: http://localhost:8080, changeOrigin: true, pathRewrite: { ^/api: } } } } }這樣前端請(qǐng)求/api/vehicle/list會(huì)被代理到后端/vehicle/list開發(fā)時(shí)不需要后端開啟CORS跨域還能規(guī)避生產(chǎn)環(huán)境的跨域問題。之所以推薦代理方案而不是CORS直接放開是因?yàn)榇矸绞礁咏€上部署的真實(shí)場景Nginx反代時(shí)也是類似原理項(xiàng)目從本機(jī)遷到服務(wù)器不需要改任何前端代碼里的請(qǐng)求地址。聯(lián)調(diào)時(shí)另一個(gè)高概率踩坑點(diǎn)是日期格式。后端返回的LocalDateTime默認(rèn)帶T比如2024-01-15T10:30:00前端直接顯示很難看。統(tǒng)一方案是在后端配置全局Jackson序列化格式spring: jackson: date-format: yyyy-MM-dd HH:mm:ss time-zone: GMT8前端Axios響應(yīng)攔截器也可以做一層統(tǒng)一處理但優(yōu)先在后端格式化前后端約定好用字符串格式傳日期邏輯最簡單不容易出問題。4. 部署與運(yùn)行指南4.1 本地開發(fā)環(huán)境啟動(dòng)本地把項(xiàng)目跑起來我總結(jié)成一條干凈的命令鏈路。前提是裝好JDK 1.8、Maven 3.6、MySQL 5.7、Node.js 14。第一步建庫和準(zhǔn)備數(shù)據(jù)。進(jìn)入MySQL執(zhí)行建庫語句然后導(dǎo)入項(xiàng)目中提供的vehicle.sql。注意這個(gè)文件如果沒提供你要自己做一次表結(jié)構(gòu)和初始數(shù)據(jù)的整理。初始數(shù)據(jù)至少要包含一個(gè)管理員賬號(hào)、幾輛測試車輛和幾條流水記錄不然頁面打開一片空白演示效果很差。第二步配置后端。打開application.yml改三處數(shù)據(jù)庫連接地址、用戶名、密碼。我建議數(shù)據(jù)庫連接串加上useUnicodetruecharacterEncodingutf8serverTimezoneAsia/Shanghai不然經(jīng)常中文亂碼、報(bào)時(shí)區(qū)錯(cuò)誤。第三步啟動(dòng)后端。在項(xiàng)目根目錄執(zhí)行mvn spring-boot:run看到類似Started VehicleApplication in 5.32 seconds的日志就說明啟動(dòng)成功默認(rèn)端口8080。想驗(yàn)證的話瀏覽器訪問http://localhost:8080/vehicle/list沒有token時(shí)會(huì)返回401這是正常的。第四步啟動(dòng)前端。在vue目錄下依次執(zhí)行npm install npm run serve看到App running at Local: http://localhost:3000瀏覽器打開這個(gè)地址用初始管理員賬號(hào)登錄能看到首頁統(tǒng)計(jì)圖表和菜單就說明全部打通了。4.2 服務(wù)器部署要點(diǎn)本地跑通只是第一步不少同學(xué)要求部署到云服務(wù)器上給答辯老師演示。生產(chǎn)環(huán)境部署我推薦前端打包成靜態(tài)文件由Nginx托管后端打成jar包由Java直接運(yùn)行不用容器最直接也最穩(wěn)。前端打包命令npm run build打包后在dist目錄下生成靜態(tài)文件將這些文件上傳到服務(wù)器的Nginx靜態(tài)目錄。Nginx配置關(guān)鍵點(diǎn)在于前端路由的history回退和接口轉(zhuǎn)發(fā)這段配置直接貼在server塊里server { listen 80; server_name your_domain_or_ip; location / { root /var/www/vehicle; index index.html; try_files $uri $uri/ /index.html; } location /api/ { proxy_pass http://127.0.0.1:8080/; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; } }try_files那句是給Vue Router用的。前端訪問一個(gè)非根路徑的頁面時(shí)Nginx先去靜態(tài)目錄找對(duì)應(yīng)的html文件找不到就回退到index.html由前端路由接管頁面就不會(huì)白屏。后端部署就更直接打包是跳過測試的mvn clean package -DskipTests java -jar target/vehicle.jar --spring.profiles.activeprod生產(chǎn)環(huán)境的數(shù)據(jù)庫地址、賬號(hào)密碼等建議在application-prod.yml里單獨(dú)配置和本地開發(fā)配置分開。如果服務(wù)器上有防火墻記得在安全組放行80端口和3306端口這是個(gè)常見的隱蔽坑——本地一切正常服務(wù)器上就是連不上數(shù)據(jù)庫最后發(fā)現(xiàn)是安全組策略沒放行。5. 常見問題與排查技巧5.1 啟動(dòng)期常見問題速查項(xiàng)目跑不起來的場景我見過太多把出現(xiàn)頻次最高的問題匯總成一張表照著排就行問題現(xiàn)象根本原因解決辦法后端啟動(dòng)報(bào)端口被占用8080端口被其他程序占用換端口或查殺占用進(jìn)程netstat -ano | findstr 8080啟動(dòng)報(bào)數(shù)據(jù)庫連接失敗連接串、賬號(hào)密碼配置錯(cuò)誤逐一核對(duì)url/user/password檢查MySQL服務(wù)是否啟動(dòng)前端npm install報(bào)錯(cuò)Node版本不兼容或網(wǎng)絡(luò)原因換Node 14/16版本或用鏡像源npm config set registry https://registry.npmmirror.com登錄頁面一直轉(zhuǎn)圈后端服務(wù)沒啟動(dòng)或代理配置錯(cuò)誤先curl測后端接口是否通再檢查proxy配置頁面顯示￥亂碼數(shù)據(jù)庫或連接串字符集問題建庫時(shí)指定utf8mb4連接串加characterEncodingutf8接口返回401token過期或未帶請(qǐng)求頭檢查Axios攔截器是否設(shè)置了Authorization請(qǐng)求頭5.2 MyBatis Plus的隱蔽坑這個(gè)必須單獨(dú)講因?yàn)樘菀椎暨M(jìn)去了。MyBatis Plus的LambdaQueryWrapper雖然方便但有一個(gè)很隱蔽的泛型推斷問題新手頻繁踩坑。比如這幾行代碼LambdaQueryWrapperVehicle wrapper new LambdaQueryWrapper(); wrapper.eq(status, query.getStatus());eq(status, ...)這是基于字符串列名的舊式寫法雖然能用但很容易因?yàn)榱忻磳戝e(cuò)誤在運(yùn)行時(shí)才報(bào)錯(cuò)。推薦始終使用eq(Vehicle::getStatus, ...)這種lambda引用方式它不只編譯期就能發(fā)現(xiàn)字段名拼錯(cuò)的問題而且能在IDE里全文搜索字段的引用關(guān)系。我在代碼評(píng)審時(shí)看到字符串列名寫法都會(huì)建議改成lambda方式這是使用MyBatis Plus的基本素養(yǎng)。另一個(gè)坑是邏輯刪除的全局配置。如果項(xiàng)目中做了邏輯刪除設(shè)計(jì)數(shù)據(jù)表加deleted字段別忘了在application.yml中做全局配置mybatis-plus: global-config: db-config: logic-delete-field: deleted logic-delete-value: 1 logic-not-delete-value: 0沒配置時(shí)MyBatis Plus執(zhí)行的刪除操作是物理DELETE數(shù)據(jù)直接沒了演示時(shí)誤刪一條數(shù)據(jù)要重新插回去很尷尬。配好邏輯刪除后查詢、更新都會(huì)自動(dòng)帶上deleted0條件這正好是面試時(shí)能講的安全感設(shè)計(jì)。5.3 答辯演示時(shí)的加分小技巧最后一個(gè)板塊分享幾個(gè)實(shí)際答辯時(shí)親測有效的細(xì)節(jié)處理都是很小的改動(dòng)但體驗(yàn)差別很大。一是全局異常處理。后端加一個(gè)RestControllerAdvice統(tǒng)一處理業(yè)務(wù)異常和兜底異常返回給前端統(tǒng)一的JSON格式。不配這個(gè)的話代碼里任何一處空指針前端拿到的是亂七八糟的報(bào)錯(cuò)頁面評(píng)審老師體驗(yàn)分瞬間降低。我的做法是自定義一個(gè)BizException業(yè)務(wù)邏輯中需要拒絕操作時(shí)直接拋出由全局處理器轉(zhuǎn)為提示信息返回。二是接口耗時(shí)打印。在controller層用AOP或攔截器打印每個(gè)接口的請(qǐng)求參數(shù)和耗時(shí)情況只看日志就能知道接口有沒有性能瓶頸。這個(gè)AOP切面我大概用了二十多行代碼效果很明顯還能展示你掌握AOP能力。三是README要寫得足夠詳細(xì)。項(xiàng)目根目錄放一個(gè)README.md包含項(xiàng)目簡介、技術(shù)棧、運(yùn)行步驟、默認(rèn)賬號(hào)密碼、模塊截圖說明。我自己帶了十幾個(gè)學(xué)生調(diào)試項(xiàng)目發(fā)現(xiàn)把README寫清楚后自己回顧和導(dǎo)師初期審核的效率都提升了不止一點(diǎn)。這個(gè)習(xí)慣對(duì)完整交付一個(gè)項(xiàng)目來說比多寫一個(gè)功能模塊更重要。如果你正在做畢設(shè)開題或者已經(jīng)進(jìn)入編碼階段我給的直接建議是不要把時(shí)間花在糾結(jié)技術(shù)選型和高大上的架構(gòu)上先把車輛信息管理這個(gè)最小閉環(huán)跑通再逐步擴(kuò)展模塊。項(xiàng)目做得順了二開的路子自然會(huì)慢慢清晰。