簡介本資源是一套完整的基于SpringBoot開發(fā)的校園二手交易平臺系統(tǒng)源碼及配套資料專為計算機專業(yè)本科生畢業(yè)設(shè)計、課程設(shè)計與Java項目實戰(zhàn)學(xué)習(xí)者打造有效解決畢設(shè)選題難、系統(tǒng)開發(fā)周期長、前后端聯(lián)調(diào)復(fù)雜等實際問題。壓縮包共1081個文件涵蓋67個核心Java后端類、350個HTML頁面與326個JS交互腳本支撐前端商品展示、用戶中心、在線支付等模塊輔以134個PNG圖標(biāo)、68個CSS樣式文件及完整MySQL數(shù)據(jù)庫SQL腳本整體體積僅5.89MB結(jié)構(gòu)清晰、開箱即用。已有5503人學(xué)習(xí)下載項目經(jīng)嚴格調(diào)試支持IDEA/Eclipse多環(huán)境一鍵部署含詳細項目說明文檔與軟件工具集。讀者可直接獲得可運行的全棧系統(tǒng)從前端產(chǎn)品分類、公告發(fā)布、個人中心到后臺用戶/商品/訂單/錢包四大管理模塊功能完備、界面規(guī)范、邏輯嚴謹具備真實校園場景落地能力。1. 項目概述與核心價值最近在整理硬盤翻出來一個壓箱底的“寶貝”——一個基于SpringBoot的校園二手交易平臺系統(tǒng)。這玩意兒是我當(dāng)年帶畢業(yè)設(shè)計時為了給學(xué)生們一個清晰、完整、能跑起來的參考項目而精心搭建的?，F(xiàn)在看它依然是一個絕佳的SpringBoot全棧實戰(zhàn)案例無論是對于正在做畢業(yè)設(shè)計的同學(xué)還是想快速上手SpringBoot、理解一個完整Web應(yīng)用開發(fā)流程的朋友都有不小的參考價值。這個項目本質(zhì)上是一個簡化版的“校園閑魚”。它解決了校園內(nèi)學(xué)生之間閑置物品比如教材、電子產(chǎn)品、體育用品、生活雜物流轉(zhuǎn)不便、信息不對稱、交易缺乏信任保障的核心痛點。通過一個線上平臺學(xué)生可以方便地發(fā)布商品、瀏覽求購、在線溝通并最終完成線下交易。整個項目麻雀雖小五臟俱全從前端頁面展示、后端業(yè)務(wù)邏輯處理到數(shù)據(jù)庫設(shè)計、用戶權(quán)限管理都涵蓋在內(nèi)。源碼和數(shù)據(jù)庫腳本都打包好了解壓導(dǎo)入就能運行對于想快速理解一個項目從零到一全貌的人來說是個非常直接的“腳手架”。2. 系統(tǒng)整體架構(gòu)與技術(shù)選型解析2.1 為什么選擇SpringBoot作為技術(shù)棧核心在校園二手交易平臺這個場景下技術(shù)選型的首要原則是“快速開發(fā)、易于部署、生態(tài)成熟”。SpringBoot幾乎是這個原則下的不二之選。它通過“約定大于配置”的理念極大地簡化了Spring應(yīng)用的初始搭建和開發(fā)過程。對于畢業(yè)設(shè)計或者個人學(xué)習(xí)項目而言這意味著你可以把精力更多地集中在業(yè)務(wù)邏輯的實現(xiàn)上而不是耗費大量時間在繁瑣的XML配置、依賴沖突解決上。具體到這個項目SpringBoot帶來的核心便利包括內(nèi)嵌Web服務(wù)器無需額外配置Tomcat項目打包成Jar后直接java -jar就能運行部署極其簡單非常適合在個人電腦或?qū)W生服務(wù)器上演示。自動配置通過spring-boot-starter-*系列依賴自動整合了Web MVC、數(shù)據(jù)訪問MyBatis/JPA、安全Spring Security等常用模塊。例如引入spring-boot-starter-web一個基礎(chǔ)的RESTful API服務(wù)框架就準(zhǔn)備好了。簡化的依賴管理父POM統(tǒng)一管理了大量常用庫的版本避免了版本沖突這個新手噩夢。強大的生產(chǎn)就緒特性內(nèi)置了健康檢查、指標(biāo)收集、外部化配置等功能雖然畢業(yè)設(shè)計可能用不到這么深但它為項目提供了一個“專業(yè)級”的起點。2.2 項目分層架構(gòu)與模塊劃分一個清晰的分層架構(gòu)是保證代碼可維護性和可擴展性的基礎(chǔ)。本項目采用了經(jīng)典的三層架構(gòu)并在此基礎(chǔ)上進行了適合Web開發(fā)的細化表現(xiàn)層 (Presentation Layer)技術(shù)實現(xiàn)主要使用Spring MVC的Controller或RestController來接收前端請求可能是Thymeleaf模板渲染的頁面請求也可能是Vue/React等前端框架發(fā)起的API請求。職責(zé)參數(shù)校驗、請求路由、調(diào)用業(yè)務(wù)邏輯層、返回視圖或JSON數(shù)據(jù)。在這一層我們會定義清晰的API接口例如/api/goods/list獲取商品列表、/api/user/login用戶登錄。業(yè)務(wù)邏輯層 (Service Layer)技術(shù)實現(xiàn)使用Service注解標(biāo)記的Spring Bean。職責(zé)這是系統(tǒng)的“大腦”包含了所有核心業(yè)務(wù)規(guī)則和流程。例如“發(fā)布商品”這個業(yè)務(wù)服務(wù)層會依次處理校驗用戶狀態(tài)、組裝商品信息、處理上傳的圖片、調(diào)用數(shù)據(jù)訪問層保存、可能還需要發(fā)送消息通知等。業(yè)務(wù)邏輯的復(fù)雜性都封裝在這里確?？刂破鲗颖３趾啙?。數(shù)據(jù)訪問層 (Data Access Layer)技術(shù)實現(xiàn)本項目采用了MyBatis作為ORM框架使用Mapper注解的接口配合XML映射文件或注解來操作數(shù)據(jù)庫。職責(zé)純粹負責(zé)與數(shù)據(jù)庫交互執(zhí)行SQL語句將數(shù)據(jù)庫記錄映射為Java對象POJO。它不關(guān)心任何業(yè)務(wù)邏輯只提供基礎(chǔ)的增刪改查CRUD能力。實體層 (Entity/Persistence Layer)技術(shù)實現(xiàn)普通的Java類POJO通常與數(shù)據(jù)庫表結(jié)構(gòu)一一對應(yīng)使用JPA注解或MyBatis約定來映射。職責(zé)承載數(shù)據(jù)在各個層之間傳遞。例如User、Goods、Order等類。數(shù)據(jù)庫層 (Database Layer)技術(shù)實現(xiàn)MySQL。選擇MySQL是因為它開源、免費、資料豐富、性能足以支撐校園級應(yīng)用且是大多數(shù)學(xué)生接觸過的第一個關(guān)系型數(shù)據(jù)庫。職責(zé)持久化存儲所有業(yè)務(wù)數(shù)據(jù)。此外項目通常還會包含配置層application.yml或application.properties文件集中管理數(shù)據(jù)庫連接、服務(wù)器端口、文件上傳路徑、第三方密鑰等配置。工具層一些通用的工具類如日期處理、加密解密、文件操作、JSON轉(zhuǎn)換等。常量/枚舉層定義業(yè)務(wù)狀態(tài)碼、商品分類枚舉等避免魔法值。實操心得在項目初期嚴格遵循分層架構(gòu)哪怕是一個很小的功能也堅持從Controller - Service - Mapper - DB的流程來寫。這看似繁瑣但當(dāng)項目功能逐漸增多時你會發(fā)現(xiàn)代碼結(jié)構(gòu)依然清晰定位問題非常迅速。切忌因為功能簡單就把數(shù)據(jù)庫操作直接寫在Controller里那是給自己未來挖坑。3. 核心功能模塊設(shè)計與實現(xiàn)細節(jié)3.1 用戶系統(tǒng)注冊、登錄與權(quán)限管理用戶系統(tǒng)是整個平臺的基石核心在于安全與體驗的平衡。1. 數(shù)據(jù)庫表設(shè)計 (user表)CREATE TABLE user ( id bigint(20) NOT NULL AUTO_INCREMENT COMMENT 主鍵ID, username varchar(50) NOT NULL UNIQUE COMMENT 用戶名/學(xué)號, password varchar(255) NOT NULL COMMENT 加密后的密碼, nickname varchar(50) DEFAULT NULL COMMENT 昵稱, avatar_url varchar(500) DEFAULT NULL COMMENT 頭像URL, phone varchar(20) DEFAULT NULL COMMENT 手機號, email varchar(100) DEFAULT NULL COMMENT 郵箱, campus varchar(100) DEFAULT NULL COMMENT 校區(qū), dormitory varchar(100) DEFAULT NULL COMMENT 宿舍樓, role tinyint(4) NOT NULL DEFAULT 1 COMMENT 角色0-管理員1-普通用戶, status tinyint(4) NOT NULL DEFAULT 1 COMMENT 狀態(tài)0-禁用1-正常, create_time datetime DEFAULT CURRENT_TIMESTAMP COMMENT 創(chuàng)建時間, update_time datetime DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT 更新時間, PRIMARY KEY (id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT用戶表;設(shè)計要點username設(shè)為唯一索引通常用學(xué)號便于校內(nèi)身份識別。password字段長度要足夠推薦255因為存儲的是經(jīng)過BCrypt等強哈希算法加密后的字符串。添加campus和dormitory字段這是校園場景的特色便于商品按位置篩選促進“就近交易”。role字段實現(xiàn)簡單的權(quán)限控制。status字段用于封禁違規(guī)用戶。2. 密碼安全存儲絕對不能在數(shù)據(jù)庫中明文存儲密碼本項目采用Spring Security提供的BCryptPasswordEncoder進行密碼加密和驗證。Service public class UserService { Autowired private PasswordEncoder passwordEncoder; // 在配置類中注入BCryptPasswordEncoder Bean public void register(User user) { // 對原始密碼進行加密 String encodedPassword passwordEncoder.encode(user.getPassword()); user.setPassword(encodedPassword); // 保存用戶到數(shù)據(jù)庫... } public boolean login(String username, String rawPassword) { User user userMapper.findByUsername(username); if (user ! null) { // 匹配原始密碼和數(shù)據(jù)庫存儲的加密密碼 return passwordEncoder.matches(rawPassword, user.getPassword()); } return false; } }3. 會話管理與身份認證對于畢業(yè)設(shè)計級別的項目使用Session-Cookie機制是簡單有效的選擇。用戶登錄成功后將用戶ID、角色等信息存入HttpSession。后續(xù)請求通過攔截器Interceptor來驗證Session中是否存在登錄信息從而實現(xiàn)訪問控制。 對于更接近現(xiàn)代前后端分離的實踐可以采用JWTJSON Web Token。用戶登錄后服務(wù)器生成一個簽名的Token返回給前端前端后續(xù)請求在HTTP Header中攜帶此Token服務(wù)器驗證Token有效性。JWT的優(yōu)點是無狀態(tài)、適合分布式但需要處理Token刷新、注銷等額外邏輯。注意事項使用Session時要留意分布式環(huán)境下的Session共享問題本項目單機運行無需考慮。使用JWT時切記不要將敏感信息如密碼、權(quán)限列表放入Payload且Token過期時間不宜設(shè)置過長。密鑰Secret必須足夠復(fù)雜并妥善保管。3.2 商品模塊發(fā)布、展示與搜索這是平臺的核心功能設(shè)計重點在于信息的結(jié)構(gòu)化展示和高效檢索。1. 數(shù)據(jù)庫表設(shè)計 (goods表)CREATE TABLE goods ( id bigint(20) NOT NULL AUTO_INCREMENT COMMENT 商品ID, user_id bigint(20) NOT NULL COMMENT 發(fā)布者ID, title varchar(200) NOT NULL COMMENT 商品標(biāo)題, category_id int(11) DEFAULT NULL COMMENT 分類ID, price decimal(10,2) NOT NULL COMMENT 價格, original_price decimal(10,2) DEFAULT NULL COMMENT 原價, description text COMMENT 商品詳情描述, cover_image varchar(500) DEFAULT NULL COMMENT 封面圖URL, images text COMMENT 商品圖片URL列表JSON格式存儲, status tinyint(4) NOT NULL DEFAULT 0 COMMENT 狀態(tài)0-待審核1-出售中2-已售出3-已下架, view_count int(11) DEFAULT 0 COMMENT 瀏覽數(shù), contact_type varchar(20) DEFAULT NULL COMMENT 聯(lián)系方式類型如微信、QQ、手機, contact_info varchar(100) DEFAULT NULL COMMENT 聯(lián)系方式, location varchar(200) DEFAULT NULL COMMENT 交易地點如某宿舍樓下, is_negotiable tinyint(1) DEFAULT 1 COMMENT 是否可議價, create_time datetime DEFAULT CURRENT_TIMESTAMP COMMENT 發(fā)布時間, update_time datetime DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT 更新時間, PRIMARY KEY (id), KEY idx_user_id (user_id), KEY idx_category_id (category_id), KEY idx_status_create_time (status,create_time) -- 復(fù)合索引用于常見查詢 ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT商品表;設(shè)計要點images字段使用JSON格式MySQL 5.7支持或簡單分隔符存儲多張圖片cover_image存儲首圖用于列表展示。status字段管理商品生命周期view_count用于熱門排序。添加location和contact_*字段方便線下交易聯(lián)絡(luò)。建立了必要的索引以加速查詢特別是idx_status_create_time因為前臺最常查詢“出售中”的商品并按發(fā)布時間排序。2. 圖片上傳與存儲這是一個非常實際的痛點。不建議將圖片直接以二進制形式存數(shù)據(jù)庫BLOB會嚴重影響數(shù)據(jù)庫性能。通用做法是前端通過input typefile或組件上傳圖片到后端特定接口。后端Controller接收MultipartFile對象。對文件進行校驗大小、類型防止上傳非圖片文件或惡意腳本。生成一個唯一的文件名如UUID 后綴防止重名覆蓋。將文件保存到服務(wù)器磁盤的特定目錄如/upload/images/或者上傳到云存儲服務(wù)如阿里云OSS、騰訊云COS。對于畢業(yè)設(shè)計本地存儲更簡單。將文件的訪問路徑如/upload/images/xxx.jpg存入數(shù)據(jù)庫。需要在SpringBoot配置中指定文件上傳大小限制和靜態(tài)資源映射使得存儲的圖片能被外部訪問。# application.yml spring: servlet: multipart: max-file-size: 5MB max-request-size: 10MBConfiguration public class WebConfig implements WebMvcConfigurer { Override public void addResourceHandlers(ResourceHandlerRegistry registry) { // 將本地文件路徑映射為網(wǎng)絡(luò)URL路徑 registry.addResourceHandler(/upload/**) .addResourceLocations(file: System.getProperty(user.dir) /upload/); } }3. 商品搜索與列表分頁商品列表頁通常需要支持按分類、關(guān)鍵詞、價格區(qū)間、校區(qū)等多條件篩選并且必須分頁。后端實現(xiàn)在Service層構(gòu)建動態(tài)查詢條件。使用MyBatis時可以在XML中使用if標(biāo)簽動態(tài)拼接SQL或者使用MyBatis-Plus等增強工具提供的QueryWrapper。分頁使用PageHelper國內(nèi)流行或Spring Data JPA自帶的分頁。核心是接收前端的pageNum頁碼和pageSize每頁條數(shù)參數(shù)在查詢時應(yīng)用LIMIT。關(guān)鍵詞搜索簡單的模糊查詢可以使用LIKE %#{keyword}%但性能較差。如果搜索需求強可以考慮引入Elasticsearch但這對于畢業(yè)設(shè)計可能過重。3.3 交易與溝通流程設(shè)計校園二手交易多為線下交易平臺主要提供信息對接和信用背書因此核心流程圍繞“聯(lián)系-溝通-成交-確認”展開。1. 溝通機制站內(nèi)信建立message表記錄發(fā)送者、接收者、內(nèi)容、關(guān)聯(lián)商品、時間等。實現(xiàn)一個簡單的實時性要求不高的對話系統(tǒng)。聯(lián)系信息展示發(fā)布商品時用戶可選擇公開部分聯(lián)系方式如微信二維碼圖片。為保護隱私可以對聯(lián)系方式進行部分隱藏如138****1234當(dāng)有用戶點擊“我想要”或“聯(lián)系賣家”時再通過后端接口驗證后返回完整信息需登錄態(tài)并記錄此行為防止信息被爬取。2. 交易狀態(tài)流轉(zhuǎn)雖然以線下交易為主但平臺可以設(shè)計一個簡單的線上狀態(tài)跟蹤來提升體驗出售中商品剛發(fā)布的狀態(tài)。已預(yù)約有買家強烈意向賣家可手動標(biāo)記減少其他買家咨詢。交易中雙方約定線下交易。已售出交易完成賣家標(biāo)記。商品自動下架或移至“已售出”列表。已下架賣家主動下架。這個狀態(tài)可以由賣家手動更新也可以設(shè)計簡單的交互如買家點擊“我已買到”賣家確認。3. 數(shù)據(jù)庫表設(shè)計 (order或transaction表)即使沒有在線支付記錄交易訂單也是有價值的用于追溯和信用積累。CREATE TABLE trade_order ( id varchar(32) NOT NULL COMMENT 訂單號可自定義生成規(guī)則, goods_id bigint(20) NOT NULL COMMENT 商品ID, seller_id bigint(20) NOT NULL COMMENT 賣家ID, buyer_id bigint(20) NOT NULL COMMENT 買家ID, final_price decimal(10,2) DEFAULT NULL COMMENT 成交價, meet_location varchar(200) DEFAULT NULL COMMENT 約定見面地點, meet_time datetime DEFAULT NULL COMMENT 約定見面時間, status tinyint(4) NOT NULL DEFAULT 0 COMMENT 訂單狀態(tài)0-待確認1-已約定2-已完成3-已取消, buyer_comment text COMMENT 買家評價, seller_comment text COMMENT 賣家評價, buyer_rating tinyint(4) DEFAULT NULL COMMENT 買家給賣家的評分1-5, seller_rating tinyint(4) DEFAULT NULL COMMENT 賣家給買家的評分, create_time datetime DEFAULT CURRENT_TIMESTAMP, finish_time datetime DEFAULT NULL COMMENT 完成時間, PRIMARY KEY (id), KEY idx_seller_id (seller_id), KEY idx_buyer_id (buyer_id), KEY idx_goods_id (goods_id) ) COMMENT交易訂單表;3.4 后臺管理模塊后臺管理是平臺運營的必備部分通常獨立于前臺使用不同的模板或前端項目。核心功能用戶管理查看用戶列表、禁用/啟用賬號、重置密碼僅管理員操作。商品審核新發(fā)布的商品可以先進入“待審核”狀態(tài)管理員審核內(nèi)容是否違規(guī)、信息是否完整后才變?yōu)椤俺鍪壑小?。這是內(nèi)容安全的重要一環(huán)。分類管理動態(tài)管理商品分類如數(shù)碼、圖書、服飾、代步等支持增刪改查。數(shù)據(jù)統(tǒng)計簡單的數(shù)據(jù)看板如每日新增用戶數(shù)、商品發(fā)布數(shù)、成交概覽等。舉報處理接收用戶舉報處理違規(guī)商品或用戶。技術(shù)實現(xiàn)使用攔截器或過濾器對訪問/admin/**路徑的請求進行角色校驗role 0。后臺頁面通常使用服務(wù)端渲染模板如Thymeleaf快速搭建或者使用一套現(xiàn)成的AdminLTE、Element Admin等前端框架。4. 數(shù)據(jù)庫腳本詳解與表關(guān)系梳理提供的database.sql腳本是項目的基石。理解它就理解了整個系統(tǒng)的數(shù)據(jù)模型。4.1 核心表關(guān)系圖邏輯描述用戶 (user) 表中心表。一個用戶可以發(fā)布多個商品也可以購買多個商品產(chǎn)生多個訂單。商品 (goods) 表核心業(yè)務(wù)表。每條商品記錄屬于一個用戶賣家通過user_id外鍵關(guān)聯(lián)user表。一個商品屬于一個分類通過category_id關(guān)聯(lián)category表。一個商品最多產(chǎn)生一個有效訂單售出后。商品分類 (category) 表基礎(chǔ)數(shù)據(jù)表。一個分類下可以有多個商品。交易訂單 (trade_order) 表連接買家和賣家的橋梁。它關(guān)聯(lián)了goods_id、seller_id賣家也是商品所屬用戶、buyer_id買家另一個用戶。消息 (message) 表記錄用戶間的通信。關(guān)聯(lián)sender_id和receiver_id到user表可能關(guān)聯(lián)goods_id。收藏 (favorite) 表多對多關(guān)系中間表。記錄用戶收藏了哪些商品。包含user_id和goods_id兩個外鍵。舉報 (report) 表記錄舉報信息。關(guān)聯(lián)舉報人(reporter_id)、被舉報商品(goods_id)或被舉報人(reported_user_id)。4.2 關(guān)鍵字段與索引設(shè)計原則主鍵一律使用與業(yè)務(wù)無關(guān)的自增BIGINT或UUID。BIGINT自增性能好UUID適合分布式環(huán)境。本項目常用自增ID。時間字段create_time和update_time是標(biāo)配便于排查問題和數(shù)據(jù)分析。MySQL 5.6可以使用DATETIME類型并設(shè)置默認值。枚舉狀態(tài)字段如status、role等使用TINYINT并在代碼中用枚舉類Enum管理避免在SQL中出現(xiàn)魔法數(shù)字。文本字段短文本用VARCHAR并指定合理長度如標(biāo)題200長文本描述、詳情用TEXT。金額字段使用DECIMAL(p, s)類型例如DECIMAL(10,2)表示總共10位小數(shù)位2位確保計算精度。索引策略主鍵索引自動創(chuàng)建。外鍵索引在所有作為查詢條件的user_id、goods_id、category_id等字段上建立普通索引KEY。復(fù)合索引對高頻的聯(lián)合查詢條件建立索引如商品列表的(status, create_time)。遵循“最左前綴原則”。唯一索引在需要保證唯一的字段上建立如username。避坑技巧在開發(fā)初期可以不用過多考慮索引。當(dāng)功能基本完成數(shù)據(jù)量有一定積累后通過分析慢查詢?nèi)罩維low Query Log或使用EXPLAIN命令來查看SQL執(zhí)行計劃有針對性地添加索引。盲目添加索引會影響寫入性能。5. 項目部署與運行指南拿到源碼和數(shù)據(jù)庫腳本后如何讓它跑起來以下是詳細的步驟。5.1 環(huán)境準(zhǔn)備JDK確保安裝JDK 8或11推薦LTS版本。在終端輸入java -version驗證。Maven用于管理項目依賴和構(gòu)建。安裝后在終端輸入mvn -v驗證。MySQL安裝MySQL 5.7或8.0。建議使用圖形化工具如Navicat、MySQL Workbench或DBeaver來操作數(shù)據(jù)庫。IDEIntelliJ IDEA首選或Eclipse with STS插件。5.2 數(shù)據(jù)庫初始化打開MySQL客戶端創(chuàng)建一個新的數(shù)據(jù)庫字符集建議utf8mb4排序規(guī)則utf8mb4_general_ci。CREATE DATABASE campus_trade CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;使用提供的database.sql腳本文件在新建的數(shù)據(jù)庫中執(zhí)行它。這將創(chuàng)建所有表結(jié)構(gòu)和必要的初始數(shù)據(jù)如管理員賬號、商品分類。5.3 項目配置與啟動解壓與導(dǎo)入將zip包解壓用IDEA打開項目文件夾選擇pom.xml所在目錄。配置數(shù)據(jù)庫連接找到src/main/resources/application.yml或.properties文件修改其中的數(shù)據(jù)庫連接信息。spring: datasource: url: jdbc:mysql://localhost:3306/campus_trade?useUnicodetruecharacterEncodingutf-8useSSLfalseserverTimezoneAsia/Shanghai username: root # 你的數(shù)據(jù)庫用戶名 password: yourpassword # 你的數(shù)據(jù)庫密碼 driver-class-name: com.mysql.cj.jdbc.Driver修改文件上傳路徑檢查配置文件中關(guān)于文件上傳的路徑設(shè)置確保該路徑在操作系統(tǒng)上存在且有讀寫權(quán)限。file: upload: path: /tmp/upload/ # Linux/Mac示例Windows可改為 D:/upload/Maven依賴下載IDEA會自動下載pom.xml中定義的依賴。如果網(wǎng)絡(luò)慢可以檢查Maven配置使用國內(nèi)鏡像源如阿里云鏡像。啟動項目找到主啟動類通常命名為Application或CampusTradeApplication帶有SpringBootApplication注解右鍵運行main方法。訪問應(yīng)用控制臺無報錯看到類似Tomcat started on port(s): 8080的日志后打開瀏覽器訪問http://localhost:8080。5.4 打包與部署開發(fā)環(huán)境直接用IDE運行主類適合調(diào)試。生產(chǎn)/演示環(huán)境需要打包成可獨立運行的Jar文件。在項目根目錄下執(zhí)行Maven命令mvn clean package -DskipTests命令執(zhí)行成功后在target目錄下會生成一個項目名-版本號.jar文件如campus-trade-0.0.1-SNAPSHOT.jar。將Jar文件、application.yml外部配置文件方便修改和upload圖片上傳目錄放到服務(wù)器同一目錄。在服務(wù)器上運行nohup java -jar campus-trade-0.0.1-SNAPSHOT.jar --spring.config.locationapplication.yml app.log 21 這條命令以后臺方式啟動應(yīng)用并將日志輸出到app.log文件。6. 常見問題排查與調(diào)試技巧在實際運行和二次開發(fā)中你肯定會遇到各種問題。這里記錄一些典型問題的解決思路。6.1 數(shù)據(jù)庫連接失敗現(xiàn)象啟動時報Communications link failure或Access denied for user。排查檢查application.yml中的url、username、password是否正確。檢查MySQL服務(wù)是否啟動。檢查該用戶是否有從本地localhost或指定IP遠程連接的權(quán)限。對于本地連接通常使用rootlocalhost。檢查MySQL版本與驅(qū)動driver-class-name是否匹配。MySQL 8.0通常使用com.mysql.cj.jdbc.Driver。6.2 端口被占用現(xiàn)象啟動時報Port 8080 was already in use。解決修改application.yml中的服務(wù)器端口server: port: 8081或者找到占用8080端口的進程并結(jié)束它謹慎操作# Linux/Mac lsof -i:8080 kill -9 PID # Windows netstat -ano | findstr :8080 taskkill /PID PID /F6.3 靜態(tài)資源或上傳圖片無法訪問現(xiàn)象頁面CSS/JS加載失敗或上傳的圖片顯示404。排查檢查WebConfig類中的addResourceHandlers配置映射路徑/upload/**是否與前端訪問的URL匹配。檢查配置的本地磁盤路徑file:/path/to/upload/是否存在應(yīng)用是否有讀寫權(quán)限。如果使用IDE運行注意工作目錄Working Directory是否在項目根目錄這會影響相對路徑的解析。在IDEA的Run/Debug Configuration中可以設(shè)置。6.4 事務(wù)管理失效現(xiàn)象在Service方法中即使拋出了異常數(shù)據(jù)庫操作還是被提交了。原因Spring的事務(wù)管理默認只對RuntimeException和Error進行回滾對受檢異常Exception不回滾。解決在Transactional注解上顯式指定回滾的異常類型Transactional(rollbackFor Exception.class)。確保異常是從被代理的Service方法中拋出的。如果方法內(nèi)部用try-catch吞掉了異常事務(wù)也不會回滾。確保調(diào)用事務(wù)方法是通過Spring代理調(diào)用的。在同一個類的非事務(wù)方法A中調(diào)用事務(wù)方法BB的事務(wù)會失效。這是Spring AOP代理的機制問題。解決方法是將方法B放到另一個Service中或使用AopContext.currentProxy()。6.5 跨域問題 (CORS)現(xiàn)象當(dāng)前端項目運行在localhost:3000訪問后端APIlocalhost:8080時瀏覽器控制臺報CORS錯誤。解決在后端添加全局CORS配置。Configuration public class CorsConfig implements WebMvcConfigurer { Override public void addCorsMappings(CorsRegistry registry) { registry.addMapping(/**) // 對所有接口 .allowedOriginPatterns(*) // 允許所有來源生產(chǎn)環(huán)境應(yīng)指定具體域名 .allowedMethods(GET, POST, PUT, DELETE, OPTIONS) .allowedHeaders(*) .allowCredentials(true) .maxAge(3600); } }6.6 開發(fā)與調(diào)試技巧善用日志在application.yml中調(diào)整日志級別特別是將com.yourpackage你的業(yè)務(wù)包的級別設(shè)為DEBUG可以打印出詳細的SQL和執(zhí)行過程。logging: level: com.example.campus: DEBUG使用IDEA的Database工具直接連接項目數(shù)據(jù)庫實時查看數(shù)據(jù)變化比命令行方便得多。使用Postman或ApiFox測試接口在開發(fā)后端API時用這些工具先測試通再對接前端效率倍增。閱讀SpringBoot官方文檔遇到問題第一選擇是去 Spring官方文檔 查看對應(yīng)版本的Reference Doc大部分基礎(chǔ)問題都有答案。本文還有配套的精品資源點擊獲取