簡介這套Java田徑運(yùn)動(dòng)會(huì)管理系統(tǒng)是一份面向課程設(shè)計(jì)或項(xiàng)目實(shí)戰(zhàn)的完整資源能解決運(yùn)動(dòng)會(huì)中運(yùn)動(dòng)員報(bào)名、賽事編排、成績錄入與排名發(fā)布等環(huán)節(jié)的信息化管理問題。壓縮包共81個(gè)文件涵蓋25個(gè)Java源文件、48個(gè)class編譯文件、項(xiàng)目jar包、MySQL驅(qū)動(dòng)、數(shù)據(jù)庫腳本、數(shù)據(jù)庫課設(shè)報(bào)告和說明文檔整體僅2.04MB目錄劃分明確。資源重點(diǎn)展示了Java Swing圖形界面與JDBC數(shù)據(jù)庫操作相結(jié)合的開發(fā)方式配套課設(shè)報(bào)告詳細(xì)說明了系統(tǒng)架構(gòu)、功能模塊和實(shí)現(xiàn)流程結(jié)合源碼與數(shù)據(jù)庫腳本可快速搭建運(yùn)行環(huán)境并初始化數(shù)據(jù)。對(duì)于已掌握J(rèn)ava基礎(chǔ)并希望提升信息系統(tǒng)開發(fā)能力的讀者這是一份可直接參考的課程設(shè)計(jì)模板也適合作為田徑運(yùn)動(dòng)會(huì)管理系統(tǒng)二次開發(fā)的基礎(chǔ)。目前已有2167人學(xué)習(xí)下載實(shí)用性強(qiáng)。1. java田徑運(yùn)動(dòng)會(huì)管理系統(tǒng)把課程設(shè)計(jì)最常點(diǎn)的題做成能跑通的完整閉環(huán)java田徑運(yùn)動(dòng)會(huì)管理系統(tǒng)是Java課程設(shè)計(jì)題目里出鏡率最高的題型之一。如果你正在找java課程設(shè)計(jì)案例源碼多半第一眼就會(huì)相中它表面是管理系統(tǒng)實(shí)際上把增刪改查全部包圓還額外塞了成績排名、賽程校驗(yàn)、登錄權(quán)限這些“算活”。真正動(dòng)手做你會(huì)發(fā)現(xiàn)它遠(yuǎn)不止給運(yùn)動(dòng)員建個(gè)檔案那么簡單徑賽按時(shí)間升序排田賽按距離/高度降序排同一個(gè)項(xiàng)目可能跑預(yù)賽和決賽兩輪要取最好成績報(bào)名時(shí)還得攔住同一選手的時(shí)間沖突。這些細(xì)節(jié)恰恰是java面試題里排序、精度、事務(wù)一致性最現(xiàn)實(shí)的落點(diǎn)比死背八股文有用得多。這套資源是一份可運(yùn)行的Java信息系統(tǒng)覆蓋建庫、登錄權(quán)限、成績管理、排名輸出到部署啟動(dòng)的完整閉環(huán)。適合兩類人做運(yùn)動(dòng)會(huì)課設(shè)和畢設(shè)的本科生以及準(zhǔn)備Java開發(fā)面試、想找一個(gè)能講清業(yè)務(wù)鏈路的實(shí)戰(zhàn)項(xiàng)目做背書的人。源碼直接拿庫建好就能跑后面的章節(jié)會(huì)把參數(shù)和坑位都鋪開。2. 技術(shù)棧與數(shù)據(jù)庫設(shè)計(jì)Spring Boot MyBatis MySQL 的六張核心表2.1 為什么是這套組合選型圍繞“能跑通、能講清、能復(fù)現(xiàn)”三個(gè)目標(biāo)這套資源基于Spring Boot 2.x MyBatis MySQL 5.7/8.0 Thymeleaf。選型理由不是“流行”而是它最貼合課程設(shè)計(jì)和面試場景。Spring Boot用Java配置代替了SSH時(shí)代一堆XML啟動(dòng)就是java -jar一個(gè)命令的事不用在Tomcat里手工部署war包Thymeleaf做服務(wù)端渲染前端頁面和后端接口放同一個(gè)工程打開就能跑比前后端分離少搭一套Node和跨域配置對(duì)新手友好答辯時(shí)也方便順著Controller一路把鏈路講下去。MyBatis保留手寫SQL的能力這一點(diǎn)在運(yùn)動(dòng)會(huì)場景里很關(guān)鍵成績排名要按徑賽、田賽區(qū)分升降序報(bào)表統(tǒng)計(jì)要按代表隊(duì)聚合這些邏輯寫成SQL比用JPA的自動(dòng)方法直觀得多排錯(cuò)時(shí)直接把SQL丟進(jìn)Navicat跑一遍就知道問題出在哪。相比之下JPA雖然省事但碰到復(fù)雜的排序和關(guān)聯(lián)查詢自動(dòng)生成的SQL像黑匣子查起來反而費(fèi)勁。這套組合還有個(gè)隱藏價(jià)值它正好卡在java基礎(chǔ)語法和框架應(yīng)用之間的銜接帶上。面試?yán)飭柕摹霸趺幢ＷC數(shù)據(jù)一致性”在這個(gè)項(xiàng)目里落地就是成績錄入的Transactional與唯一索引問的“對(duì)象深淺拷貝”落地就是多輪成績匯總時(shí)的對(duì)象引用陷阱。把這份源碼吃透等于把八股文里最?？嫉膸讉€(gè)點(diǎn)用業(yè)務(wù)場景串了一遍。2.2 六張表怎么設(shè)計(jì)報(bào)名關(guān)系表是整條業(yè)務(wù)鏈的中樞數(shù)據(jù)庫設(shè)計(jì)直接決定后面模塊寫起來順不順。這套資源一共六張核心表各自的職責(zé)如下。表名作用關(guān)鍵字段備注sys_user管理員和裁判賬號(hào)id, username, password, role, real_namerole為ADMIN或REFEREEteam參賽代表隊(duì)id, team_name, coach, phone運(yùn)動(dòng)員歸屬athlete運(yùn)動(dòng)員檔案id, team_id, name, gender, student_no, birth_datestudent_no唯一event比賽項(xiàng)目id, event_name, event_type, unit_type, start_time, end_time徑賽/田賽、計(jì)時(shí)/測距signup報(bào)名關(guān)系id, athlete_id, event_id, create_time多對(duì)多中間表result比賽成績id, signup_id, event_id, athlete_id, round_no, score_value, is_validsignup_id掛靠報(bào)名記錄幾個(gè)設(shè)計(jì)點(diǎn)值得說清楚。第一signup表解決運(yùn)動(dòng)員與項(xiàng)目之間的多對(duì)多關(guān)系同時(shí)通過unique(athlete_id, event_id)唯一索引擋住重復(fù)報(bào)名這是從源頭卡數(shù)據(jù)的做法比在Service層判重更可靠。第二score_value用DECIMAL(8,3)而不是float或double因?yàn)楦↑c(diǎn)數(shù)在二進(jìn)制里無法精確表示0.1這種小數(shù)徑賽100米跑出9.989999999的后果就是排名錯(cuò)位這一條在避坑章還會(huì)單獨(dú)展開。第三event.event_type用TRACK和FIELD兩個(gè)枚舉值區(qū)分徑賽和田賽unit_type告訴前端這個(gè)成績單位是秒還是米排名方向由這兩個(gè)字段共同決定而不是寫死在代碼里。成績表掛在signup_id上而不是直接掛athlete_id event_id是刻意為之的。這樣一輪預(yù)賽、一輪決賽各生成一條result記錄round_no區(qū)分輪次signup_id保證“同一個(gè)運(yùn)動(dòng)員同一個(gè)項(xiàng)目的成績”始終有唯一歸屬后面做多輪取最好成績時(shí)按運(yùn)動(dòng)員項(xiàng)目分組即可不會(huì)串?dāng)?shù)據(jù)。2.3 建庫SQL腳本一份能直接執(zhí)行的初始化代碼拿到源碼第一件事不是啟動(dòng)項(xiàng)目而是先把庫建起來。初始化腳本在src/main/resources/sql/init.sql里核心內(nèi)容如下。CREATE DATABASE IF NOT EXISTS sports_db DEFAULT CHARSET utf8mb4 COLLATE utf8mb4_general_ci; USE sports_db; CREATE TABLE sys_user ( id BIGINT PRIMARY KEY AUTO_INCREMENT, username VARCHAR(50) NOT NULL UNIQUE COMMENT 登錄名, password VARCHAR(64) NOT NULL COMMENT 密碼摘要, role VARCHAR(20) NOT NULL DEFAULT REFEREE COMMENT ADMIN/REFEREE, real_name VARCHAR(50) DEFAULT NULL ) ENGINEInnoDB; CREATE TABLE team ( id BIGINT PRIMARY KEY AUTO_INCREMENT, team_name VARCHAR(100) NOT NULL, coach VARCHAR(50) DEFAULT NULL, phone VARCHAR(20) DEFAULT NULL ) ENGINEInnoDB; CREATE TABLE athlete ( id BIGINT PRIMARY KEY AUTO_INCREMENT, team_id BIGINT NOT NULL, name VARCHAR(50) NOT NULL, gender CHAR(1) NOT NULL COMMENT M/F, student_no VARCHAR(30) NOT NULL UNIQUE, birth_date DATE DEFAULT NULL ) ENGINEInnoDB; CREATE TABLE event ( id BIGINT PRIMARY KEY AUTO_INCREMENT, event_name VARCHAR(100) NOT NULL, event_type VARCHAR(10) NOT NULL COMMENT TRACK/FIELD, unit_type VARCHAR(10) NOT NULL COMMENT SECOND/METER/CENTIMETER, start_time DATETIME DEFAULT NULL, end_time DATETIME DEFAULT NULL ) ENGINEInnoDB; CREATE TABLE signup ( id BIGINT PRIMARY KEY AUTO_INCREMENT, athlete_id BIGINT NOT NULL, event_id BIGINT NOT NULL, create_time DATETIME DEFAULT CURRENT_TIMESTAMP, UNIQUE KEY uk_athlete_event (athlete_id, event_id) ) ENGINEInnoDB; CREATE TABLE result ( id BIGINT PRIMARY KEY AUTO_INCREMENT, signup_id BIGINT NOT NULL, event_id BIGINT NOT NULL, athlete_id BIGINT NOT NULL, round_no INT DEFAULT 1 COMMENT 1預(yù)賽 2決賽, score_value DECIMAL(8,3) NOT NULL, is_valid TINYINT DEFAULT 1, recorder_id BIGINT DEFAULT NULL, create_time DATETIME DEFAULT CURRENT_TIMESTAMP ) ENGINEInnoDB; INSERT INTO sys_user (username, password, role, real_name) VALUES (admin, MD5(admin123), ADMIN, 系統(tǒng)管理員);建庫用utf8mb4而不是utf8這是血淚經(jīng)驗(yàn)utf8在MySQL里最多存3字節(jié)遇到生僻字和emoji直接報(bào)錯(cuò)或存成問號(hào)運(yùn)動(dòng)會(huì)報(bào)名表里出現(xiàn)少數(shù)民族姓名帶點(diǎn)特殊符號(hào)就翻車。utf8mb4才是完整的UTF-8實(shí)現(xiàn)。密碼字段用MD5(admin123)這種寫法是課設(shè)常見做法夠用但不推薦上生產(chǎn)真實(shí)的項(xiàng)目至少要加鹽——如果你對(duì)安全有要求拿到源碼后改成BCrypt即可后面登錄校驗(yàn)處換一個(gè)PasswordEncoder就行。score_value字段的DECIMAL(8,3)含義要看清總長8位、小數(shù)點(diǎn)后3位。徑賽100米成績存成10.250田賽跳遠(yuǎn)存成7.850鉛球存成12.310都能容納。排序和比較都在Java層用BigDecimal的compareTo來做這一點(diǎn)后面排名代碼里會(huì)用到先記住結(jié)論凡是成績、金額、比例這類精確小數(shù)一律decimal別用float。3. 核心模塊實(shí)現(xiàn)登錄權(quán)限、成績排名與賽程沖突檢查3.1 登錄與權(quán)限一個(gè)攔截器區(qū)分管理端和裁判端管理系統(tǒng)的權(quán)限如果一上來就引Spring Security配置類、過濾器鏈、密碼加密器一套下來課設(shè)答辯時(shí)反而講不清。這份源碼用攔截器實(shí)現(xiàn)夠用且直觀管理員能維護(hù)運(yùn)動(dòng)員、項(xiàng)目、報(bào)名和成績裁判只能進(jìn)入成績錄入頁面并提交成績。Component public class AuthInterceptor implements HandlerInterceptor { Override public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception { HttpSession session request.getSession(); User loginUser (User) session.getAttribute(loginUser); if (loginUser null) { response.sendRedirect(request.getContextPath() /login); return false; } String role loginUser.getRole(); if (ADMIN.equals(role)) { return true; } // 裁判角色只允許訪問成績相關(guān)的路徑 String uri request.getRequestURI(); if (uri.contains(/result/)) { return true; } response.sendError(403, 當(dāng)前賬號(hào)無權(quán)操作); return false; } }Configuration public class WebConfig implements WebMvcConfigurer { private final AuthInterceptor authInterceptor; public WebConfig(AuthInterceptor authInterceptor) { this.authInterceptor authInterceptor; } Override public void addInterceptors(InterceptorRegistry registry) { registry.addInterceptor(authInterceptor) .addPathPatterns(/**) .excludePathPatterns(/login, /css/**, /js/**, /error); } }攔截器邏輯里有兩個(gè)容易被忽略的邊界。第一個(gè)excludePathPatterns里放行了/error否則Spring Boot的錯(cuò)誤頁地址也會(huì)被攔截403頁面本身渲染不出來前端只會(huì)看到一個(gè)空白頁第二個(gè)裁判越權(quán)時(shí)返回403而不是重定向到登錄頁如果重定向前端會(huì)把“沒權(quán)限”誤判成“沒登錄”反復(fù)跳轉(zhuǎn)很迷惑。路徑匹配用uri.contains(/result/)這種寫法是偷懶但在這個(gè)小型項(xiàng)目里夠用如果你想寫得更嚴(yán)謹(jǐn)可以改成AntPathMatcher精確匹配。3.2 成績排名徑賽升序、田賽降序、并列名次一次講清排名是運(yùn)動(dòng)會(huì)管理系統(tǒng)最核心的算法題也是最容易寫出bug的地方。直接貼排名核心邏輯。public ListResultVO buildRanking(ListResultDO rawList) { // 第一步過濾無效與空成績 rawList.removeIf(r - r.getScoreValue() null || r.getScoreValue().compareTo(BigDecimal.ZERO) 0); // 第二步把同一運(yùn)動(dòng)員同一項(xiàng)目的多輪成績壓縮成最好成績 MapString, ResultDO bestMap new HashMap(); for (ResultDO r : rawList) { String key r.getAthleteId() _ r.getEventId(); ResultDO old bestMap.get(key); if (old null || r.getScoreValue().compareTo(old.getScoreValue()) 0) { bestMap.put(key, r); } } ListResultDO bestList new ArrayList(bestMap.values()); boolean isTrack TRACK.equals(bestList.get(0).getEventType()); // 第三步徑賽成績?cè)叫≡胶蒙蛱镔惓煽冊(cè)酱笤胶媒敌?ComparatorResultDO byScore (a, b) - isTrack ? a.getScoreValue().compareTo(b.getScoreValue()) : b.getScoreValue().compareTo(a.getScoreValue()); bestList.sort(byScore); // 第四步并列成績給相同名次后續(xù)名次按斷層跳躍 int rank 0; for (int i 0; i bestList.size(); i) { if (i 0 byScore.compare(bestList.get(i), bestList.get(i - 1)) ! 0) { rank i; } bestList.get(i).setRank(rank 1); } return toVO(bestList); }這段代碼每一步都有講究。第二步用HashMap的key athleteId _ eventId做分組壓縮而不是用TreeSet因?yàn)門reeSet會(huì)按Comparator去重兩個(gè)不同運(yùn)動(dòng)員成績恰好相同其中一個(gè)會(huì)被直接吞掉這是“成績莫名少了幾條”的經(jīng)典元兇。如果你不想拼字符串可以用HashMapLong, MapLong, ResultDO嵌套結(jié)構(gòu)可讀性更好。第三步的邏輯前提是score_value是BigDecimal且用compareTo比較。如果用double比較0.1的精度誤差可能讓9.99在10.11面前取得錯(cuò)誤的比較結(jié)果如果用BigDecimal.equals()它會(huì)額外要求小數(shù)位scale一致7.850和7.85在相等的判斷上會(huì)給出false只有compareTo才是按數(shù)值大小比。第四步名次賦值對(duì)應(yīng)兩種競賽規(guī)則這里用的是“同名次跳躍”1、2、2、5適合頒獎(jiǎng)只取前三名的場景如果你需要“不跳躍的對(duì)接名次”1、2、2、3把rank i改成rank bestList.get(i - 1).getRank()即可。這個(gè)細(xì)節(jié)面試時(shí)主動(dòng)講出來比背八股文有說服力。3.3 賽程沖突檢查時(shí)間重疊判斷的兩種寫法運(yùn)動(dòng)會(huì)報(bào)名時(shí)最容易出現(xiàn)的臟數(shù)據(jù)是一個(gè)運(yùn)動(dòng)員同時(shí)報(bào)了兩個(gè)開賽時(shí)間撞車的項(xiàng)目。人工檢查不現(xiàn)實(shí)必須在報(bào)名Service里攔一道。沖突判斷的核心代碼只有一行量級(jí)的邏輯。public boolean hasTimeConflict(Long athleteId, LocalDateTime startTime, LocalDateTime endTime) { ListEvent events eventMapper.selectByAthleteId(athleteId); for (Event event : events) { LocalDateTime s event.getStartTime(); LocalDateTime e event.getEndTime(); if (startTime.isBefore(e) endTime.isAfter(s)) { return true; } } return false; }時(shí)間重疊判斷就一句話startTime.isBefore(e) endTime.isAfter(s)。兩個(gè)時(shí)間區(qū)間[x1, x2]和[y1, y2]只要滿足x1 y2 x2 y1就說明有交集。用LocalDateTime時(shí)只能用isBefore/isAfter比較別犯startTime event.getStartTime()這種拿對(duì)象比大小的錯(cuò)。再一個(gè)常見誤用是判斷條件寫成startTime.isAfter(s) endTime.isBefore(e)那是“完全包含”而不是“相交”你只會(huì)攔住一個(gè)項(xiàng)目完全包住另一個(gè)項(xiàng)目的情況正常錯(cuò)開一點(diǎn)點(diǎn)的時(shí)間沖突就漏掉了。這里你還能順手給Service層加上Transactional報(bào)名和沖突檢查在一個(gè)事務(wù)里完成。面試官問“怎么保證數(shù)據(jù)一致性”你就可以答報(bào)名寫入前查沖突判斷通過才插入插入失敗回滾配合signup表唯一索引雙重兜底。3.4 成績列表與多表關(guān)聯(lián)一條SQL看清參賽鏈路成績管理頁面通常要展示“哪個(gè)代表隊(duì)的誰在哪個(gè)項(xiàng)目里跑出了多少”。這需要result、signup、athlete、team、event五張表聯(lián)查下面這條SQL是這套資源里列表查詢的基準(zhǔn)寫法。SELECT r.id AS result_id, a.name AS athlete_name, t.team_name, e.event_name, r.round_no, r.score_value, r.is_valid FROM result r JOIN signup s ON r.signup_id s.id JOIN athlete a ON s.athlete_id a.id JOIN team t ON a.team_id t.id JOIN event e ON r.event_id e.id WHERE r.is_valid 1 ORDER BY e.id, r.score_value ASC;這段SQL的路口在于JOIN方向result表通過signup_id關(guān)聯(lián)到signup再從signup拆出athlete_id和event_id而不是讓result直接存athlete_id和event_id。后一種做法雖然冗余了字段查詢時(shí)少一層JOIN但會(huì)出現(xiàn)同一個(gè)運(yùn)動(dòng)員同一項(xiàng)目多條成績歸屬混亂的問題——一旦改報(bào)名記錄成績跟著錯(cuò)。多一層JOIN的代價(jià)換來的是數(shù)據(jù)歸屬始終唯一這在管理系統(tǒng)里是更正確的建模方式。ORDER BY這里只寫了r.score_value ASC因?yàn)閺劫愄镔愅砼判虻耐暾壿嬙?.2的Java層處理。如果你想在SQL層一次排好可以這樣寫ORDER BY CASE WHEN e.event_type TRACK THEN r.score_value END ASC, CASE WHEN e.event_type FIELD THEN r.score_value END DESC。這個(gè)寫法能跑但可讀性差而且一旦混合多項(xiàng)目賽事Java層更靈活。我的建議是列表查詢用簡單SQL復(fù)雜排名用Service層統(tǒng)一算各干各的別把SQL寫成天書。4. 本地部署與運(yùn)行JDK、Maven、MySQL 參數(shù)一次配齊4.1 環(huán)境版本JDK8 Maven 3.6 MySQL 5.7/8.0先確認(rèn)本機(jī)環(huán)境版本不對(duì)后面全是坑。這套資源對(duì)應(yīng)的環(huán)境清單如下。組件推薦版本說明JDK1.8Spring Boot 2.x對(duì)JDK8支持最穩(wěn)勿用JDK17強(qiáng)行編2.xMaven3.6.x3.8對(duì)鏡像配置更嚴(yán)格但默認(rèn)倉庫也夠用MySQL5.7 或 8.0初始化腳本兩邊通用IDEA2020.x 以上必須給Lombok插件否則編譯報(bào)找不到getterJDK從Oracle官網(wǎng)或Adoptium下載裝好后java -version確認(rèn)輸出是1.8。Maven配置settings.xml時(shí)建議把本地倉庫路徑指到非C盤目錄項(xiàng)目依賴下載量大默認(rèn)放C:\Users\xx\.m2容易把系統(tǒng)盤塞滿。MySQL裝完先做兩件事設(shè)置root密碼以及把字符集默認(rèn)值改成utf8mb4——Windows安裝版的默認(rèn)字符集可能是latin1不改成utf8mb4后面中文大概率亂碼。Idea里打開項(xiàng)目后第一件事是裝Lombok插件并開啟Annotation Processing菜單在Settings - Build, Execution, Deployment - Compiler - Annotation Processors。這一步漏掉的話Data注解的實(shí)體類全部編譯不過報(bào)錯(cuò)信息是“找不到符號(hào)getAthleteId”完全不會(huì)提示是Lombok的問題很誤導(dǎo)人。4.2 application.yml 配置文件逐行解讀數(shù)據(jù)庫連接參數(shù)全部集中在src/main/resources/application.yml這是部署階段的重點(diǎn)排查對(duì)象。server: port: 8080 servlet: context-path: /sports spring: datasource: url: jdbc:mysql://localhost:3306/sports_db?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/ShanghaiuseSSLfalseallowPublicKeyRetrievaltrue username: root password: 123456 driver-class-name: com.mysql.cj.jdbc.Driver thymeleaf: cache: false mybatis: mapper-locations: classpath:mapper/*.xml configuration: map-underscore-to-camel-case: trueJDBC連接串里這五個(gè)參數(shù)缺一個(gè)就有一款報(bào)錯(cuò)等著你。useUnicodetruecharacterEncodingutf8管中文傳輸不加它頁面從后臺(tái)讀到的中文全是問號(hào)serverTimezoneAsia/Shanghai管時(shí)區(qū)不加它MySQL 5.7以上版本直接報(bào)Server returns invalid timezoneuseSSLfalse避免本機(jī)連接時(shí)反復(fù)握手警告allowPublicKeyRetrievaltrue是MySQL 8.0的專屬坑8.0默認(rèn)身份插件是caching_sha2_passwordJDBC第一次連接需要向服務(wù)端取公鑰這一項(xiàng)默認(rèn)關(guān)閉不加就報(bào)Public Key Retrieval is not allowed。map-underscore-to-camel-case: true開啟后數(shù)據(jù)庫student_no字段自動(dòng)映射到Java實(shí)體studentNo這套資源里所有實(shí)體都依賴這個(gè)配置別手賤關(guān)掉。spring.thymeleaf.cache: false開發(fā)階段務(wù)必開著否則改完前端模板不刷新你會(huì)懷疑人生。啟動(dòng)后訪問路徑是http://localhost:8080/sports/logincontext-path配了/sports少寫這個(gè)前綴會(huì)直接404。4.3 克隆到啟動(dòng)五條命令命令行從零啟動(dòng)推薦按下面順序執(zhí)行每一步都有明確作用。mvn clean install -DskipTests mysql -uroot -p123456 -e DROP DATABASE IF EXISTS sports_db; CREATE DATABASE sports_db DEFAULT CHARSET utf8mb4; mysql -uroot -p123456 sports_db src/main/resources/sql/init.sql java -jar target/sports-0.0.1-SNAPSHOT.jar第一條mvn clean install -DskipTests會(huì)清掉target目錄殘留的舊class并重新打包確保你跑的是最新代碼。-DskipTests跳過單元測試省得測試代碼如果有坑擋住打包。第二條和第三條用mysql命令行直接建庫導(dǎo)數(shù)據(jù)比在Navicat里手動(dòng)執(zhí)行腳本更省事注意是輸入重定向Windows的cmd和PowerShell也能用但PowerShell的編碼偶爾會(huì)搗亂建議在cmd里跑。第四條啟動(dòng)Spring Boot應(yīng)用看到Started Application in xxx seconds才算成功。啟動(dòng)后立刻訪問/sports/login用腳本里插入的管理員賬號(hào)admin / admin123登錄。如果頁面白屏或報(bào)404先回頭看4.2的連接串如果登錄成功后列表頁數(shù)據(jù)為空八成是初始化腳本沒執(zhí)行成功去Navicat里看一眼athlete表有沒有數(shù)據(jù)。這兩步排查完系統(tǒng)就能正常演示了。4.4 啟動(dòng)失敗的三個(gè)高頻場景報(bào)錯(cuò)場景常見原因快速處理Port 8080 was already in use上一個(gè)Tomcat沒關(guān)或其它服務(wù)占端口改server.port為8081注意context-path一并訪問Access denied for user root密碼不對(duì)或用戶不允許localhost登錄核對(duì)spring.datasource.password或用ALTER USER重置密碼Invalid bound statement (not found)mapper.xml沒掃描到確認(rèn)mapper-locations路徑與xml實(shí)際目錄一致啟動(dòng)類加MapperScan端口占用最省事的處理方式不是去殺進(jìn)程而是改server.port。但要注意改了端口后前后端聯(lián)調(diào)的地址全變?nèi)绻阌们岸藛为?dú)發(fā)起請(qǐng)求記得同步改請(qǐng)求前綴。Access denied排查順序是先在命令行用mysql -uroot -p手動(dòng)登錄能進(jìn)說明密碼沒錯(cuò)問題在連接串不能進(jìn)就是密碼本身要重置。Invalid bound statement是MyBatis老毛病九個(gè)里面八個(gè)是xml的namespace寫錯(cuò)或目錄不對(duì)逐個(gè)檢查Mapper接口包名和xml的namespace是否完全一致。5. 高頻踩坑與排查五個(gè)影響驗(yàn)收翻車的細(xì)節(jié)5.1 中文亂碼頁面、日志、數(shù)據(jù)庫三處同時(shí)查現(xiàn)象登錄后運(yùn)動(dòng)員姓名在頁面顯示成“???”IDEA控制臺(tái)日志里的中文全是亂碼數(shù)據(jù)庫里存的也是問號(hào)。原因這個(gè)坑往往不是一處錯(cuò)而是三處沒對(duì)齊。數(shù)據(jù)庫連接串缺characterEncodingutf8建庫字符集不是utf8mb4或者IDEA控制臺(tái)用了GBK任何一環(huán)出問題中文就一路糊到底。解決三步走。第一建庫語句用DEFAULT CHARSET utf8mb4已存在的庫用ALTER DATABASE sports_db CHARACTER SET utf8mb4;改掉第二連接串帶上characterEncodingutf8第三IDEA里File - File Encoding把Global Encoding、Project Encoding、屬性文件全設(shè)成UTF-8運(yùn)行配置的VM options加-Dfile.encodingUTF-8。三處統(tǒng)一后再重新執(zhí)行init.sql。5.2 成績字段用float或double導(dǎo)致排名錯(cuò)位現(xiàn)象100米決賽9.99秒的成績排在了10.11秒后面數(shù)據(jù)庫里看成績字段變成了9.989999999。原因float和double是二進(jìn)制浮點(diǎn)數(shù)表示不了所有十進(jìn)制小數(shù)。9.99在內(nèi)存里實(shí)際上是9.98999999…兩個(gè)成績比較時(shí)精度誤差導(dǎo)致排序結(jié)果錯(cuò)亂。這就是從選型章一路強(qiáng)調(diào)DECIMAL(8,3)的原因。解決把數(shù)據(jù)庫字段改成ALTER TABLE result MODIFY score_value DECIMAL(8,3);Java實(shí)體類型換成BigDecimal比較一律用compareTo。如果庫里已有臟數(shù)據(jù)用UPDATE result SET score_value ROUND(score_value, 3);先清洗一遍再改字段類型。記住一條鐵律成績、金額、比例這類精確小數(shù)絕不用float。5.3 MySQL 8.0 連接報(bào) Public Key Retrieval is not allowed現(xiàn)象項(xiàng)目啟動(dòng)直接報(bào)錯(cuò)控制臺(tái)出現(xiàn)Public Key Retrieval is not allowed或者Unable to load authentication plugin caching_sha2_password。原因MySQL 8.0默認(rèn)身份認(rèn)證插件是caching_sha2_passwordJDBC驅(qū)動(dòng)連接時(shí)需要先從服務(wù)端取公鑰來加密密碼而這個(gè)取公鑰的操作默認(rèn)被JDBC參數(shù)禁掉了。解決JDBC連接串加兩個(gè)參數(shù)allowPublicKeyRetrievaltrue和useSSLfalse。如果你不想動(dòng)代碼另一個(gè)方案是登錄MySQL把賬號(hào)改回舊認(rèn)證方式ALTER USER rootlocalhost IDENTIFIED WITH mysql_native_password BY 123456; FLUSH PRIVILEGES;。兩條路都能通個(gè)人建議用前者改動(dòng)最小。5.4 成績列表重復(fù)同一運(yùn)動(dòng)員同一項(xiàng)目出現(xiàn)多行現(xiàn)象查看成績列表一個(gè)運(yùn)動(dòng)員的兩條記錄長得一模一樣數(shù)據(jù)量直接翻倍但報(bào)名記錄確實(shí)只有一條。原因多表JOIN時(shí)條件寫松了典型是在result JOIN signup處漏了關(guān)聯(lián)字段或者分組維度不對(duì)產(chǎn)生笛卡爾積。還有一種情況是取“最好成績”的分組沒加event_id同一個(gè)運(yùn)動(dòng)員報(bào)了兩個(gè)項(xiàng)目被壓成了一行或拆成了多行。解決排錯(cuò)先跑SELECT COUNT(*) FROM result;確認(rèn)基礎(chǔ)表行數(shù)再一步步加JOIN每加一張就查一次數(shù)量看哪一步開始翻倍。列表查詢用DISTINCT兜底取最好成績SQL記得GROUP BY signup_id, athlete_id, event_id三個(gè)字段缺一不可。5.5 改了代碼重啟后還是舊邏輯target和本地倉庫一起清現(xiàn)象IDEA里改了Service層方法重啟應(yīng)用后頁面行為完全沒變甚至報(bào)類文件具有錯(cuò)誤的版本之類的編譯問題。原因最常見的兩個(gè)一是IDEA增量編譯沒生效target目錄里的舊class還在二是Maven本地倉庫有舊快照mvn spring-boot:run讀到的是緩存里的舊jar包。Spring Boot DevTools的熱重啟不是萬能的改了配置文件、pom或新增類時(shí)它經(jīng)常不觸發(fā)。解決命令行執(zhí)行mvn clean install -DskipTests強(qiáng)制全量清理重新編譯然后java -jar啟動(dòng)。這一步必須走別在IDEA里點(diǎn)綠色三角形IDEA的編譯和Maven的clean經(jīng)常各管各的。如果還不行打開本地倉庫路徑找到項(xiàng)目groupId對(duì)應(yīng)目錄把SNAPSHOT結(jié)尾的舊文件夾刪掉重來。6. 最后一步用一場模擬運(yùn)動(dòng)會(huì)驗(yàn)證系統(tǒng)的完整算分鏈路拿到源碼別急著改代碼先把我下面的流程走一遍。這套驗(yàn)證方法能確認(rèn)“建庫、報(bào)名、錄入、排名”整條鏈路是通的也能幫你在答辯前發(fā)現(xiàn)最后的隱患。準(zhǔn)備兩支隊(duì)各5名運(yùn)動(dòng)員建3個(gè)項(xiàng)目男子100米徑賽單位秒男子跳遠(yuǎn)田賽單位米女子鉛球田賽單位米。給其中一人故意報(bào)兩個(gè)開始時(shí)間重疊的項(xiàng)目檢驗(yàn)沖突攔截再故意錄入兩個(gè)完全相同的成績檢驗(yàn)并列名次處理比賽跑兩輪預(yù)賽和決賽都錄進(jìn)去看最終排名是否取到了最好成績。登錄管理員→批量導(dǎo)入運(yùn)動(dòng)員→逐項(xiàng)報(bào)名→切換裁判賬號(hào)錄入成績→打開排名頁每一步記下頁面顯示的結(jié)果。然后把排名頁的數(shù)據(jù)導(dǎo)出用Excel手工排一遍徑賽升序、田賽降序并列成績名次相同。如果頁面順序和你手算的完全一致代碼核心邏輯就過關(guān)了。不一致也別慌先看是不是5.2的精度問題再看3.2的排序方向是不是寫反了。順手說一個(gè)批量錄入的實(shí)用技巧這套資源支持用Excel模板導(dǎo)入運(yùn)動(dòng)員與成績字段對(duì)應(yīng)關(guān)系如下。Excel列對(duì)應(yīng)字段注意點(diǎn)運(yùn)動(dòng)員學(xué)號(hào)student_no重復(fù)的整行拒絕導(dǎo)入姓名athlete.name首尾空格要去掉性別athlete.gender只能填M或F項(xiàng)目名稱event.event_name必須和event表完全一致輪次result.round_no填1或2超出拒絕成績r(jià)esult.score_value保留3位小數(shù)徑賽與田賽單位提前說明解析Excel用Apache POI的XSSFWorkbook注意它處理的是.xlsx而不是老格式.xls。讀取單元格時(shí)用getCellType()判斷是數(shù)字還是字符串輪次列用BigDecimal.valueOf(cell.getNumericCellValue()).intValue()成績列直接保留三位小數(shù)。很多同學(xué)在這里摔過跤拿cell.getStringCellValue()去讀數(shù)字單元格拋異常不說數(shù)據(jù)全丟。我第一次驗(yàn)收課設(shè)時(shí)直接拿了老師給的現(xiàn)成數(shù)據(jù)跑看起來一切正常結(jié)果換了自己造的10個(gè)運(yùn)動(dòng)員數(shù)據(jù)后排名直接錯(cuò)了一半。從那以后每次拿到Java管理系統(tǒng)源碼我都會(huì)自己造一批邊界數(shù)據(jù)——空成績、并列成績、重名運(yùn)動(dòng)員、超長字符串——從頭到尾完整走一遍確認(rèn)排名和報(bào)表都對(duì)才敢拿去答辯。這個(gè)習(xí)慣后來幫我頂住了好幾次現(xiàn)場演示翻車。希望幫到你。本文還有配套的精品資源點(diǎn)擊獲取