簡介在Web應(yīng)用開發(fā)中SpringBoot作為主流Java后端框架與Thymeleaf模板引擎、MySQL數(shù)據(jù)庫組合構(gòu)成了經(jīng)典的服務(wù)端渲染技術(shù)棧。其核心原理在于通過控制器將業(yè)務(wù)數(shù)據(jù)封裝到Model再由Thymeleaf在服務(wù)端動(dòng)態(tài)渲染HTML頁面實(shí)現(xiàn)前后端一體化交付。這種架構(gòu)不僅降低了對(duì)前端工程化和跨域處理的依賴還保留了清晰的Controller-Service-Mapper分層特別適合中小型業(yè)務(wù)系統(tǒng)的快速構(gòu)建。在旅游信息化場景中基于該技術(shù)棧開發(fā)的景點(diǎn)與酒店預(yù)訂網(wǎng)站能夠覆蓋用戶注冊(cè)登錄、景點(diǎn)/酒店瀏覽、在線下單、訂單管理、評(píng)論互動(dòng)等完整業(yè)務(wù)閉環(huán)為畢業(yè)設(shè)計(jì)或課程實(shí)踐提供可運(yùn)行的工程樣板。本文即圍繞這類系統(tǒng)的數(shù)據(jù)庫設(shè)計(jì)、核心代碼實(shí)現(xiàn)、部署運(yùn)維及常見問題展開給出可落地的SpringBoot實(shí)戰(zhàn)參考。 每年四月份開始就會(huì)有不少學(xué)生朋友來問畢業(yè)設(shè)計(jì)的事。問得最多的一類就是某某管理系統(tǒng)、某某預(yù)訂網(wǎng)站。今天這篇我直接拿一個(gè)真實(shí)能跑的項(xiàng)目來說——基于SpringBootThymeleafMySQL開發(fā)的旅游景點(diǎn)酒店預(yù)訂網(wǎng)站Java完整源代碼和數(shù)據(jù)庫腳本都包含在內(nèi)。它不是網(wǎng)上那種只有半截代碼的Demo而是一套從用戶注冊(cè)登錄到下單預(yù)訂完整閉環(huán)的項(xiàng)目基本覆蓋了畢設(shè)答辯時(shí)老師最愛問的幾個(gè)點(diǎn)。這套項(xiàng)目的好處在于技術(shù)棧主流界面不花哨但夠用數(shù)據(jù)庫表結(jié)構(gòu)清晰業(yè)務(wù)邏輯不復(fù)雜但五臟俱全。不管是做畢設(shè)、課程設(shè)計(jì)還是想通過一個(gè)完整項(xiàng)目來理解SpringBoot后臺(tái)開發(fā)的整個(gè)鏈路都非常合適。下面我就從設(shè)計(jì)思路、數(shù)據(jù)庫、代碼實(shí)現(xiàn)、部署運(yùn)維幾個(gè)維度把這個(gè)項(xiàng)目徹底拆開講。1. 項(xiàng)目整體設(shè)計(jì)與思路拆解1.1 項(xiàng)目到底做了什么事旅游景點(diǎn)酒店預(yù)訂網(wǎng)站核心業(yè)務(wù)不復(fù)雜。用戶進(jìn)到網(wǎng)站之后能瀏覽旅游景點(diǎn)和酒店列表可以查看詳情然后選擇日期和數(shù)量進(jìn)行預(yù)訂。預(yù)訂之后在個(gè)人中心能查看自己的訂單記錄可以對(duì)已消費(fèi)的景點(diǎn)或酒店進(jìn)行評(píng)價(jià)。管理員則通過后臺(tái)維護(hù)景點(diǎn)信息、酒店信息、用戶狀態(tài)和訂單狀態(tài)。這里有一個(gè)很關(guān)鍵的取舍到底是做成“旅游平臺(tái)”這種多商家入駐的模式還是做一個(gè)“單站管理”的模式。畢設(shè)項(xiàng)目里我建議做成單站管理就好。也就是說景點(diǎn)和酒店都直接由管理員在后臺(tái)添加維護(hù)用戶只能瀏覽和下單。這樣既能把業(yè)務(wù)閉環(huán)做完整又不會(huì)因?yàn)橐肷碳叶恕⒔Y(jié)算體系而把項(xiàng)目復(fù)雜度無限放大導(dǎo)致代碼寫不完、論文也沒法聚焦。1.2 為什么選SpringBootThymeleaf而不是前后端分離這個(gè)項(xiàng)目名字里就寫了SpringBootThymeleaf那自然要聊清楚為什么這么選。很多同學(xué)現(xiàn)在一上來就想著VueSpringBoot前后端分離覺得這樣才“高級(jí)”。但實(shí)際上畢設(shè)答辯時(shí)老師更關(guān)注的是你能不能把一個(gè)完整業(yè)務(wù)跑通能不能把設(shè)計(jì)邏輯講清楚。Thymeleaf是一種服務(wù)端模板引擎它能在HTML頁面里直接渲染Java后臺(tái)傳來的數(shù)據(jù)。選它有幾個(gè)現(xiàn)實(shí)原因。第一項(xiàng)目結(jié)構(gòu)簡單不需要單獨(dú)啟動(dòng)前端工程也不需要處理跨域問題。第二對(duì)于“頁面數(shù)量不多、交互不復(fù)雜”的預(yù)訂網(wǎng)站來說服務(wù)端渲染的體驗(yàn)并不差頁面加載快而且寫起來直觀。第三和SpringBoot整合非常順滑只要在pom.xml里引入依賴再把頁面放在templates目錄下Controller返回的邏輯視圖名就能自動(dòng)對(duì)應(yīng)到模板文件。對(duì)新手來說這種“看得見摸得著”的渲染方式比前后端分離那種頁面和數(shù)據(jù)分離的調(diào)試方式友好得多。我見過不少同學(xué)用前后端分離做畢設(shè)結(jié)果答辯現(xiàn)場前端跨域問題沒解決頁面數(shù)據(jù)出不來。如果你做的不是那種強(qiáng)交互、多狀態(tài)管理的大型系統(tǒng)老老實(shí)實(shí)上Thymeleaf反而更穩(wěn)。1.3 技術(shù)選型的底層邏輯除了SpringBoot和ThymeleafORM層面我建議用MyBatis-Plus。它本質(zhì)上還是MyBatis只是幫我們把單表的增刪改查都封裝好了不需要寫一大堆XML文件。這個(gè)項(xiàng)目里的用戶表、景點(diǎn)表、酒店表、訂單表基本都是單表操作用MyBatis-Plus可以省掉大量重復(fù)代碼讓你把精力放在業(yè)務(wù)和頁面上。如果你在簡歷里寫了了解MyBatis-Plus這也是一個(gè)不錯(cuò)的加分點(diǎn)。數(shù)據(jù)庫用MySQL這也是最穩(wěn)妥的選擇。版本上建議5.7或者8.0都可以但要注意8.0的驅(qū)動(dòng)名和連接URL中存在一些時(shí)區(qū)和驅(qū)動(dòng)類的差異后面我會(huì)專門講坑。前端樣式用Bootstrap不自己造輪子也不用維護(hù)復(fù)雜的Vue組件。因?yàn)檫@是一個(gè)畢設(shè)項(xiàng)目保證界面干凈、布局合理、能正常響應(yīng)就足夠了。2. 功能模塊劃分與數(shù)據(jù)庫設(shè)計(jì)2.1 前臺(tái)和后臺(tái)的功能邊界系統(tǒng)面向兩類角色普通用戶和管理員。普通用戶的功能集中在網(wǎng)站前臺(tái)注冊(cè)、登錄、退出登錄瀏覽景點(diǎn)列表、酒店列表查看景點(diǎn)詳情、酒店詳情提交景點(diǎn)門票預(yù)訂、酒店房間預(yù)訂在個(gè)人中心查看訂單列表對(duì)訂單進(jìn)行取消或刪除操作對(duì)已“完成”的訂單發(fā)表評(píng)論管理員的功能集中在后臺(tái)管理端管理員登錄景點(diǎn)信息管理新增、編輯、上下架、刪除酒店信息管理新增、編輯、上下架、刪除用戶管理查看用戶列表、禁用/啟用賬號(hào)訂單管理查看所有訂單、按狀態(tài)篩選、修改訂單狀態(tài)評(píng)論管理查看評(píng)論、刪除違規(guī)評(píng)論這里有一個(gè)容易被忽視但很重要的點(diǎn)前臺(tái)和后臺(tái)不要各寫一套登錄邏輯。我處理的方式是在用戶表里加一個(gè)role字段1表示普通用戶0表示管理員。登錄時(shí)根據(jù)角色跳轉(zhuǎn)到不同首頁同時(shí)用一個(gè)攔截器做權(quán)限控制。這樣做數(shù)據(jù)模型簡單代碼量少而且答辯時(shí)你能講清楚“同一個(gè)用戶體系如何通過角色字段區(qū)分不同身份”。2.2 數(shù)據(jù)庫表結(jié)構(gòu)設(shè)計(jì)整個(gè)項(xiàng)目用到的數(shù)據(jù)表我拆成了8張分別是用戶表、景點(diǎn)表、酒店表、訂單表、評(píng)論表、收藏表、公告表和分類表。這里我挑重點(diǎn)講。用戶表CREATE TABLE t_user ( id int(11) NOT NULL AUTO_INCREMENT, username varchar(50) NOT NULL COMMENT 登錄名, password varchar(100) NOT NULL COMMENT 密碼建議MD5或BCrypt, nickname varchar(50) DEFAULT NULL COMMENT 昵稱, phone varchar(20) DEFAULT NULL, email varchar(100) DEFAULT NULL, avatar varchar(255) DEFAULT NULL, role tinyint(1) DEFAULT 1 COMMENT 0管理員 1普通用戶, status tinyint(1) DEFAULT 1 COMMENT 1正常 0禁用, create_time datetime DEFAULT NULL, PRIMARY KEY (id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;景點(diǎn)表和酒店表結(jié)構(gòu)類似核心字段有名稱、簡介、圖片、地址、價(jià)格、開放時(shí)間/房型、狀態(tài)等。這里要注意圖片字段存的是URL路徑不是圖片本身。很多新手會(huì)把圖片轉(zhuǎn)成Base64往數(shù)據(jù)庫里存一旦圖片多了數(shù)據(jù)庫體積暴漲頁面渲染也會(huì)變卡。正確做法是圖片上傳后存到本地某個(gè)目錄或OSS數(shù)據(jù)庫里只存訪問路徑。訂單表是最關(guān)鍵的一張表因?yàn)榫包c(diǎn)門票和酒店預(yù)訂本質(zhì)上都是“下訂單”這個(gè)動(dòng)作。我把兩類訂單合成一張表通過product_type字段區(qū)分是景點(diǎn)(1)還是酒店(2)。這樣做的好處是訂單管理后臺(tái)只有一套代碼不需要寫兩套。缺點(diǎn)是如果以后要做復(fù)雜的訂單擴(kuò)展單表會(huì)有點(diǎn)擁擠但對(duì)于畢設(shè)來說足夠。訂單表核心字段CREATE TABLE t_order ( id int(11) NOT NULL AUTO_INCREMENT, order_no varchar(32) NOT NULL COMMENT 訂單編號(hào), user_id int(11) NOT NULL COMMENT 下單用戶, product_type tinyint(1) NOT NULL COMMENT 1景點(diǎn) 2酒店, product_id int(11) NOT NULL, product_name varchar(100) NOT NULL, price decimal(10,2) NOT NULL COMMENT 單價(jià), num int(11) NOT NULL DEFAULT 1 COMMENT 數(shù)量, total_price decimal(10,2) NOT NULL, book_date varchar(20) DEFAULT NULL COMMENT 游玩/入住日期, contact_name varchar(50) DEFAULT NULL, contact_phone varchar(20) DEFAULT NULL, status tinyint(1) DEFAULT 0 COMMENT 0待確認(rèn) 1已確認(rèn) 2已完成 3已取消, create_time datetime DEFAULT NULL, PRIMARY KEY (id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;這樣的設(shè)計(jì)已經(jīng)能夠支撐一個(gè)完整的預(yù)訂流程用戶在前臺(tái)選擇景點(diǎn)或酒店填寫聯(lián)系人信息和預(yù)訂日期提交訂單管理員在后臺(tái)確認(rèn)或完成訂單用戶看到狀態(tài)變化后可以評(píng)論。2.3 SQL腳本里的那些細(xì)節(jié)數(shù)據(jù)庫腳本不是把建表語句一放就完事了還要考慮初始化數(shù)據(jù)和兼容性。第一字符集一定要用utf8mb4而不是utf8。因?yàn)閡tf8在MySQL里最多存3字節(jié)像一些生僻字或者emoji表情會(huì)存不進(jìn)去。雖然網(wǎng)站上可能用不到emoji但用戶評(píng)論區(qū)保不準(zhǔn)有人粘貼一個(gè)特殊符號(hào)用了utf8mb4就不會(huì)出現(xiàn)亂碼或報(bào)錯(cuò)。第二密碼字段不能明文存。雖然我這里為了演示寫的是簡單方式但你在畢設(shè)里最好用BCrypt或者至少M(fèi)D5加鹽。答辯時(shí)如果老師問“你的密碼安全嗎”你至少能說出我做了加密處理。第三初始化數(shù)據(jù)里一定要有一條管理員賬號(hào)。很多同學(xué)辛辛苦苦把項(xiàng)目跑起來結(jié)果后臺(tái)登錄入口不知道賬密。我的腳本里固定初始化一個(gè)admin/admin123并在文檔里寫清楚這樣拿到項(xiàng)目的人第一分鐘就能進(jìn)后臺(tái)。3. 核心代碼實(shí)現(xiàn)與關(guān)鍵環(huán)節(jié)3.1 項(xiàng)目目錄結(jié)構(gòu)與啟動(dòng)入口項(xiàng)目使用Maven管理依賴結(jié)構(gòu)如下src/main/java/com/example/travel ├── TravelApplication.java ├── controller ├── service ├── mapper ├── entity ├── config ├── interceptor └── common啟動(dòng)類沒什么特別SpringBootApplication MapperScan(com.example.travel.mapper) public class TravelApplication { public static void main(String[] args) { SpringApplication.run(TravelApplication.class, args); } }注意點(diǎn)有兩個(gè)。第一MapperScan一定要寫否則MyBatis-Plus的Mapper接口不會(huì)被掃描到啟動(dòng)會(huì)報(bào)找不到Bean。第二SpringBoot啟動(dòng)時(shí)如果你遇到端口被占用可以臨時(shí)在application.yml里改server.port或者直接殺掉占用進(jìn)程。application.yml中的關(guān)鍵配置server: port: 8080 spring: datasource: driver-class-name: com.mysql.cj.jdbc.Driver url: jdbc:mysql://localhost:3306/travel?useUnicodetruecharacterEncodingutf8useSSLfalseserverTimezoneAsia/Shanghai username: root password: root thymeleaf: cache: false servlet: multipart: max-file-size: 10MB開發(fā)階段記得把Thymeleaf的緩存關(guān)掉不然改一個(gè)HTML頁面要重啟整個(gè)項(xiàng)目才能看到效果極其浪費(fèi)時(shí)間。3.2 實(shí)現(xiàn)一條完整的酒店預(yù)訂流程以酒店預(yù)訂為例完整鏈路是這樣的用戶進(jìn)入酒店列表頁點(diǎn)擊詳情頁選擇房型、入住日期、入住天數(shù)填寫聯(lián)系人和手機(jī)號(hào)提交訂單后臺(tái)生成一條訂單記錄。實(shí)體類TableName(t_hotel) public class Hotel { TableId(type IdType.AUTO) private Integer id; private String name; private String address; private String price; private String roomType; private String images; private String description; private Integer status; private Date createTime; // getter/setter 省略 }Mapper接口一行代碼都不用寫public interface HotelMapper extends BaseMapperHotel { }Service層做基本的列表分頁和詳情查詢Service public class HotelService { Resource private HotelMapper hotelMapper; public IPageHotel getHotelPage(int pageNum, int pageSize) { PageHotel page new Page(pageNum, pageSize); QueryWrapperHotel wrapper new QueryWrapper(); wrapper.eq(status, 1).orderByDesc(id); return hotelMapper.selectPage(page, wrapper); } }Controller層控制請(qǐng)求跳轉(zhuǎn)和數(shù)據(jù)綁定Controller RequestMapping(/hotel) public class HotelController { Resource private HotelService hotelService; GetMapping(/list) public String list(RequestParam(defaultValue 1) int page, Model model) { model.addAttribute(page, hotelService.getHotelPage(page, 8)); return hotel/list; } GetMapping(/detail/{id}) public String detail(PathVariable Integer id, Model model) { model.addAttribute(hotel, hotelService.getById(id)); return hotel/detail; } }這里很多人會(huì)糾結(jié)Controller層我要不要寫Service直接Mapper不行嗎從功能上確實(shí)可以直接注入Mapper但這樣會(huì)把業(yè)務(wù)邏輯和Web層耦合在一起。答辯時(shí)老師可能會(huì)問“你們項(xiàng)目分了幾層”如果Controller里直接操作數(shù)據(jù)庫就尷尬了。所以哪怕麻煩一點(diǎn)也要保留Controller-Service-Mapper這條鏈路。Thymeleaf頁面渲染時(shí)列表頁核心代碼長這樣div classrow th:eachhotel : ${page.records} div classcol-md-4 div classcard img classcard-img-top th:src${hotel.images} alt div classcard-body h5 classcard-title th:text${hotel.name}酒店名稱/h5 p classcard-text th:text${hotel.address}地址/p p classcard-text text-danger th:text${hotel.price} 元/晚價(jià)格/p a classbtn btn-primary th:href{/hotel/detail/{id}(id${hotel.id})}查看詳情/a /div /div /div /div提交訂單的Controller接受一個(gè)表單對(duì)象生成訂單號(hào)并保存PostMapping(/submit) public String submit(Order order) { order.setOrderNo(T System.currentTimeMillis()); order.setStatus(0); order.setCreateTime(new Date()); orderService.save(order); return redirect:/order/my; }訂單號(hào)用時(shí)間戳生成簡單但不嚴(yán)謹(jǐn)如果并發(fā)量大會(huì)重復(fù)。畢設(shè)里夠用。答辯時(shí)你可以說生產(chǎn)環(huán)境會(huì)改用“日期隨機(jī)數(shù)自增序列”的方式。3.3 Thymeleaf頁面渲染的幾種常用姿勢(shì)Thymeleaf最常見的用法就是th:text、th:href、th:each、th:if但有幾個(gè)細(xì)節(jié)值得注意。th:each遍歷時(shí)如果還想拿到下標(biāo)可以這樣寫tr th:eachorder, iter : ${orderList} td th:text${iter.count}1/td /trth:if條件判斷通常用來做狀態(tài)顯示切換span th:if${order.status 0} classbadge badge-warning待確認(rèn)/span span th:if${order.status 1} classbadge badge-success已確認(rèn)/spanth:inline可以直接在JavaScript里獲取后端數(shù)據(jù)這個(gè)用起來很香。比如地圖頁面或者統(tǒng)計(jì)頁面有時(shí)候需要把后端列表轉(zhuǎn)成JS數(shù)組script th:inlinejavascript var hotelList [[${hotelList}]]; console.log(hotelList); /script但要小心如果數(shù)據(jù)量較大這種內(nèi)聯(lián)方式會(huì)把數(shù)據(jù)直接輸出到HTML源碼里。畢設(shè)沒問題生產(chǎn)環(huán)境要注意接口脫敏。3.4 登錄攔截與權(quán)限控制預(yù)訂網(wǎng)站里有兩個(gè)操作一定需要用戶登錄提交訂單和個(gè)人中心。管理員后臺(tái)則必須要求role0。SpringBoot里最方便的方式是用HandlerInterceptor。先定義攔截器public class LoginInterceptor implements HandlerInterceptor { Override public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception { Object user request.getSession().getAttribute(loginUser); if (user null) { response.sendRedirect(/login); return false; } return true; } }再定義管理員攔截器在用戶登錄基礎(chǔ)上再校驗(yàn)角色public class AdminInterceptor implements HandlerInterceptor { Override public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception { User user (User) request.getSession().getAttribute(loginUser); if (user null || user.getRole() ! 0) { response.sendRedirect(/login); return false; } return true; } }然后在配置類里面注冊(cè)攔截路徑Configuration public class WebConfig implements WebMvcConfigurer { Override public void addInterceptors(InterceptorRegistry registry) { registry.addInterceptor(new LoginInterceptor()) .addPathPatterns(/order/**, /user/**); registry.addInterceptor(new AdminInterceptor()) .addPathPatterns(/admin/**); } }這里要注意靜態(tài)資源路徑比如/css/, /js/, /images/**通常不會(huì)被攔截因?yàn)樗鼈儾皇荂ontroller路徑但如果有自定義資源映射最好也在攔截器里排除掉。4. 數(shù)據(jù)庫腳本的導(dǎo)入與初始化4.1 適合新手的數(shù)據(jù)庫準(zhǔn)備方式拿到項(xiàng)目后第一件事就是建庫導(dǎo)數(shù)據(jù)。我推薦用Navicat或者DataGrip也可以用IDEA自帶的Database面板。如果你電腦上還沒裝MySQL建議直接裝MySQL 8.0版本網(wǎng)上有官方安裝包。數(shù)據(jù)庫腳本文件通常是.sql格式里面包含了CREATE DATABASE、CREATE TABLE和INSERT語句。用Navicat導(dǎo)入時(shí)右鍵連接選擇“運(yùn)行SQL文件”選到項(xiàng)目里的travel.sql即可。導(dǎo)入完成后刷新表列表能看到8張表就已經(jīng)成功了。這里有個(gè)小坑很多從網(wǎng)上下載的項(xiàng)目SQL腳本里寫的字符集是老舊的latin1導(dǎo)入后中文全是亂碼。所以我的腳本開頭固定加上SET NAMES utf8mb4; SET FOREIGN_KEY_CHECKS 0;這樣能最大程度避免亂碼和外鍵約束導(dǎo)致的導(dǎo)入失敗。另外如果你用的是MySQL 8.0而項(xiàng)目連接URL里沒有serverTimezoneAsia/Shanghai啟動(dòng)時(shí)大概率會(huì)報(bào)時(shí)區(qū)錯(cuò)誤。4.2 IDEA數(shù)據(jù)庫工具導(dǎo)入腳本對(duì)于用IDEA開發(fā)的同學(xué)其實(shí)不需要額外裝Navicat。IDEA右側(cè)的Database面板可以直接連接MySQL。連接成功之后選中你的數(shù)據(jù)庫右鍵“Run SQL Script”選擇travel.sql就會(huì)自動(dòng)執(zhí)行。這種方式的好處是SQL執(zhí)行日志會(huì)在IDEA控制臺(tái)里展示如果某條語句報(bào)錯(cuò)你能直接看到是哪張表、哪個(gè)字段的問題。如果項(xiàng)目自帶的SQL腳本是舊版本的導(dǎo)入MySQL 8.0時(shí)可能會(huì)遇到“datetime”類型默認(rèn)值的問題。老版本的SQL語句里如果有create_time datetime DEFAULT 0000-00-00 00:00:00這種寫法在MySQL 8.0的嚴(yán)格模式下會(huì)直接報(bào)錯(cuò)。解決方案有兩個(gè)一是把默認(rèn)值改成NULL二是啟動(dòng)時(shí)去掉sql_mode里的NO_ZERO_DATE。我的項(xiàng)目腳本中已經(jīng)用DEFAULT NULL不會(huì)觸發(fā)這個(gè)問題但如果你從別處拿的腳本要特別留意。4.3 初始化數(shù)據(jù)與實(shí)際運(yùn)行效果腳本里不僅要有表結(jié)構(gòu)還要有幾條能看得見的業(yè)務(wù)數(shù)據(jù)。比如景點(diǎn)表至少放5條國內(nèi)知名景點(diǎn)酒店表放3-5條不同價(jià)位的酒店用戶表放一個(gè)admin。這些數(shù)據(jù)在第一次打開網(wǎng)站時(shí)就能看到效果而不是白屏一張。初始化數(shù)據(jù)盡量真實(shí)一些。比如景點(diǎn)表的圖片路徑可以直接用網(wǎng)上可訪問的圖片URL也可以先放在本地static/images目錄下。如果圖片在外面項(xiàng)目遷移后不會(huì)丟如果在本地離線演示時(shí)也能加載。我建議做兩手準(zhǔn)備腳本里存相對(duì)路徑/images/scenic/xxx.jpg同時(shí)把示例圖片打包在項(xiàng)目里。這樣無論是演示還是答辯都不會(huì)因?yàn)榫W(wǎng)絡(luò)問題導(dǎo)致圖片顯示不了。我個(gè)人在導(dǎo)入腳本后還會(huì)做一次“冒煙測試”啟動(dòng)項(xiàng)目前臺(tái)注冊(cè)一個(gè)測試用戶提交一筆酒店訂單再到后臺(tái)確認(rèn)訂單。如果這一條鏈路能走通說明數(shù)據(jù)庫、后端、前端模板基本都沒問題。剩下的事情就是按自己的需求去改頁面和功能了。5. 從部署到答辯的實(shí)戰(zhàn)經(jīng)驗(yàn)5.1 本地運(yùn)行的正確姿勢(shì)拿到項(xiàng)目后第一件事不是急著改代碼而是先把項(xiàng)目跑起來。第一步確保JDK版本和項(xiàng)目匹配。SpringBoot 2.x通常要求JDK 8或11SpringBoot 3.x要求JDK 17以上。我的項(xiàng)目基于SpringBoot 2.7用JDK 8最穩(wěn)。有些同學(xué)電腦裝的是JDK 18啟動(dòng)時(shí)可能會(huì)報(bào)“IllegalArgumentException”或者一些奇怪的類加載錯(cuò)誤。如果遇到這種問題優(yōu)先把JDK版本降下來。第二步Maven配置。國內(nèi)網(wǎng)絡(luò)環(huán)境下面pom.xml第一次加載依賴會(huì)比較慢。建議在Maven的settings.xml里配置阿里云鏡像。不然卡在下載依賴半個(gè)多小時(shí)體驗(yàn)極差。第三步啟動(dòng)參數(shù)。在IDEA中直接運(yùn)行TravelApplication類的main方法即可。如果控制臺(tái)輸出“Tomcat started on port(s): 8080”說明啟動(dòng)成功。然后瀏覽器訪問http://localhost:8080就能看到網(wǎng)站首頁。這里再提醒一個(gè)常見問題如果你修改了application.yml中的數(shù)據(jù)庫密碼但忘記刪掉target目錄下的舊classes文件可能出現(xiàn)配置不生效的情況。IDEA中遇到這種詭異問題先執(zhí)行mvn clean再重新啟動(dòng)。5.2 常見問題排查速查表我把這些年幫人調(diào)試類似項(xiàng)目時(shí)遇到的最高頻問題整理成一張表供大家參考。問題現(xiàn)象原因分析解決方式啟動(dòng)報(bào)錯(cuò)無法連接數(shù)據(jù)庫application.yml里的用戶名密碼與本地MySQL不一致核對(duì)MySQL賬號(hào)密碼或修改配置頁面中文亂碼數(shù)據(jù)庫連接URL缺少characterEncodingutf8或數(shù)據(jù)庫字符集不是utf8mb4修改JDBC連接參數(shù)確認(rèn)數(shù)據(jù)庫表字符集點(diǎn)了提交訂單沒反應(yīng)登錄攔截器把請(qǐng)求攔截了但頁面沒有跳轉(zhuǎn)提示檢查攔截器路徑配置確認(rèn)用戶已登錄修改了HTML頁面不生效Thymeleaf緩存啟動(dòng)未關(guān)閉在application.yml中設(shè)置cache: false并重啟圖片無法顯示圖片路徑不存在或靜態(tài)資源配置錯(cuò)誤檢查static目錄結(jié)構(gòu)和images字段值端口被占用8080端口被其他程序占用使用netstat或IDEA提示關(guān)閉進(jìn)程或改server.port調(diào)用后臺(tái)接口返回Whitelabel Error頁面路徑和Controller返回值不對(duì)應(yīng)檢查templates目錄下模板路徑是否與邏輯視圖名一致數(shù)據(jù)庫腳本導(dǎo)入報(bào)錯(cuò)表順序不對(duì)存在外鍵依賴先跑SET FOREIGN_KEY_CHECKS0; 或按表依賴順序?qū)脒€有一點(diǎn)如果你的項(xiàng)目在別人電腦上跑得好好的到自己電腦上報(bào)錯(cuò)90%是環(huán)境問題而不是代碼問題。JDK版本、MySQL版本、Maven版本一個(gè)一個(gè)核對(duì)別上來就懷疑源碼有bug。5.3 打包部署到云服務(wù)器現(xiàn)在很多學(xué)校答辯會(huì)要求“現(xiàn)場演示”但有些同學(xué)覺得自己電腦帶過去太麻煩或者擔(dān)心現(xiàn)場網(wǎng)絡(luò)不好會(huì)提前把項(xiàng)目部署到云服務(wù)器上。我也建議這么做因?yàn)榫€上訪問演示比本地方便得多。打包命令很簡單mvn clean package構(gòu)建完成后target目錄下會(huì)生成一個(gè)travel-0.0.1-SNAPSHOT.jar。在服務(wù)器上安裝好JDK和MySQL導(dǎo)入SQL腳本后啟動(dòng)java -jar travel-0.0.1-SNAPSHOT.jar --spring.profiles.activeprod如果不需要多環(huán)境直接把a(bǔ)pplication.yml里的數(shù)據(jù)庫地址改成服務(wù)器上的就行。這里有個(gè)坑如果用云服務(wù)器防火墻要開放8080端口同時(shí)MySQL要允許遠(yuǎn)程連接。MySQL默認(rèn)只監(jiān)聽127.0.0.1需要在my.cnf里注釋掉bind-address并給root賬號(hào)授權(quán)遠(yuǎn)程訪問。但注意這是開發(fā)環(huán)境做法真實(shí)生產(chǎn)環(huán)境千萬不要把root開給公網(wǎng)低版本和弱口令很容易出問題。6. 項(xiàng)目擴(kuò)展建議6.1 代碼層面的進(jìn)一步優(yōu)化如果你想讓這個(gè)項(xiàng)目在答辯時(shí)更有亮點(diǎn)可以從幾個(gè)方向擴(kuò)展。第一把密碼從簡單的MD5改成BCrypt加密。Spring Security里自帶的BCryptPasswordEncoder就能用不用引入完整的Spring Security模塊。改完之后注冊(cè)和登錄邏輯都走加密校驗(yàn)數(shù)據(jù)庫里存的是加密串看起來更專業(yè)。第二增加接口參數(shù)校驗(yàn)。比如訂單提交時(shí)聯(lián)系人手機(jī)號(hào)可以用正則校驗(yàn)價(jià)格字段用DecimalMin限制。SpringBoot自帶的validation依賴就能做代碼量不大但能體現(xiàn)細(xì)節(jié)。第三把硬編碼的常量抽成枚舉或者配置類。比如訂單狀態(tài)0/1/2/3散落在代碼里到后期很容易記混。定義一個(gè)OrderStatus枚舉代碼可讀性和可維護(hù)性都會(huì)好很多。6.2 業(yè)務(wù)功能層面的擴(kuò)展旅游網(wǎng)站還有一個(gè)常見功能是搜索?，F(xiàn)在很多畢設(shè)版的列表頁只有分頁沒有關(guān)鍵詞搜索。加一個(gè)搜索功能其實(shí)不難在Controller里接收一個(gè)keyword參數(shù)傳給Service層時(shí)用QueryWrapper的like條件。比如QueryWrapperScenic wrapper new QueryWrapper(); wrapper.like(StringUtils.isNotBlank(keyword), name, keyword);這樣列表頁就可以通過搜索框過濾景點(diǎn)和酒店。很實(shí)用展示也多一個(gè)點(diǎn)。另一個(gè)值得擴(kuò)展的是數(shù)據(jù)統(tǒng)計(jì)。后臺(tái)加一個(gè)簡單的統(tǒng)計(jì)面板顯示今日訂單數(shù)、累計(jì)用戶數(shù)、熱門景點(diǎn)Top5。我建議用ECharts畫一個(gè)柱狀圖數(shù)據(jù)可以從訂單表里按產(chǎn)品ID分組統(tǒng)計(jì)。這部分代碼不多但答辯效果非常好。因?yàn)槔蠋熞豢茨悴粌H會(huì)增刪改查還能做簡單數(shù)據(jù)分析和可視化印象分會(huì)高不少。6.3 給即將答辯的同學(xué)一些經(jīng)驗(yàn)最后再分享一個(gè)實(shí)際體會(huì)項(xiàng)目能跑只是起點(diǎn)能講清楚才算完成。答辯前花點(diǎn)時(shí)間梳理一下典型問題比如“你這個(gè)系統(tǒng)和其他預(yù)訂網(wǎng)站有什么區(qū)別”“訂單狀態(tài)是怎么流轉(zhuǎn)的”“如果并發(fā)下單你怎么處理”。不需要記長篇大論能用一兩句話把自己的設(shè)計(jì)邏輯講明白就行了。我當(dāng)時(shí)做類似項(xiàng)目時(shí)提前準(zhǔn)備了一張系統(tǒng)架構(gòu)圖從用戶瀏覽器到Controller到Service到Mapper再到數(shù)據(jù)庫每一步都標(biāo)好。答辯的時(shí)候照著圖講一遍整個(gè)流程老師點(diǎn)點(diǎn)頭就知道你是真做了項(xiàng)目的不是只把別人的代碼跑起來。如果你還能現(xiàn)場演示一下“禁用某個(gè)用戶后這個(gè)用戶登錄不了”的細(xì)節(jié)那基本就穩(wěn)了。本文還有配套的精品資源點(diǎn)擊獲取