簡(jiǎn)介這是一套面向計(jì)算機(jī)專(zhuān)業(yè)本科生的畢業(yè)設(shè)計(jì)級(jí)校園二手交易平臺(tái)系統(tǒng)專(zhuān)為Java初學(xué)者、畢設(shè)學(xué)生及課程設(shè)計(jì)實(shí)踐者打造解決校園場(chǎng)景下二手物品高效流轉(zhuǎn)與規(guī)范化管理的實(shí)際需求。資源包共1081個(gè)文件涵蓋67個(gè)核心Java后端類(lèi)、350個(gè)HTML前端頁(yè)面、326個(gè)JS交互腳本、134個(gè)PNG圖標(biāo)資源、68個(gè)CSS樣式文件及1個(gè)完整MySQL數(shù)據(jù)庫(kù)SQL腳本輔以配置文件、說(shuō)明文檔與開(kāi)發(fā)工具總大小5.89MB結(jié)構(gòu)清晰、模塊解耦開(kāi)箱即用。已有5503人學(xué)習(xí)下載驗(yàn)證了其在教學(xué)實(shí)踐中的高復(fù)用性與穩(wěn)定性。用戶可直接獲得含前后端分離架構(gòu)的完整可運(yùn)行系統(tǒng)前端支持商品分類(lèi)瀏覽、在線支付、個(gè)人中心等全流程交易功能后臺(tái)提供用戶/商品/訂單/錢(qián)包四維管理及系統(tǒng)設(shè)置模塊所有代碼經(jīng)嚴(yán)格調(diào)試配套詳細(xì)項(xiàng)目說(shuō)明與典型環(huán)境IDEAJDKTomcatMySQL部署指引顯著降低畢設(shè)落地門(mén)檻。1. 項(xiàng)目概述一個(gè)典型的校園二手交易平臺(tái)最近在整理硬盤(pán)翻出來(lái)一個(gè)幾年前帶學(xué)生做的畢業(yè)設(shè)計(jì)項(xiàng)目一個(gè)基于SpringBoot的校園二手交易平臺(tái)。這個(gè)項(xiàng)目雖然不算復(fù)雜但麻雀雖小五臟俱全涵蓋了從需求分析、技術(shù)選型、前后端開(kāi)發(fā)到數(shù)據(jù)庫(kù)設(shè)計(jì)的完整流程非常適合作為計(jì)算機(jī)、軟件工程相關(guān)專(zhuān)業(yè)同學(xué)的畢業(yè)設(shè)計(jì)選題或者作為SpringBoot初學(xué)者的練手項(xiàng)目。項(xiàng)目源碼和數(shù)據(jù)庫(kù)腳本都打包好了解壓即用對(duì)于想快速上手一個(gè)完整Web應(yīng)用的同學(xué)來(lái)說(shuō)是個(gè)不錯(cuò)的參考。這個(gè)平臺(tái)的核心目標(biāo)很明確為在校學(xué)生提供一個(gè)安全、便捷、可信的二手物品交易環(huán)境。它解決了幾個(gè)校園里的實(shí)際問(wèn)題畢業(yè)生離校時(shí)大量帶不走的書(shū)籍、電器、生活用品需要處理新生入學(xué)時(shí)想淘一些性?xún)r(jià)比高的二手物品以及平時(shí)同學(xué)們之間閑置物品的流轉(zhuǎn)。相比于社會(huì)上的二手平臺(tái)校園平臺(tái)的優(yōu)勢(shì)在于用戶身份相對(duì)單純基本都是在校師生交易地點(diǎn)集中校內(nèi)或周邊溝通和線下交付都更方便信任成本也更低。從技術(shù)角度看這個(gè)項(xiàng)目采用了經(jīng)典的Java Web開(kāi)發(fā)技術(shù)棧后端是SpringBoot MyBatis前端是Thymeleaf模板引擎配合Bootstrap數(shù)據(jù)庫(kù)是MySQL。這套組合拳在幾年前是中小型Web項(xiàng)目的“黃金搭檔”至今依然有很強(qiáng)的學(xué)習(xí)價(jià)值。SpringBoot的自動(dòng)配置和起步依賴(lài)讓項(xiàng)目搭建變得極其簡(jiǎn)單MyBatis作為ORM框架在靈活性和性能之間取得了很好的平衡而B(niǎo)ootstrap則能快速構(gòu)建出美觀、響應(yīng)式的用戶界面。接下來(lái)我就帶大家深入拆解這個(gè)項(xiàng)目的設(shè)計(jì)思路、核心功能實(shí)現(xiàn)以及開(kāi)發(fā)過(guò)程中需要注意的那些“坑”。2. 項(xiàng)目整體架構(gòu)與技術(shù)選型解析2.1 為什么選擇SpringBoot作為技術(shù)核心選擇SpringBoot作為這個(gè)項(xiàng)目的后端框架幾乎是當(dāng)時(shí)最自然、最主流的選擇。對(duì)于畢業(yè)設(shè)計(jì)或者個(gè)人練手項(xiàng)目而言技術(shù)選型的首要原則是“成熟、穩(wěn)定、社區(qū)活躍、學(xué)習(xí)資料豐富”其次才是考慮性能、擴(kuò)展性等高級(jí)特性。SpringBoot完美契合了這些要求。首先它極大地簡(jiǎn)化了Spring應(yīng)用的初始搭建和開(kāi)發(fā)過(guò)程。傳統(tǒng)的Spring MVC項(xiàng)目需要配置大量的XML文件光是整合Spring、Spring MVC、MyBatis這幾個(gè)框架就能讓新手望而卻步。而SpringBoot通過(guò)“約定大于配置”的理念和大量的Starter依賴(lài)幾乎做到了開(kāi)箱即用。比如在這個(gè)二手交易平臺(tái)項(xiàng)目中我們只需要在pom.xml里引入spring-boot-starter-web、spring-boot-starter-thymeleaf和mybatis-spring-boot-starter基礎(chǔ)的Web環(huán)境、模板引擎和數(shù)據(jù)庫(kù)映射框架就自動(dòng)配置好了。這讓學(xué)生能把精力集中在業(yè)務(wù)邏輯的開(kāi)發(fā)上而不是繁瑣的配置上。其次SpringBoot內(nèi)嵌了Tomcat服務(wù)器。這意味著我們開(kāi)發(fā)時(shí)不需要額外安裝和配置Tomcat直接運(yùn)行main方法就能啟動(dòng)一個(gè)Web服務(wù)器調(diào)試非常方便。項(xiàng)目打包成可執(zhí)行的JAR文件后在任何有Java環(huán)境的機(jī)器上都能一鍵運(yùn)行部署成本極低。這對(duì)于需要演示和答辯的畢業(yè)設(shè)計(jì)來(lái)說(shuō)是個(gè)巨大的優(yōu)勢(shì)。最后SpringBoot擁有極其龐大的社區(qū)和生態(tài)。無(wú)論是遇到問(wèn)題去搜索引擎查找還是在GitHub上尋找類(lèi)似的解決方案都能獲得海量的信息。相關(guān)的面試題、源碼解析文章也很多這對(duì)于即將找工作的同學(xué)來(lái)說(shuō)深入學(xué)習(xí)SpringBoot本身就是一項(xiàng)很有價(jià)值的技能投資。注意雖然SpringBoot簡(jiǎn)化了配置但并不意味著不需要理解背后的原理。建議在項(xiàng)目開(kāi)發(fā)過(guò)程中有意識(shí)地去看一下自動(dòng)配置類(lèi)如WebMvcAutoConfiguration和application.properties/application.yml中的配置項(xiàng)理解它們是如何工作的。這對(duì)于排查一些詭異的問(wèn)題比如靜態(tài)資源訪問(wèn)不到、日期格式轉(zhuǎn)換錯(cuò)誤非常有幫助。2.2 數(shù)據(jù)庫(kù)設(shè)計(jì)表結(jié)構(gòu)與關(guān)系建模數(shù)據(jù)庫(kù)是整個(gè)應(yīng)用的數(shù)據(jù)基石設(shè)計(jì)的好壞直接影響到后續(xù)開(kāi)發(fā)的復(fù)雜度和系統(tǒng)的性能。這個(gè)校園二手交易平臺(tái)的核心實(shí)體并不多主要包括用戶、商品、訂單、消息和評(píng)論。核心表結(jié)構(gòu)設(shè)計(jì)如下用戶表 (user): 存儲(chǔ)平臺(tái)用戶信息。除了基本的登錄賬號(hào)、密碼需加密存儲(chǔ)、昵稱(chēng)、手機(jī)號(hào)、郵箱外特別增加了campus_id學(xué)號(hào)/工號(hào)和real_name_verified實(shí)名認(rèn)證狀態(tài)字段。campus_id是構(gòu)建校園信任體系的關(guān)鍵可以與學(xué)校信息系統(tǒng)理論上進(jìn)行比對(duì)實(shí)現(xiàn)初步的身份核驗(yàn)。real_name_verified字段用于標(biāo)識(shí)用戶是否已完成學(xué)生證等證件的上傳審核這可以作為商品發(fā)布或購(gòu)買(mǎi)高級(jí)功能的門(mén)檻。商品表 (goods): 這是最核心的表。字段包括商品標(biāo)題、詳情描述、價(jià)格、原價(jià)、分類(lèi)ID、發(fā)布者ID、狀態(tài)如上架、下架、已售出、圖片URL多個(gè)圖片可用JSON字符串或逗號(hào)分隔存儲(chǔ)、上架時(shí)間、瀏覽量等。其中status字段的設(shè)計(jì)很重要它決定了商品在前端列表中的可見(jiàn)性和可操作性。商品分類(lèi)表 (category): 這是一個(gè)簡(jiǎn)單的字典表如書(shū)籍、數(shù)碼、衣物、日用、其他等。使用獨(dú)立的分類(lèi)表有利于后臺(tái)管理和前端篩選。訂單表 (order): 記錄交易信息。包括訂單號(hào)唯一通常用時(shí)間戳隨機(jī)數(shù)生成、商品ID、買(mǎi)家ID、賣(mài)家ID、成交價(jià)格、訂單狀態(tài)如待付款、待發(fā)貨、待收貨、已完成、已取消、創(chuàng)建時(shí)間、支付時(shí)間、收貨地址等。這里需要注意訂單價(jià)格應(yīng)與商品快照價(jià)格分離因?yàn)樯唐穬r(jià)格可能變動(dòng)但訂單成交價(jià)是固定的。消息表 (message): 實(shí)現(xiàn)用戶間的溝通。包含發(fā)送者ID、接收者ID、關(guān)聯(lián)的商品ID、消息內(nèi)容、發(fā)送時(shí)間、已讀狀態(tài)等。這是平臺(tái)促成交易的關(guān)鍵功能。評(píng)論/留言表 (comment): 用戶可以對(duì)已完成的交易進(jìn)行評(píng)價(jià)。包含訂單ID、評(píng)論者ID、被評(píng)論者ID、評(píng)分、內(nèi)容、評(píng)論時(shí)間等。表關(guān)系與索引優(yōu)化關(guān)系商品與用戶發(fā)布者是多對(duì)一關(guān)系訂單與商品、買(mǎi)家、賣(mài)家都是多對(duì)一關(guān)系消息與發(fā)送者、接收者、商品是多對(duì)一關(guān)系。索引為了提高查詢(xún)效率必須在頻繁作為查詢(xún)條件的字段上建立索引。例如goods表在category_id,user_id,status上建立普通索引在title上可以考慮建立全文索引如果搜索需求強(qiáng)。order表在buyer_id,seller_id,goods_id,status上建立索引。message表在receiver_id和read_status的復(fù)合索引可以快速查詢(xún)某個(gè)用戶的未讀消息。實(shí)操心得數(shù)據(jù)庫(kù)設(shè)計(jì)初期一定要畫(huà)ER圖。工具可以用Draw.io、MySQL Workbench甚至紙筆。把實(shí)體、屬性和關(guān)系理清楚能避免后期大量返工。另外所有表都應(yīng)該包含create_time和update_time這兩個(gè)字段用于記錄數(shù)據(jù)變更時(shí)間這在排查問(wèn)題和數(shù)據(jù)審計(jì)時(shí)非常有用。可以使用MySQL的CURRENT_TIMESTAMP作為默認(rèn)值。2.3 前端技術(shù)棧Thymeleaf Bootstrap 的快速開(kāi)發(fā)之道對(duì)于后端開(kāi)發(fā)者主導(dǎo)的畢業(yè)設(shè)計(jì)項(xiàng)目前端技術(shù)棧的選擇原則是簡(jiǎn)單、夠用、好看。Thymeleaf Bootstrap的組合正是為此而生。Thymeleaf是一個(gè)Java模板引擎它最大的優(yōu)點(diǎn)是能與SpringBoot無(wú)縫集成并且所有模板都是純HTML可以直接在瀏覽器中打開(kāi)預(yù)覽對(duì)后端開(kāi)發(fā)者非常友好。它的語(yǔ)法以th:開(kāi)頭用于動(dòng)態(tài)替換內(nèi)容如th:text${user.nickname}、th:href{/goods/detail/{id}(id${goods.id})}。在這個(gè)項(xiàng)目中我們用它來(lái)渲染商品列表、用戶信息、動(dòng)態(tài)生成頁(yè)面鏈接和控制邏輯如th:if判斷用戶登錄狀態(tài)。Bootstrap是一個(gè)前端CSS/JS框架提供了大量預(yù)定義的、響應(yīng)式的UI組件按鈕、表單、導(dǎo)航欄、卡片、模態(tài)框等。我們幾乎不需要自己寫(xiě)復(fù)雜的CSS只需要在HTML元素上添加對(duì)應(yīng)的Bootstrap類(lèi)名如classbtn btn-primary、classcard就能快速構(gòu)建出風(fēng)格統(tǒng)一、在手機(jī)和電腦上都能良好顯示的界面。這對(duì)于不擅長(zhǎng)前端設(shè)計(jì)的同學(xué)來(lái)說(shuō)無(wú)疑是雪中送炭。兩者的結(jié)合模式通常是在SpringBoot的resources/templates目錄下編寫(xiě).html文件。使用Bootstrap的柵格系統(tǒng)container,row,col-*和組件進(jìn)行頁(yè)面布局。在需要?jiǎng)討B(tài)數(shù)據(jù)的地方使用Thymeleaf語(yǔ)法從后端控制器Controller傳入的模型Model中取值。通過(guò)Thymeleaf的片段th:fragment和替換th:replace功能實(shí)現(xiàn)頁(yè)頭、頁(yè)腳等公共部分的復(fù)用。這種模式使得前后端耦合在一個(gè)項(xiàng)目中開(kāi)發(fā)、調(diào)試、部署都相對(duì)簡(jiǎn)單非常適合單體架構(gòu)的畢業(yè)設(shè)計(jì)。當(dāng)然它的缺點(diǎn)是前后端職責(zé)分離不徹底對(duì)于復(fù)雜交互的頁(yè)面邏輯會(huì)顯得有些混亂。但對(duì)于一個(gè)以商品展示、發(fā)布、簡(jiǎn)單溝通為主的二手平臺(tái)來(lái)說(shuō)完全夠用。3. 核心功能模塊實(shí)現(xiàn)詳解3.1 用戶系統(tǒng)注冊(cè)、登錄與校園身份核驗(yàn)用戶系統(tǒng)是平臺(tái)的起點(diǎn)核心在于安全與可信。1. 密碼安全存儲(chǔ)絕對(duì)不能用明文存儲(chǔ)密碼。我們采用Spring Security提供的BCryptPasswordEncoder進(jìn)行加密。在用戶注冊(cè)時(shí)調(diào)用encoder.encode(rawPassword)將原始密碼加密后存入數(shù)據(jù)庫(kù)。登錄時(shí)調(diào)用encoder.matches(rawPassword, encodedPassword)進(jìn)行比對(duì)。BCrypt算法會(huì)自動(dòng)加“鹽”salt并且計(jì)算速度可調(diào)能有效抵御彩虹表攻擊。// 配置Bean (在配置類(lèi)或主類(lèi)中) Bean public PasswordEncoder passwordEncoder() { return new BCryptPasswordEncoder(); } // 注冊(cè)時(shí)加密 user.setPassword(passwordEncoder.encode(user.getPassword())); // 登錄時(shí)驗(yàn)證 if (!passwordEncoder.matches(inputPassword, user.getPasswordFromDB())) { // 密碼錯(cuò)誤 }2. 會(huì)話管理我們使用HttpSession來(lái)管理用戶登錄狀態(tài)。用戶登錄成功后將用戶對(duì)象或關(guān)鍵信息如ID、昵稱(chēng)存入Sessionrequest.getSession().setAttribute(loginUser, user)。后續(xù)請(qǐng)求中通過(guò)攔截器Interceptor檢查Session中是否存在登錄用戶來(lái)實(shí)現(xiàn)訪問(wèn)控制。3. 校園身份核驗(yàn)簡(jiǎn)化版完全的實(shí)名認(rèn)證需要對(duì)接學(xué)校官方系統(tǒng)這對(duì)于畢業(yè)設(shè)計(jì)來(lái)說(shuō)不現(xiàn)實(shí)。我們采用一種“簡(jiǎn)化核驗(yàn)”方案注冊(cè)時(shí)強(qiáng)制填寫(xiě)學(xué)號(hào)/工號(hào)campus_id和真實(shí)姓名。提供一個(gè)“實(shí)名認(rèn)證”功能入口。用戶上傳學(xué)生證/一卡通帶照片頁(yè)的圖片。后臺(tái)管理員模擬平臺(tái)審核員在管理后臺(tái)查看上傳的圖片人工比對(duì)學(xué)號(hào)和姓名實(shí)際上我們無(wú)法驗(yàn)證真?zhèn)未肆鞒讨饕鹜睾托问綄彶樽饔萌缓笫謩?dòng)審核通過(guò)。審核通過(guò)后用戶real_name_verified字段置為true。前端可以對(duì)已認(rèn)證用戶顯示特殊標(biāo)識(shí)并且可以設(shè)置只有認(rèn)證用戶才能發(fā)布商品或購(gòu)買(mǎi)高價(jià)商品通過(guò)攔截器或AOP實(shí)現(xiàn)。這個(gè)設(shè)計(jì)雖然無(wú)法做到真實(shí)核驗(yàn)但完整地模擬了商業(yè)平臺(tái)“提交材料-后臺(tái)審核-授權(quán)”的流程體現(xiàn)了你的設(shè)計(jì)思維。3.2 商品模塊發(fā)布、展示、搜索與狀態(tài)管理這是平臺(tái)的核心功能模塊。1. 商品發(fā)布發(fā)布表單涉及文件上傳圖片和富文本編輯詳情描述。圖片上傳SpringBoot中可以使用MultipartFile接口接收文件。通常做法是檢查文件大小、類(lèi)型防止上傳惡意文件。生成一個(gè)唯一的文件名如UUID 原擴(kuò)展名避免重名覆蓋。將文件保存到服務(wù)器本地目錄如/upload/images/或云存儲(chǔ)如七牛云、阿里云OSS畢業(yè)設(shè)計(jì)推薦本地即可。將文件的訪問(wèn)路徑如/upload/images/xxx.jpg存入數(shù)據(jù)庫(kù)的goods表。注意需要在SpringBoot配置中映射靜態(tài)資源路徑使得/upload/**能指向本地目錄。富文本編輯為了簡(jiǎn)單可以直接使用HTML的textarea。如果想獲得更好的編輯體驗(yàn)可以集成一個(gè)輕量級(jí)的富文本編輯器如wangEditor。這里有一個(gè)非常重要的安全注意事項(xiàng)用戶提交的HTML內(nèi)容必須進(jìn)行轉(zhuǎn)義或過(guò)濾防止XSS跨站腳本攻擊。Thymeleaf默認(rèn)會(huì)對(duì)th:text輸出的內(nèi)容進(jìn)行HTML轉(zhuǎn)義但如果你使用th:utext不轉(zhuǎn)義或者直接將內(nèi)容輸出到JavaScript中就會(huì)存在風(fēng)險(xiǎn)。建議對(duì)富文本內(nèi)容使用專(zhuān)門(mén)的HTML過(guò)濾器如Jsoup進(jìn)行“白名單”過(guò)濾只允許安全的標(biāo)簽如p,b,img,br和屬性通過(guò)。2. 商品展示與列表分頁(yè)商品列表頁(yè)需要支持分頁(yè)。我們使用MyBatis的分頁(yè)插件PageHelper。在pom.xml中引入pagehelper-spring-boot-starter依賴(lài)。在查詢(xún)商品列表的Service方法中在查詢(xún)語(yǔ)句前調(diào)用PageHelper.startPage(pageNum, pageSize)其中pageNum和pageSize來(lái)自前端請(qǐng)求參數(shù)。隨后執(zhí)行的MyBatis查詢(xún)會(huì)自動(dòng)變?yōu)榉猪?yè)查詢(xún)。查詢(xún)結(jié)果是一個(gè)PageGoods對(duì)象它包含了當(dāng)前頁(yè)的數(shù)據(jù)列表getResult()和豐富的分頁(yè)信息總頁(yè)數(shù)、總記錄數(shù)等直接返回給前端即可。前端使用Bootstrap的分頁(yè)組件來(lái)渲染頁(yè)碼。3. 商品搜索搜索功能通常基于商品標(biāo)題和詳情描述。對(duì)于小數(shù)據(jù)量直接使用MySQL的LIKE語(yǔ)句WHERE title LIKE CONCAT(%, #{keyword}, %)即可。如果數(shù)據(jù)量增大可以考慮使用MySQL的全文索引FULLTEXT或者引入專(zhuān)業(yè)的搜索引擎如Elasticsearch但這對(duì)于畢業(yè)設(shè)計(jì)來(lái)說(shuō)屬于加分項(xiàng)非必需。4. 商品狀態(tài)機(jī)商品的狀態(tài)流轉(zhuǎn)是業(yè)務(wù)邏輯的關(guān)鍵。我們定義了簡(jiǎn)單的狀態(tài)0-審核中、1-已上架、2-已下架、3-已售出。狀態(tài)變更需要嚴(yán)謹(jǐn)控制用戶發(fā)布商品后狀態(tài)為0-審核中如果不需要審核可直接為1。管理員后臺(tái)審核通過(guò)狀態(tài)變?yōu)?-已上架。用戶自己可以手動(dòng)下架1 - 2。商品被拍下并生成訂單后狀態(tài)應(yīng)變?yōu)?-已售出并同時(shí)從商品列表頁(yè)過(guò)濾掉防止重復(fù)銷(xiāo)售。訂單如果被取消商品狀態(tài)應(yīng)回退到1-已上架。 這些狀態(tài)變更的邏輯最好在Service層進(jìn)行封裝確保原子性和一致性。3.3 交易與溝通流程訂單、消息與簡(jiǎn)易支付模擬完整的在線支付涉及第三方接口支付寶、微信支付對(duì)于本地運(yùn)行的畢業(yè)設(shè)計(jì)項(xiàng)目來(lái)說(shuō)過(guò)于復(fù)雜且需要企業(yè)資質(zhì)。我們采用“模擬支付”的方案。1. 訂單生成流程買(mǎi)家在商品詳情頁(yè)點(diǎn)擊“立即購(gòu)買(mǎi)”。后端校驗(yàn)商品是否存在、狀態(tài)是否為“已上架”、買(mǎi)家不是賣(mài)家本人。創(chuàng)建訂單記錄生成唯一訂單號(hào)填充商品、買(mǎi)家、賣(mài)家、價(jià)格等信息狀態(tài)設(shè)為“待付款”。同時(shí)將對(duì)應(yīng)商品的狀態(tài)更新為“已售出”或“交易中”鎖定該商品。跳轉(zhuǎn)到訂單詳情頁(yè)。2. 模擬支付在訂單詳情頁(yè)有一個(gè)“去支付”按鈕。點(diǎn)擊后并不真正調(diào)用支付接口而是直接向后端發(fā)送一個(gè)“確認(rèn)支付”的請(qǐng)求。后端接收到請(qǐng)求后校驗(yàn)訂單狀態(tài)是否為“待付款”。將訂單狀態(tài)更新為“待發(fā)貨”?？蛇x記錄支付時(shí)間。向賣(mài)家發(fā)送一條系統(tǒng)消息如“您的商品[xxx]已被拍下請(qǐng)盡快發(fā)貨”。 這個(gè)過(guò)程模擬了支付成功的回調(diào)。你可以在前端用模態(tài)框Modal做一個(gè)“支付成功”的動(dòng)畫(huà)來(lái)增強(qiáng)體驗(yàn)。3. 消息系統(tǒng)消息系統(tǒng)用于買(mǎi)賣(mài)雙方溝通。實(shí)現(xiàn)一個(gè)簡(jiǎn)單的站內(nèi)信即可。數(shù)據(jù)庫(kù)如前所述有message表。后端接口提供發(fā)送消息、獲取與某個(gè)用戶的對(duì)話列表、獲取未讀消息數(shù)、標(biāo)記消息已讀等接口。前端實(shí)現(xiàn)可以在商品詳情頁(yè)嵌入一個(gè)簡(jiǎn)單的表單輸入內(nèi)容后異步Ajax發(fā)送消息。更高級(jí)一點(diǎn)可以做一個(gè)類(lèi)似聊天窗口的UI使用輪詢(xún)Polling或WebSocket來(lái)“實(shí)時(shí)”接收新消息。對(duì)于畢業(yè)設(shè)計(jì)短輪詢(xún)每5-10秒請(qǐng)求一次實(shí)現(xiàn)簡(jiǎn)單完全可以接受。關(guān)鍵點(diǎn)每條消息都必須關(guān)聯(lián)一個(gè)goods_id這樣在對(duì)話列表中可以清晰知道是在討論哪件商品。未讀消息數(shù)的提示網(wǎng)站右上角的小紅點(diǎn)是一個(gè)很好的用戶體驗(yàn)細(xì)節(jié)。4. 訂單狀態(tài)流轉(zhuǎn)訂單狀態(tài)是交易流程的主線。我們?cè)O(shè)計(jì)一個(gè)簡(jiǎn)單的狀態(tài)序列待付款 - 待發(fā)貨 - 待收貨 - 已完成。買(mǎi)賣(mài)雙方的操作驅(qū)動(dòng)狀態(tài)變化買(mǎi)家支付待付款 - 待發(fā)貨。賣(mài)家發(fā)貨賣(mài)家在后臺(tái)點(diǎn)擊“發(fā)貨”狀態(tài)變?yōu)榇肇洝＿@里可以要求賣(mài)家填寫(xiě)一個(gè)發(fā)貨單號(hào)模擬快遞單號(hào)。買(mǎi)家確認(rèn)收貨買(mǎi)家點(diǎn)擊“確認(rèn)收貨”狀態(tài)變?yōu)橐淹瓿伞Ｍ瑫r(shí)可以觸發(fā)雙方互評(píng)的入口。取消訂單在待付款和待發(fā)貨狀態(tài)買(mǎi)賣(mài)雙方根據(jù)規(guī)則可以取消訂單。取消后訂單狀態(tài)為已取消同時(shí)關(guān)聯(lián)的商品狀態(tài)要回退到已上架。整個(gè)流程需要在Service層做好事務(wù)管理確保訂單狀態(tài)和商品狀態(tài)變更的原子性。4. 項(xiàng)目部署、測(cè)試與常見(jiàn)問(wèn)題排查4.1 本地開(kāi)發(fā)環(huán)境搭建與運(yùn)行拿到源碼后如何快速跑起來(lái)以下是標(biāo)準(zhǔn)步驟環(huán)境準(zhǔn)備確保本地已安裝JDK 8或11與項(xiàng)目pom.xml中指定的版本一致、Maven、MySQL 5.7或8.0以及IDE推薦IntelliJ IDEA。導(dǎo)入項(xiàng)目在IDEA中選擇“Open”或“Import Project”找到項(xiàng)目根目錄包含pom.xml的文件夾以Maven項(xiàng)目形式導(dǎo)入。IDEA會(huì)自動(dòng)下載所有依賴(lài)。數(shù)據(jù)庫(kù)初始化在MySQL中創(chuàng)建一個(gè)新的數(shù)據(jù)庫(kù)例如campus_trade。用文本編輯器打開(kāi)項(xiàng)目中的sql/init_database.sql腳本文件具體路徑可能不同。在MySQL客戶端如命令行、Navicat、IDEA自帶的Database工具中連接到campus_trade數(shù)據(jù)庫(kù)然后執(zhí)行整個(gè)SQL腳本。這會(huì)創(chuàng)建所有表結(jié)構(gòu)和必要的初始數(shù)據(jù)如管理員賬號(hào)、商品分類(lèi)。修改配置文件找到src/main/resources/application.yml或application.properties文件。修改其中的數(shù)據(jù)庫(kù)連接配置包括URL、用戶名和密碼確保它們指向你剛創(chuàng)建的數(shù)據(jù)庫(kù)。spring: datasource: url: jdbc:mysql://localhost:3306/campus_trade?useUnicodetruecharacterEncodingutf-8serverTimezoneAsia/Shanghai username: root password: your_password driver-class-name: com.mysql.cj.jdbc.Driver啟動(dòng)項(xiàng)目找到主啟動(dòng)類(lèi)通常命名為Application或*Application帶有SpringBootApplication注解直接運(yùn)行它的main方法。訪問(wèn)系統(tǒng)控制臺(tái)無(wú)報(bào)錯(cuò)且出現(xiàn)“Started ... Application in x.xxx seconds”字樣后打開(kāi)瀏覽器訪問(wèn)http://localhost:8080端口號(hào)查看控制臺(tái)輸出。你應(yīng)該能看到網(wǎng)站首頁(yè)。踩坑記錄最常見(jiàn)的啟動(dòng)失敗問(wèn)題就是數(shù)據(jù)庫(kù)連接不上。請(qǐng)務(wù)必檢查①M(fèi)ySQL服務(wù)是否啟動(dòng)②application.yml中的數(shù)據(jù)庫(kù)名、用戶名、密碼是否正確③MySQL的版本是否與驅(qū)動(dòng)兼容MySQL 8.0需要com.mysql.cj.jdbc.Driver驅(qū)動(dòng)和連接參數(shù)中的serverTimezone④本地MySQL是否允許遠(yuǎn)程連接如果配置了非localhost的IP。另一個(gè)常見(jiàn)問(wèn)題是端口占用如果8080端口被占用可以在application.yml中修改server.port。4.2 關(guān)鍵功能測(cè)試用例與調(diào)試技巧開(kāi)發(fā)完成后系統(tǒng)的測(cè)試至關(guān)重要。以下是一些必須測(cè)試的核心場(chǎng)景1. 用戶注冊(cè)登錄流程測(cè)試正常注冊(cè)、登錄。測(cè)試注冊(cè)時(shí)密碼加密是否生效查看數(shù)據(jù)庫(kù)中的密碼字段是否為BCrypt加密后的長(zhǎng)字符串。測(cè)試登錄失敗密碼錯(cuò)誤、用戶不存在的提示是否友好。測(cè)試未登錄狀態(tài)下訪問(wèn)需要權(quán)限的頁(yè)面如“發(fā)布商品”、“我的訂單”是否被重定向到登錄頁(yè)。2. 商品發(fā)布與狀態(tài)流轉(zhuǎn)測(cè)試發(fā)布商品包含多張圖片上傳觀察圖片是否成功保存并能正確顯示。測(cè)試發(fā)布后商品是否出現(xiàn)在列表頁(yè)可能需要管理員審核后。測(cè)試自己下架商品商品是否從列表頁(yè)消失。模擬交易全流程這是測(cè)試的重中之重。你需要注冊(cè)兩個(gè)賬號(hào)A賣(mài)家和B買(mǎi)家。用A發(fā)布一件商品。用B登錄瀏覽并“購(gòu)買(mǎi)”該商品。檢查①訂單是否生成狀態(tài)“待付款”②該商品在前臺(tái)列表是否變?yōu)椤耙咽鄢觥被虿豢梢?jiàn)。用B進(jìn)行“模擬支付”。檢查訂單狀態(tài)是否變?yōu)椤按l(fā)貨”賣(mài)家A是否收到了系統(tǒng)消息。用A登錄在“我的訂單”或“出售的商品”中點(diǎn)擊“發(fā)貨”。檢查訂單狀態(tài)是否變?yōu)椤按肇洝?。用B登錄點(diǎn)擊“確認(rèn)收貨”。檢查訂單狀態(tài)是否變?yōu)椤耙淹瓿伞笔欠癯霈F(xiàn)了評(píng)價(jià)入口。雙方互相評(píng)價(jià)。檢查評(píng)價(jià)內(nèi)容是否成功保存并顯示。3. 搜索與分頁(yè)功能測(cè)試輸入關(guān)鍵詞搜索結(jié)果是否準(zhǔn)確。測(cè)試列表頁(yè)點(diǎn)擊第二頁(yè)、第三頁(yè)分頁(yè)參數(shù)是否正確傳遞數(shù)據(jù)是否正常切換。調(diào)試技巧善用日志在Service層的關(guān)鍵方法入口和出口使用log.debug()或log.info()打印參數(shù)和結(jié)果。SpringBoot默認(rèn)使用Logback配置簡(jiǎn)單。使用IDE調(diào)試器在可能出問(wèn)題的代碼行打上斷點(diǎn)Breakpoint然后以Debug模式啟動(dòng)項(xiàng)目。當(dāng)請(qǐng)求執(zhí)行到斷點(diǎn)時(shí)程序會(huì)暫停你可以查看此時(shí)所有變量的值單步執(zhí)行Step Over/Into這是定位邏輯錯(cuò)誤最強(qiáng)大的工具。檢查瀏覽器開(kāi)發(fā)者工具F12打開(kāi)開(kāi)發(fā)者工具查看“網(wǎng)絡(luò)Network”標(biāo)簽頁(yè)。這里可以看到前端發(fā)送的每一個(gè)請(qǐng)求的URL、參數(shù)、響應(yīng)狀態(tài)碼和響應(yīng)體。如果后端報(bào)錯(cuò)響應(yīng)體里通常會(huì)有錯(cuò)誤信息。同時(shí)查看“控制臺(tái)Console”有無(wú)JavaScript錯(cuò)誤。4.3 常見(jiàn)問(wèn)題排查與解決方案實(shí)錄在實(shí)際開(kāi)發(fā)和運(yùn)行中你幾乎一定會(huì)遇到下面這些問(wèn)題問(wèn)題1啟動(dòng)時(shí)報(bào)java.sql.SQLException: Access denied for user rootlocalhost (using password: YES)排查數(shù)據(jù)庫(kù)用戶名或密碼錯(cuò)誤。檢查application.yml中的username和password。如果密碼包含特殊字符可能需要用引號(hào)括起來(lái)。解決確認(rèn)MySQL的root密碼或者創(chuàng)建一個(gè)專(zhuān)門(mén)用于此項(xiàng)目的新用戶并授權(quán)。問(wèn)題2頁(yè)面顯示W(wǎng)hitelabel Error Page或404排查首先看控制臺(tái)是否有異常堆棧信息。如果沒(méi)有可能是請(qǐng)求路徑不對(duì)。解決檢查瀏覽器地址欄的URL是否與Controller中RequestMapping定義的路徑匹配。檢查靜態(tài)資源CSS, JS, 圖片是否加載404。確保application.yml中正確配置了靜態(tài)資源路徑如spring.mvc.static-path-pattern/static/**并且資源文件放在resources/static/目錄下。問(wèn)題3插入或更新數(shù)據(jù)時(shí)中文變成亂碼???排查數(shù)據(jù)庫(kù)字符集問(wèn)題。解決確認(rèn)MySQL數(shù)據(jù)庫(kù)、表、字段的字符集是否為utf8mb4推薦支持emoji。檢查JDBC連接URL是否包含了字符集參數(shù)?useUnicodetruecharacterEncodingutf-8。檢查IDE和文件本身的編碼是否為UTF-8。問(wèn)題4使用PageHelper分頁(yè)后查詢(xún)結(jié)果不是分頁(yè)數(shù)據(jù)而是全部數(shù)據(jù)排查PageHelper.startPage(pageNum, pageSize)這行代碼必須緊挨在MyBatis查詢(xún)方法如mapper.selectList()之前執(zhí)行中間不能有其它數(shù)據(jù)庫(kù)查詢(xún)操作否則分頁(yè)設(shè)置會(huì)失效或作用于錯(cuò)誤的語(yǔ)句。解決檢查Service層代碼確保startPage和查詢(xún)語(yǔ)句是連續(xù)的。問(wèn)題5文件上傳成功但頁(yè)面無(wú)法顯示圖片排查圖片的訪問(wèn)路徑不對(duì)。解決確認(rèn)文件保存的物理路徑如D:/project/upload/。確認(rèn)在SpringBoot中是否配置了靜態(tài)資源映射將某個(gè)URL路徑映射到該物理路徑。例如Configuration public class WebConfig implements WebMvcConfigurer { Override public void addResourceHandlers(ResourceHandlerRegistry registry) { registry.addResourceHandler(/upload/**) .addResourceLocations(file:D:/project/upload/); } }前端img標(biāo)簽的src屬性應(yīng)該是/upload/images/xxx.jpg這樣的形式。問(wèn)題6事務(wù)不生效比如扣款和生成訂單有一個(gè)失敗數(shù)據(jù)不一致排查檢查Service方法是否添加了Transactional注解并且方法是否是public的。Spring的事務(wù)代理是基于AOP的對(duì)非public方法無(wú)效。另外確保數(shù)據(jù)庫(kù)引擎是InnoDB支持事務(wù)而不是MyISAM。解決在涉及多個(gè)數(shù)據(jù)庫(kù)寫(xiě)操作的Service方法上添加Transactional(rollbackFor Exception.class)。問(wèn)題7項(xiàng)目打包成JAR后運(yùn)行上傳文件失敗或找不到模板文件排查SpringBoot打包后資源文件都在JAR包內(nèi)部默認(rèn)是只讀的。如果你把上傳目錄設(shè)置在classpath:下如resources/static/upload/運(yùn)行JAR時(shí)是無(wú)法寫(xiě)入的。解決將文件上傳目錄設(shè)置為JAR包外部的絕對(duì)路徑如/var/app/upload/Linux或C:/app/upload/Windows并通過(guò)上述的addResourceHandlers方法映射URL。這樣應(yīng)用重啟后上傳的文件也不會(huì)丟失。5. 項(xiàng)目擴(kuò)展與優(yōu)化思路完成基礎(chǔ)功能后如果你想給項(xiàng)目增加亮點(diǎn)可以考慮以下擴(kuò)展方向這些都能在你的畢業(yè)設(shè)計(jì)答辯中為你加分。1. 引入Redis緩存場(chǎng)景商品分類(lèi)信息、熱門(mén)商品列表、用戶會(huì)話信息替代Session等不常變化但頻繁讀取的數(shù)據(jù)。實(shí)現(xiàn)在pom.xml中引入spring-boot-starter-data-redis依賴(lài)。配置Redis連接信息。使用StringRedisTemplate或RedisTemplate來(lái)操作緩存。例如在查詢(xún)商品分類(lèi)時(shí)先查Redis沒(méi)有則查數(shù)據(jù)庫(kù)并存入Redis設(shè)置一個(gè)合理的過(guò)期時(shí)間。價(jià)值顯著減輕數(shù)據(jù)庫(kù)壓力提升響應(yīng)速度。2. 集成Elasticsearch實(shí)現(xiàn)全文搜索場(chǎng)景商品標(biāo)題和描述的模糊搜索LIKE語(yǔ)句在數(shù)據(jù)量大時(shí)性能極差。實(shí)現(xiàn)搭建Elasticsearch服務(wù)。引入spring-boot-starter-data-elasticsearch。為商品(Goods)實(shí)體類(lèi)建立對(duì)應(yīng)的索引和映射。在商品發(fā)布或更新時(shí)同步數(shù)據(jù)到ES。提供搜索接口使用ES的DSL進(jìn)行查詢(xún)。價(jià)值實(shí)現(xiàn)毫秒級(jí)的高性能、高相關(guān)度搜索支持分詞、拼音搜索等高級(jí)功能。3. 實(shí)現(xiàn)WebSocket實(shí)時(shí)消息推送場(chǎng)景替換掉輪詢(xún)的站內(nèi)信實(shí)現(xiàn)真正的實(shí)時(shí)聊天。當(dāng)賣(mài)家發(fā)貨或買(mǎi)家確認(rèn)收貨時(shí)實(shí)時(shí)通知對(duì)方。實(shí)現(xiàn)引入spring-boot-starter-websocket。配置一個(gè)WebSocketConfig。創(chuàng)建一個(gè)WebSocketHandler來(lái)處理連接、收發(fā)消息。前端使用new WebSocket(ws://...)建立連接并監(jiān)聽(tīng)消息。價(jià)值極大提升用戶體驗(yàn)使平臺(tái)更具交互感。4. 增加后臺(tái)管理模塊場(chǎng)景需要一個(gè)獨(dú)立的界面供管理員審核商品、處理用戶實(shí)名認(rèn)證、查看平臺(tái)數(shù)據(jù)統(tǒng)計(jì)、管理用戶等。實(shí)現(xiàn)可以復(fù)用現(xiàn)有技術(shù)棧在/admin路徑下構(gòu)建一套新的Controller和頁(yè)面。使用攔截器校驗(yàn)管理員權(quán)限。前端可以使用更專(zhuān)業(yè)的管理后臺(tái)模板如AdminLTE來(lái)快速搭建。價(jià)值使項(xiàng)目更加完整體現(xiàn)系統(tǒng)化思維。5. 容器化部署Docker場(chǎng)景解決“在我電腦上能跑在別人那不行”的環(huán)境依賴(lài)問(wèn)題實(shí)現(xiàn)一鍵部署。實(shí)現(xiàn)編寫(xiě)Dockerfile基于OpenJDK鏡像將打包好的JAR包復(fù)制進(jìn)去并定義啟動(dòng)命令。編寫(xiě)docker-compose.yml定義應(yīng)用服務(wù)、MySQL服務(wù)、Redis服務(wù)如果用到了的容器編排并配置網(wǎng)絡(luò)和數(shù)據(jù)卷。價(jià)值展示你對(duì)現(xiàn)代部署運(yùn)維技術(shù)的了解是簡(jiǎn)歷上的一個(gè)亮點(diǎn)。這個(gè)基于SpringBoot的校園二手交易平臺(tái)項(xiàng)目從技術(shù)上看它幫你串聯(lián)了Java Web開(kāi)發(fā)的核心技能點(diǎn)從業(yè)務(wù)上看它讓你思考了一個(gè)真實(shí)產(chǎn)品的功能閉環(huán)與用戶體驗(yàn)。無(wú)論是用于畢業(yè)設(shè)計(jì)還是個(gè)人學(xué)習(xí)吃透這個(gè)項(xiàng)目都能為你打下堅(jiān)實(shí)的實(shí)踐基礎(chǔ)。開(kāi)發(fā)過(guò)程中多思考“為什么這么設(shè)計(jì)”多動(dòng)手解決遇到的每一個(gè)報(bào)錯(cuò)你的收獲會(huì)遠(yuǎn)大于僅僅復(fù)制代碼。最后記得代碼規(guī)范、寫(xiě)好注釋、保留清晰的文檔這不僅是好習(xí)慣也是在向未來(lái)的同事或?qū)熣故灸愕膶?zhuān)業(yè)素養(yǎng)。本文還有配套的精品資源點(diǎn)擊獲取