設(shè)計與實現(xiàn)（論文+源碼）)
簡介這份學生成績信息管理系統(tǒng)項目面向課程設(shè)計、畢業(yè)設(shè)計與后端入門實戰(zhàn)人群提供論文文檔和完整源碼幫助理解成績錄入、查詢、統(tǒng)計、報表生成及用戶權(quán)限等模塊的實現(xiàn)思路。壓縮包共311個文件約3.48MB包含86個cs源碼、29個aspx頁面、67個gif與24個jpg界面素材并配有dll、config、數(shù)據(jù)庫文件和項目解決方案覆蓋前端頁面、后端邏輯與部署配置目錄分層便于檢索。已有60人學習下載。讀者可據(jù)此梳理需求分析、數(shù)據(jù)模型與系統(tǒng)架構(gòu)設(shè)計參考成績查詢、班級課程管理、留言及用戶管理等頁面的組織方式也能對照論文理解測試與異常處理流程適合用作課程作業(yè)改造、畢業(yè)設(shè)計參考或快速搭建可運行的管理系統(tǒng)原型。1. 需求切入從一張期末成績Excel說起每到期末教務(wù)老師手里那張Excel表就開始“渡劫”改一個學號排名公式全錯補錄一個緩考成績平均分對不上學生打電話問成績還得翻聊天記錄找密碼。學生成績信息管理系統(tǒng)聽起來像課設(shè)標配但真要做到能交付難點不在增刪改查而在數(shù)據(jù)一致性、權(quán)限邊界和批量操作的容錯。這份學生成績信息管理系統(tǒng)論文源碼面向畢業(yè)設(shè)計和課程設(shè)計場景覆蓋需求分析、庫表設(shè)計、接口實現(xiàn)和驗收測試適合想完整走一遍工程流程、而不是拼一個玩具Demo的人。下面按“選型—庫表—模塊—避坑—驗收”拆開講能抄作業(yè)的地方直接給代碼和配置。2. 技術(shù)選型與總體架構(gòu)三層結(jié)構(gòu) 四個核心模塊的職責劃分2.1 技術(shù)選型為什么用 Spring Boot MyBatis-Plus MySQL 而不是純 JSP學生成績管理系統(tǒng)的業(yè)務(wù)邏輯不復(fù)雜但角色多、查詢條件碎、批量導入容易翻車。選 Spring Boot 不是為了追新而是它把 Controller、Service、Mapper 三層切得清楚出問題能快速定位到某一層。MyBatis-Plus 省掉大量單表 CRUD 的 XML復(fù)雜統(tǒng)計再寫原生 SQL兼顧開發(fā)效率和可控性。前端用 Vue Element UI 做管理端學生端可以復(fù)用同一套接口做移動端適配不把前后端耦死在 JSP 里。核心依賴通常這樣引入版本按實際環(huán)境鎖定不要來回漂移!-- pom.xml 核心依賴片段 -- dependencies !-- Web 層提供 REST 接口和參數(shù)校驗 -- dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-web/artifactId /dependency !-- 持久層MyBatis-Plus 簡化單表操作復(fù)雜 SQL 仍寫 XML -- dependency groupIdcom.baomidou/groupId artifactIdmybatis-plus-boot-starter/artifactId version3.5.3/version /dependency !-- MySQL 驅(qū)動注意和本地數(shù)據(jù)庫版本匹配 -- dependency groupIdcom.mysql/groupId artifactIdmysql-connector-j/artifactId scoperuntime/scope /dependency !-- Excel 解析批量導入成績時用 EasyExcel比 POI 省內(nèi)存 -- dependency groupIdcom.alibaba/groupId artifactIdeasyexcel/artifactId version3.3.2/version /dependency /dependencies這段依賴的關(guān)鍵在 EasyExcel成績導入動輒幾百上千行用 POI 的XSSFWorkbook一次性讀進內(nèi)存遇到大文件容易把堆撐爆。EasyExcel 按行回調(diào)內(nèi)存占用穩(wěn)定。MyBatis-Plus 的LambdaQueryWrapper用來拼多條件查詢避免手寫字符串拼接導致 SQL 注入。MySQL 選 8.0 以上方便用窗口函數(shù)做排名統(tǒng)計后面統(tǒng)計報表會用到。2.2 總體架構(gòu)與模塊劃分表現(xiàn)層、業(yè)務(wù)層、數(shù)據(jù)層怎么切系統(tǒng)按四塊業(yè)務(wù)切用戶權(quán)限模塊、基礎(chǔ)數(shù)據(jù)模塊學生/課程/班級、成績管理模塊、統(tǒng)計報表模塊。表現(xiàn)層只做參數(shù)接收和結(jié)果包裝不寫業(yè)務(wù)判斷業(yè)務(wù)層負責校驗、事務(wù)和權(quán)限過濾數(shù)據(jù)層只做持久化。目錄結(jié)構(gòu)通常這樣組織讓接手的人一眼能定位src/main/java/com/example/score/ ├── controller/ # 接口層接收請求調(diào)用 service │ ├── AuthController.java │ ├── StudentController.java │ ├── CourseController.java │ └── ScoreController.java ├── service/ # 業(yè)務(wù)層校驗、事務(wù)、權(quán)限過濾 │ ├── impl/ │ │ ├── ScoreServiceImpl.java │ │ └── StatsServiceImpl.java │ └── ScoreService.java ├── mapper/ # 數(shù)據(jù)層MyBatis-Plus Mapper 與 XML │ ├── ScoreMapper.java │ └── xml/ScoreMapper.xml ├── entity/ # 數(shù)據(jù)庫實體 ├── dto/ # 入?yún)⒑统鰠ο蟛恢苯颖┞?entity └── common/ # 統(tǒng)一返回、異常處理、攔截器四個模塊的職責邊界要在論文里寫清楚用戶權(quán)限模塊管登錄、角色、菜單基礎(chǔ)數(shù)據(jù)模塊管學生和課程的增刪改查但刪除課程時要檢查是否已有成績關(guān)聯(lián)成績管理模塊管錄入、導入、修改、查詢所有寫操作必須校驗“當前用戶是否有權(quán)操作這門課”統(tǒng)計報表模塊只讀但查詢條件多單獨拆 service 避免和寫邏輯攪在一起。我一般會把權(quán)限校驗放在 Controller 層之前用攔截器解析 token 拿到用戶角色和 id再在 Service 里按角色拼查詢條件而不是讓前端傳studentId就信。提示不要把權(quán)限判斷寫在 SQL 的 where 里靠前端傳參學生端一旦改請求參數(shù)就能查到別人成績這是課設(shè)答辯最容易被問穿的點。3. 數(shù)據(jù)庫設(shè)計與核心表結(jié)構(gòu)從成績錄入黨到統(tǒng)計查詢的字段取舍3.1 核心表結(jié)構(gòu)設(shè)計學生表、課程表、成績表、用戶表成績管理系統(tǒng)的庫表不多但字段取舍直接決定后面統(tǒng)計查詢好不好寫。學生表存學號、姓名、班級、入學年份課程表存課程號、課程名、學分、授課教師成績表存學生 id、課程 id、學期、分數(shù)、錄入時間。注意成績表不要直接存學號和課程名用外鍵 id 關(guān)聯(lián)否則改一次學生姓名就要全表更新。建表語句通常這樣寫-- 學生表學號唯一班級用字符串先兜住后續(xù)可拆班級表 CREATE TABLE student ( id BIGINT PRIMARY KEY AUTO_INCREMENT, student_no VARCHAR(20) NOT NULL COMMENT 學號, name VARCHAR(50) NOT NULL COMMENT 姓名, class_name VARCHAR(50) NOT NULL COMMENT 班級, enroll_year INT NOT NULL COMMENT 入學年份, deleted TINYINT DEFAULT 0 COMMENT 邏輯刪除0正常 1刪除, UNIQUE KEY uk_student_no (student_no) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; -- 課程表課程號唯一teacher_id 關(guān)聯(lián)用戶表里的教師角色 CREATE TABLE course ( id BIGINT PRIMARY KEY AUTO_INCREMENT, course_no VARCHAR(20) NOT NULL COMMENT 課程號, course_name VARCHAR(100) NOT NULL COMMENT 課程名, credit DECIMAL(3,1) NOT NULL COMMENT 學分保留一位小數(shù), teacher_id BIGINT NOT NULL COMMENT 授課教師用戶id, deleted TINYINT DEFAULT 0, UNIQUE KEY uk_course_no (course_no) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; -- 成績表同一學生同一課程同一學期只能有一條記錄 CREATE TABLE score ( id BIGINT PRIMARY KEY AUTO_INCREMENT, student_id BIGINT NOT NULL COMMENT 學生id, course_id BIGINT NOT NULL COMMENT 課程id, term VARCHAR(20) NOT NULL COMMENT 學期如2024-2025-1, score DECIMAL(5,2) DEFAULT NULL COMMENT 分數(shù)0-100允許空表示未錄入, create_time DATETIME DEFAULT CURRENT_TIMESTAMP, update_time DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP, deleted TINYINT DEFAULT 0, UNIQUE KEY uk_student_course_term (student_id, course_id, term), KEY idx_course_term (course_id, term) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;成績表的DECIMAL(5,2)比FLOAT穩(wěn)算平均分時不會出現(xiàn)79.999999這種玄學尾數(shù)。term字段必須有否則補考和重修成績會覆蓋原始成績統(tǒng)計時說不清。聯(lián)合唯一索引uk_student_course_term是防重復(fù)錄入的第一道閘后面導入邏輯還要配合它做更新而不是插入。3.2 索引與約束設(shè)計避免全表掃描和重復(fù)錄入成績查詢最常見的條件是“某學期某課程”和“某學生所有課程”。成績表上除了聯(lián)合唯一索引再補一個idx_course_term讓按課程統(tǒng)計平均分時走索引。學生表按學號查唯一索引自帶課程表按課程號查同理。不要給每個字段都加索引成績表寫入頻繁索引過多拖慢導入。外鍵約束在課設(shè)里常有爭議加了外鍵刪除課程會報錯不加又怕臟數(shù)據(jù)。我一般保留外鍵但設(shè)為ON DELETE RESTRICT先查成績再刪課程業(yè)務(wù)層給明確提示“該課程已有成績不能直接刪除”。如果為了演示方便改成邏輯刪除就要在查詢時統(tǒng)一帶上deleted 0否則統(tǒng)計會把刪掉的課程也算進去。邏輯刪除字段用TINYINT而不是BOOLEAN方便后續(xù)擴展刪除狀態(tài)。注意論文里寫“使用外鍵保證參照完整性”沒問題但代碼里要處理好刪除順序否則答辯演示時刪課程直接拋 500很尷尬。4. 成績管理模塊實現(xiàn)錄入、批量導入、修改與查詢的完整鏈路4.1 成績錄入與批量導入從Excel解析到入庫的容錯處理單條錄入簡單難的是批量導入。Excel 里可能有學號不存在、分數(shù)超過 100、同一學生同一課程重復(fù)行。實現(xiàn)思路是先用 EasyExcel 讀成 DTO 列表逐行校驗校驗失敗的收集錯誤行號返回給前端校驗通過的按“存在則更新、不存在則插入”入庫。關(guān)鍵代碼在 Service 層Service public class ScoreServiceImpl implements ScoreService { Resource private StudentMapper studentMapper; Resource private CourseMapper courseMapper; Resource private ScoreMapper scoreMapper; Transactional(rollbackFor Exception.class) public ImportResult importScores(MultipartFile file, String term) { ListScoreImportDTO rows EasyExcel.read(file.getInputStream()) .head(ScoreImportDTO.class).sheet().doReadSync(); ListString errors new ArrayList(); for (int i 0; i rows.size(); i) { ScoreImportDTO row rows.get(i); // 校驗學號和課程號是否存在避免寫入孤兒成績 Student student studentMapper.selectByStudentNo(row.getStudentNo()); Course course courseMapper.selectByCourseNo(row.getCourseNo()); if (student null) { errors.add(第 (i 2) 行學號不存在); continue; } if (course null) { errors.add(第 (i 2) 行課程號不存在); continue; } if (row.getScore() ! null (row.getScore().compareTo(BigDecimal.ZERO) 0 || row.getScore().compareTo(new BigDecimal(100)) 0)) { errors.add(第 (i 2) 行分數(shù)必須在0-100之間); continue; } // 依賴聯(lián)合唯一索引做 upsert避免先查后插的并發(fā)重復(fù) Score score new Score(); score.setStudentId(student.getId()); score.setCourseId(course.getId()); score.setTerm(term); score.setScore(row.getScore()); scoreMapper.upsert(score); } return new ImportResult(rows.size() - errors.size(), errors); } }upsert在 Mapper XML 里用INSERT ... ON DUPLICATE KEY UPDATE這樣即使兩個老師同時導入同一門課也不會出現(xiàn)重復(fù)行。錯誤行不中斷整批導入前端拿到errors列表后逐條修正再傳比整批回滾更實用。參數(shù)上term由前端選擇不在 Excel 里讀防止不同學期混在一個文件里。4.2 修改刪除與權(quán)限控制基于角色的數(shù)據(jù)范圍過濾成績修改必須留痕至少記錄update_time有條件的加操作日志表。權(quán)限分三種管理員看全部教師只看自己教的課程學生只看自己。實現(xiàn)上不信任前端傳的studentId從登錄 token 解析當前用戶。教師角色在查成績時Service 層先查該教師所授課程 id 列表再把這些 id 作為in條件拼進查詢學生角色則強制把student_id設(shè)為當前用戶 id。// 偽代碼按角色收窄查詢范圍 public PageScoreVO pageScores(ScoreQuery query, LoginUser user) { LambdaQueryWrapperScore wrapper new LambdaQueryWrapper(); wrapper.eq(Score::getTerm, query.getTerm()); if (TEACHER.equals(user.getRole())) { ListLong courseIds courseMapper.selectIdsByTeacherId(user.getId()); if (courseIds.isEmpty()) { return Page.empty(); } wrapper.in(Score::getCourseId, courseIds); } else if (STUDENT.equals(user.getRole())) { wrapper.eq(Score::getStudentId, user.getId()); // 強制覆蓋前端傳參 } // 管理員不加額外條件但支持按班級、課程篩選 return scoreMapper.selectPage(query.toPage(), wrapper); }刪除成績用邏輯刪除不物理刪否則學生查歷史成績時記錄憑空消失。教師不能刪除別人課程的成績在刪除前校驗course.teacher_id是否等于當前用戶 id。這一步常被忽略答辯時被問到“教師能不能改別的課成績”就露餡。4.3 查詢與統(tǒng)計報表接口多條件分頁與排名計算統(tǒng)計報表一般要班級排名、課程平均分、及格率。不要在前端算數(shù)據(jù)量一大就卡。排名用 MySQL 8 的窗口函數(shù)一次查出-- 按課程和學期計算學生排名分數(shù)相同名次并列 SELECT s.student_id, st.name, s.score, RANK() OVER (PARTITION BY s.course_id, s.term ORDER BY s.score DESC) AS rank_no FROM score s JOIN student st ON st.id s.student_id WHERE s.course_id #{courseId} AND s.term #{term} AND s.deleted 0 ORDER BY rank_no;接口分頁時注意count查詢和列表查詢分開寫別用 MyBatis-Plus 的自動分頁去套復(fù)雜 SQL容易生成低效的select count(*) from (子查詢)。平均分和及格率用聚合查詢加ROUND(AVG(score),2)保留兩位。前端展示表格時把排名、平均分、及格率做成匯總行答辯演示時一眼能看到統(tǒng)計結(jié)果。提示統(tǒng)計接口要加緩存或至少限制查詢時間范圍否則全學期全課程一起算演示時頁面轉(zhuǎn)圈超過三秒評委耐心就沒了。5. 避坑與常見問題排查從數(shù)據(jù)一致性到并發(fā)錄入的五個翻車點5.1 批量導入重復(fù)數(shù)據(jù)導致平均分翻倍現(xiàn)象同一份 Excel 導入兩次后課程平均分變成原來的兩倍但學生成績列表看起來正常。原因成績表沒有聯(lián)合唯一索引或者導入邏輯用“先查后插”并發(fā)時兩次都查不到就都插入。解決建(student_id, course_id, term)唯一索引導入用ON DUPLICATE KEY UPDATE并在導入結(jié)果里返回“更新了多少條、新增了多少條”讓操作人心里有數(shù)。5.2 修改成績后排名頁面還是舊數(shù)據(jù)現(xiàn)象老師改了某學生分數(shù)刷新排名頁還是原來的名次。原因統(tǒng)計結(jié)果寫進了緩存或中間表修改成績時沒失效。解決排名實時用窗口函數(shù)算不落中間表如果為了性能必須緩存就在成績寫操作后按course_id term刪緩存別用全量清空。5.3 學生越權(quán)查到別人成績現(xiàn)象學生端抓包改studentId就能看到同班同學成績。原因接口只按前端傳參過濾沒從登錄態(tài)取用戶 id。解決在攔截器里把當前用戶放進 ThreadLocalService 層對學生角色強制覆蓋查詢條件并加單元測試模擬篡改參數(shù)。5.4 刪除課程后成績表出現(xiàn)孤兒記錄現(xiàn)象課程管理里刪了一門課成績查詢里出現(xiàn)課程名為空的記錄。原因物理刪除課程但成績表沒處理或者邏輯刪除后查詢沒帶deleted 0。解決刪除課程前先查成績表是否有引用有則拒絕刪除并提示如果必須刪走級聯(lián)邏輯刪除并在統(tǒng)計查詢里統(tǒng)一過濾。5.5 深度分頁導致查詢變慢現(xiàn)象成績列表翻到第 100 頁時明顯卡頓。原因LIMIT 10000, 10這種深度分頁要掃描前一萬行。解決限制最大可翻頁數(shù)或者改用游標分頁按 id 或?qū)W號排序后傳上一頁最后一條的 id再或者在查詢條件里強制帶學期和課程縮小數(shù)據(jù)集。課設(shè)數(shù)據(jù)量不大但論文里寫上這個取舍會加分。6. 驗收與答辯一份測試清單和一個演示腳本驗收別只看“頁面能打開”按功能點和異常場景列清單。下面這張表可以直接放進論文的測試章節(jié)測試項輸入或操作預(yù)期結(jié)果重復(fù)導入同一份成績同一 Excel 連續(xù)導入兩次第二次提示更新條數(shù)平均分不變學生越權(quán)查詢學生賬號請求時篡改 studentId返回 403 或僅返回本人數(shù)據(jù)刪除已有成績的課程管理員刪除課程提示“存在成績記錄不能刪除”分數(shù)邊界錄入 -1 或 101接口返回校驗錯誤不入庫教師跨課程修改教師 A 修改教師 B 課程成績返回無權(quán)限答辯演示按“登錄—基礎(chǔ)數(shù)據(jù)—成績錄入—統(tǒng)計報表—異常演示”走控制在 5 分鐘內(nèi)。先展示管理員建課程、導入成績再切教師賬號看自己課程最后切學生賬號查個人成績中間故意觸發(fā)一次重復(fù)導入讓評委看到錯誤提示和更新條數(shù)。這個順序比從頭到尾點菜單更有說服力。從那以后我每次交付這類系統(tǒng)都強制走一遍“臟數(shù)據(jù)導入 越權(quán)訪問 重復(fù)提交”三連測不靠肉眼點頁面。希望這份方案能幫到你少走幾個我踩過的坑。本文還有配套的精品資源點擊獲取 基于Spring Boot的學生成績管理系統(tǒng)設(shè)計與實現(xiàn)（論文+源碼）
簡介這份學生成績信息管理系統(tǒng)項目面向課程設(shè)計、畢業(yè)設(shè)計與后端入門實戰(zhàn)人群提供論文文檔和完整源碼幫助理解成績錄入、查詢、統(tǒng)計、報表生成及用戶權(quán)限等模塊的實現(xiàn)思路。壓縮包共311個文件約3.48MB包含86個cs源碼、29個aspx頁面、67個gif與24個jpg界面素材并配有dll、config、數(shù)據(jù)庫文件和項目解決方案覆蓋前端頁面、后端邏輯與部署配置目錄分層便于檢索。已有60人學習下載。讀者可據(jù)此梳理需求分析、數(shù)據(jù)模型與系統(tǒng)架構(gòu)設(shè)計參考成績查詢、班級課程管理、留言及用戶管理等頁面的組織方式也能對照論文理解測試與異常處理流程適合用作課程作業(yè)改造、畢業(yè)設(shè)計參考或快速搭建可運行的管理系統(tǒng)原型。1. 需求切入從一張期末成績Excel說起每到期末教務(wù)老師手里那張Excel表就開始“渡劫”改一個學號排名公式全錯補錄一個緩考成績平均分對不上學生打電話問成績還得翻聊天記錄找密碼。學生成績信息管理系統(tǒng)聽起來像課設(shè)標配但真要做到能交付難點不在增刪改查而在數(shù)據(jù)一致性、權(quán)限邊界和批量操作的容錯。這份學生成績信息管理系統(tǒng)論文源碼面向畢業(yè)設(shè)計和課程設(shè)計場景覆蓋需求分析、庫表設(shè)計、接口實現(xiàn)和驗收測試適合想完整走一遍工程流程、而不是拼一個玩具Demo的人。下面按“選型—庫表—模塊—避坑—驗收”拆開講能抄作業(yè)的地方直接給代碼和配置。2. 技術(shù)選型與總體架構(gòu)三層結(jié)構(gòu) 四個核心模塊的職責劃分2.1 技術(shù)選型為什么用 Spring Boot MyBatis-Plus MySQL 而不是純 JSP學生成績管理系統(tǒng)的業(yè)務(wù)邏輯不復(fù)雜但角色多、查詢條件碎、批量導入容易翻車。選 Spring Boot 不是為了追新而是它把 Controller、Service、Mapper 三層切得清楚出問題能快速定位到某一層。MyBatis-Plus 省掉大量單表 CRUD 的 XML復(fù)雜統(tǒng)計再寫原生 SQL兼顧開發(fā)效率和可控性。前端用 Vue Element UI 做管理端學生端可以復(fù)用同一套接口做移動端適配不把前后端耦死在 JSP 里。核心依賴通常這樣引入版本按實際環(huán)境鎖定不要來回漂移!-- pom.xml 核心依賴片段 -- dependencies !-- Web 層提供 REST 接口和參數(shù)校驗 -- dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-web/artifactId /dependency !-- 持久層MyBatis-Plus 簡化單表操作復(fù)雜 SQL 仍寫 XML -- dependency groupIdcom.baomidou/groupId artifactIdmybatis-plus-boot-starter/artifactId version3.5.3/version /dependency !-- MySQL 驅(qū)動注意和本地數(shù)據(jù)庫版本匹配 -- dependency groupIdcom.mysql/groupId artifactIdmysql-connector-j/artifactId scoperuntime/scope /dependency !-- Excel 解析批量導入成績時用 EasyExcel比 POI 省內(nèi)存 -- dependency groupIdcom.alibaba/groupId artifactIdeasyexcel/artifactId version3.3.2/version /dependency /dependencies這段依賴的關(guān)鍵在 EasyExcel成績導入動輒幾百上千行用 POI 的XSSFWorkbook一次性讀進內(nèi)存遇到大文件容易把堆撐爆。EasyExcel 按行回調(diào)內(nèi)存占用穩(wěn)定。MyBatis-Plus 的LambdaQueryWrapper用來拼多條件查詢避免手寫字符串拼接導致 SQL 注入。MySQL 選 8.0 以上方便用窗口函數(shù)做排名統(tǒng)計后面統(tǒng)計報表會用到。2.2 總體架構(gòu)與模塊劃分表現(xiàn)層、業(yè)務(wù)層、數(shù)據(jù)層怎么切系統(tǒng)按四塊業(yè)務(wù)切用戶權(quán)限模塊、基礎(chǔ)數(shù)據(jù)模塊學生/課程/班級、成績管理模塊、統(tǒng)計報表模塊。表現(xiàn)層只做參數(shù)接收和結(jié)果包裝不寫業(yè)務(wù)判斷業(yè)務(wù)層負責校驗、事務(wù)和權(quán)限過濾數(shù)據(jù)層只做持久化。目錄結(jié)構(gòu)通常這樣組織讓接手的人一眼能定位src/main/java/com/example/score/ ├── controller/ # 接口層接收請求調(diào)用 service │ ├── AuthController.java │ ├── StudentController.java │ ├── CourseController.java │ └── ScoreController.java ├── service/ # 業(yè)務(wù)層校驗、事務(wù)、權(quán)限過濾 │ ├── impl/ │ │ ├── ScoreServiceImpl.java │ │ └── StatsServiceImpl.java │ └── ScoreService.java ├── mapper/ # 數(shù)據(jù)層MyBatis-Plus Mapper 與 XML │ ├── ScoreMapper.java │ └── xml/ScoreMapper.xml ├── entity/ # 數(shù)據(jù)庫實體 ├── dto/ # 入?yún)⒑统鰠ο蟛恢苯颖┞?entity └── common/ # 統(tǒng)一返回、異常處理、攔截器四個模塊的職責邊界要在論文里寫清楚用戶權(quán)限模塊管登錄、角色、菜單基礎(chǔ)數(shù)據(jù)模塊管學生和課程的增刪改查但刪除課程時要檢查是否已有成績關(guān)聯(lián)成績管理模塊管錄入、導入、修改、查詢所有寫操作必須校驗“當前用戶是否有權(quán)操作這門課”統(tǒng)計報表模塊只讀但查詢條件多單獨拆 service 避免和寫邏輯攪在一起。我一般會把權(quán)限校驗放在 Controller 層之前用攔截器解析 token 拿到用戶角色和 id再在 Service 里按角色拼查詢條件而不是讓前端傳studentId就信。提示不要把權(quán)限判斷寫在 SQL 的 where 里靠前端傳參學生端一旦改請求參數(shù)就能查到別人成績這是課設(shè)答辯最容易被問穿的點。3. 數(shù)據(jù)庫設(shè)計與核心表結(jié)構(gòu)從成績錄入黨到統(tǒng)計查詢的字段取舍3.1 核心表結(jié)構(gòu)設(shè)計學生表、課程表、成績表、用戶表成績管理系統(tǒng)的庫表不多但字段取舍直接決定后面統(tǒng)計查詢好不好寫。學生表存學號、姓名、班級、入學年份課程表存課程號、課程名、學分、授課教師成績表存學生 id、課程 id、學期、分數(shù)、錄入時間。注意成績表不要直接存學號和課程名用外鍵 id 關(guān)聯(lián)否則改一次學生姓名就要全表更新。建表語句通常這樣寫-- 學生表學號唯一班級用字符串先兜住后續(xù)可拆班級表 CREATE TABLE student ( id BIGINT PRIMARY KEY AUTO_INCREMENT, student_no VARCHAR(20) NOT NULL COMMENT 學號, name VARCHAR(50) NOT NULL COMMENT 姓名, class_name VARCHAR(50) NOT NULL COMMENT 班級, enroll_year INT NOT NULL COMMENT 入學年份, deleted TINYINT DEFAULT 0 COMMENT 邏輯刪除0正常 1刪除, UNIQUE KEY uk_student_no (student_no) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; -- 課程表課程號唯一teacher_id 關(guān)聯(lián)用戶表里的教師角色 CREATE TABLE course ( id BIGINT PRIMARY KEY AUTO_INCREMENT, course_no VARCHAR(20) NOT NULL COMMENT 課程號, course_name VARCHAR(100) NOT NULL COMMENT 課程名, credit DECIMAL(3,1) NOT NULL COMMENT 學分保留一位小數(shù), teacher_id BIGINT NOT NULL COMMENT 授課教師用戶id, deleted TINYINT DEFAULT 0, UNIQUE KEY uk_course_no (course_no) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; -- 成績表同一學生同一課程同一學期只能有一條記錄 CREATE TABLE score ( id BIGINT PRIMARY KEY AUTO_INCREMENT, student_id BIGINT NOT NULL COMMENT 學生id, course_id BIGINT NOT NULL COMMENT 課程id, term VARCHAR(20) NOT NULL COMMENT 學期如2024-2025-1, score DECIMAL(5,2) DEFAULT NULL COMMENT 分數(shù)0-100允許空表示未錄入, create_time DATETIME DEFAULT CURRENT_TIMESTAMP, update_time DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP, deleted TINYINT DEFAULT 0, UNIQUE KEY uk_student_course_term (student_id, course_id, term), KEY idx_course_term (course_id, term) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;成績表的DECIMAL(5,2)比FLOAT穩(wěn)算平均分時不會出現(xiàn)79.999999這種玄學尾數(shù)。term字段必須有否則補考和重修成績會覆蓋原始成績統(tǒng)計時說不清。聯(lián)合唯一索引uk_student_course_term是防重復(fù)錄入的第一道閘后面導入邏輯還要配合它做更新而不是插入。3.2 索引與約束設(shè)計避免全表掃描和重復(fù)錄入成績查詢最常見的條件是“某學期某課程”和“某學生所有課程”。成績表上除了聯(lián)合唯一索引再補一個idx_course_term讓按課程統(tǒng)計平均分時走索引。學生表按學號查唯一索引自帶課程表按課程號查同理。不要給每個字段都加索引成績表寫入頻繁索引過多拖慢導入。外鍵約束在課設(shè)里常有爭議加了外鍵刪除課程會報錯不加又怕臟數(shù)據(jù)。我一般保留外鍵但設(shè)為ON DELETE RESTRICT先查成績再刪課程業(yè)務(wù)層給明確提示“該課程已有成績不能直接刪除”。如果為了演示方便改成邏輯刪除就要在查詢時統(tǒng)一帶上deleted 0否則統(tǒng)計會把刪掉的課程也算進去。邏輯刪除字段用TINYINT而不是BOOLEAN方便后續(xù)擴展刪除狀態(tài)。注意論文里寫“使用外鍵保證參照完整性”沒問題但代碼里要處理好刪除順序否則答辯演示時刪課程直接拋 500很尷尬。4. 成績管理模塊實現(xiàn)錄入、批量導入、修改與查詢的完整鏈路4.1 成績錄入與批量導入從Excel解析到入庫的容錯處理單條錄入簡單難的是批量導入。Excel 里可能有學號不存在、分數(shù)超過 100、同一學生同一課程重復(fù)行。實現(xiàn)思路是先用 EasyExcel 讀成 DTO 列表逐行校驗校驗失敗的收集錯誤行號返回給前端校驗通過的按“存在則更新、不存在則插入”入庫。關(guān)鍵代碼在 Service 層Service public class ScoreServiceImpl implements ScoreService { Resource private StudentMapper studentMapper; Resource private CourseMapper courseMapper; Resource private ScoreMapper scoreMapper; Transactional(rollbackFor Exception.class) public ImportResult importScores(MultipartFile file, String term) { ListScoreImportDTO rows EasyExcel.read(file.getInputStream()) .head(ScoreImportDTO.class).sheet().doReadSync(); ListString errors new ArrayList(); for (int i 0; i rows.size(); i) { ScoreImportDTO row rows.get(i); // 校驗學號和課程號是否存在避免寫入孤兒成績 Student student studentMapper.selectByStudentNo(row.getStudentNo()); Course course courseMapper.selectByCourseNo(row.getCourseNo()); if (student null) { errors.add(第 (i 2) 行學號不存在); continue; } if (course null) { errors.add(第 (i 2) 行課程號不存在); continue; } if (row.getScore() ! null (row.getScore().compareTo(BigDecimal.ZERO) 0 || row.getScore().compareTo(new BigDecimal(100)) 0)) { errors.add(第 (i 2) 行分數(shù)必須在0-100之間); continue; } // 依賴聯(lián)合唯一索引做 upsert避免先查后插的并發(fā)重復(fù) Score score new Score(); score.setStudentId(student.getId()); score.setCourseId(course.getId()); score.setTerm(term); score.setScore(row.getScore()); scoreMapper.upsert(score); } return new ImportResult(rows.size() - errors.size(), errors); } }upsert在 Mapper XML 里用INSERT ... ON DUPLICATE KEY UPDATE這樣即使兩個老師同時導入同一門課也不會出現(xiàn)重復(fù)行。錯誤行不中斷整批導入前端拿到errors列表后逐條修正再傳比整批回滾更實用。參數(shù)上term由前端選擇不在 Excel 里讀防止不同學期混在一個文件里。4.2 修改刪除與權(quán)限控制基于角色的數(shù)據(jù)范圍過濾成績修改必須留痕至少記錄update_time有條件的加操作日志表。權(quán)限分三種管理員看全部教師只看自己教的課程學生只看自己。實現(xiàn)上不信任前端傳的studentId從登錄 token 解析當前用戶。教師角色在查成績時Service 層先查該教師所授課程 id 列表再把這些 id 作為in條件拼進查詢學生角色則強制把student_id設(shè)為當前用戶 id。// 偽代碼按角色收窄查詢范圍 public PageScoreVO pageScores(ScoreQuery query, LoginUser user) { LambdaQueryWrapperScore wrapper new LambdaQueryWrapper(); wrapper.eq(Score::getTerm, query.getTerm()); if (TEACHER.equals(user.getRole())) { ListLong courseIds courseMapper.selectIdsByTeacherId(user.getId()); if (courseIds.isEmpty()) { return Page.empty(); } wrapper.in(Score::getCourseId, courseIds); } else if (STUDENT.equals(user.getRole())) { wrapper.eq(Score::getStudentId, user.getId()); // 強制覆蓋前端傳參 } // 管理員不加額外條件但支持按班級、課程篩選 return scoreMapper.selectPage(query.toPage(), wrapper); }刪除成績用邏輯刪除不物理刪否則學生查歷史成績時記錄憑空消失。教師不能刪除別人課程的成績在刪除前校驗course.teacher_id是否等于當前用戶 id。這一步常被忽略答辯時被問到“教師能不能改別的課成績”就露餡。4.3 查詢與統(tǒng)計報表接口多條件分頁與排名計算統(tǒng)計報表一般要班級排名、課程平均分、及格率。不要在前端算數(shù)據(jù)量一大就卡。排名用 MySQL 8 的窗口函數(shù)一次查出-- 按課程和學期計算學生排名分數(shù)相同名次并列 SELECT s.student_id, st.name, s.score, RANK() OVER (PARTITION BY s.course_id, s.term ORDER BY s.score DESC) AS rank_no FROM score s JOIN student st ON st.id s.student_id WHERE s.course_id #{courseId} AND s.term #{term} AND s.deleted 0 ORDER BY rank_no;接口分頁時注意count查詢和列表查詢分開寫別用 MyBatis-Plus 的自動分頁去套復(fù)雜 SQL容易生成低效的select count(*) from (子查詢)。平均分和及格率用聚合查詢加ROUND(AVG(score),2)保留兩位。前端展示表格時把排名、平均分、及格率做成匯總行答辯演示時一眼能看到統(tǒng)計結(jié)果。提示統(tǒng)計接口要加緩存或至少限制查詢時間范圍否則全學期全課程一起算演示時頁面轉(zhuǎn)圈超過三秒評委耐心就沒了。5. 避坑與常見問題排查從數(shù)據(jù)一致性到并發(fā)錄入的五個翻車點5.1 批量導入重復(fù)數(shù)據(jù)導致平均分翻倍現(xiàn)象同一份 Excel 導入兩次后課程平均分變成原來的兩倍但學生成績列表看起來正常。原因成績表沒有聯(lián)合唯一索引或者導入邏輯用“先查后插”并發(fā)時兩次都查不到就都插入。解決建(student_id, course_id, term)唯一索引導入用ON DUPLICATE KEY UPDATE并在導入結(jié)果里返回“更新了多少條、新增了多少條”讓操作人心里有數(shù)。5.2 修改成績后排名頁面還是舊數(shù)據(jù)現(xiàn)象老師改了某學生分數(shù)刷新排名頁還是原來的名次。原因統(tǒng)計結(jié)果寫進了緩存或中間表修改成績時沒失效。解決排名實時用窗口函數(shù)算不落中間表如果為了性能必須緩存就在成績寫操作后按course_id term刪緩存別用全量清空。5.3 學生越權(quán)查到別人成績現(xiàn)象學生端抓包改studentId就能看到同班同學成績。原因接口只按前端傳參過濾沒從登錄態(tài)取用戶 id。解決在攔截器里把當前用戶放進 ThreadLocalService 層對學生角色強制覆蓋查詢條件并加單元測試模擬篡改參數(shù)。5.4 刪除課程后成績表出現(xiàn)孤兒記錄現(xiàn)象課程管理里刪了一門課成績查詢里出現(xiàn)課程名為空的記錄。原因物理刪除課程但成績表沒處理或者邏輯刪除后查詢沒帶deleted 0。解決刪除課程前先查成績表是否有引用有則拒絕刪除并提示如果必須刪走級聯(lián)邏輯刪除并在統(tǒng)計查詢里統(tǒng)一過濾。5.5 深度分頁導致查詢變慢現(xiàn)象成績列表翻到第 100 頁時明顯卡頓。原因LIMIT 10000, 10這種深度分頁要掃描前一萬行。解決限制最大可翻頁數(shù)或者改用游標分頁按 id 或?qū)W號排序后傳上一頁最后一條的 id再或者在查詢條件里強制帶學期和課程縮小數(shù)據(jù)集。課設(shè)數(shù)據(jù)量不大但論文里寫上這個取舍會加分。6. 驗收與答辯一份測試清單和一個演示腳本驗收別只看“頁面能打開”按功能點和異常場景列清單。下面這張表可以直接放進論文的測試章節(jié)測試項輸入或操作預(yù)期結(jié)果重復(fù)導入同一份成績同一 Excel 連續(xù)導入兩次第二次提示更新條數(shù)平均分不變學生越權(quán)查詢學生賬號請求時篡改 studentId返回 403 或僅返回本人數(shù)據(jù)刪除已有成績的課程管理員刪除課程提示“存在成績記錄不能刪除”分數(shù)邊界錄入 -1 或 101接口返回校驗錯誤不入庫教師跨課程修改教師 A 修改教師 B 課程成績返回無權(quán)限答辯演示按“登錄—基礎(chǔ)數(shù)據(jù)—成績錄入—統(tǒng)計報表—異常演示”走控制在 5 分鐘內(nèi)。先展示管理員建課程、導入成績再切教師賬號看自己課程最后切學生賬號查個人成績中間故意觸發(fā)一次重復(fù)導入讓評委看到錯誤提示和更新條數(shù)。這個順序比從頭到尾點菜單更有說服力。從那以后我每次交付這類系統(tǒng)都強制走一遍“臟數(shù)據(jù)導入 越權(quán)訪問 重復(fù)提交”三連測不靠肉眼點頁面。希望這份方案能幫到你少走幾個我踩過的坑。本文還有配套的精品資源點擊獲取