畢業(yè)設(shè)計里基于SpringBoot的學(xué)生選課管理系統(tǒng)是一個出現(xiàn)頻率很高的選題。它看起來只是管理課程和學(xué)生選課實際上要處理角色權(quán)限、課程資源約束、選課沖突、成績回填等多個環(huán)節(jié)做完之后幾乎可以把 JavaWeb 階段的知識點全部串起來。這篇博客按照一個完整畢設(shè)項目的推進順序展開從業(yè)務(wù)拆分、表結(jié)構(gòu)設(shè)計、后端接口實現(xiàn)、前端頁面聯(lián)調(diào)到打包部署和常見故障排查全部走一遍。無論你是準(zhǔn)備用這個題目寫畢設(shè)還是想復(fù)現(xiàn)一個 SpringBoot 管理系統(tǒng)加深理解都可以按文章步驟跑出一套可演示、可答辯、可擴展的系統(tǒng)。1. 先理解學(xué)生選課管理系統(tǒng)要解決什么問題1.1 高校選課的核心業(yè)務(wù)流程選課管理系統(tǒng)并不是一個單純的“課程增刪改查”項目。它的核心業(yè)務(wù)是在一個學(xué)期內(nèi)學(xué)生從開設(shè)的課程列表中選擇自己要修的課程系統(tǒng)要保證這門課沒有選滿、學(xué)生沒有重復(fù)選擇、課程時間沒有和其他已選課程沖突。選課結(jié)束后教師還需要看到選課名單錄入成績學(xué)生才能查到最終成績。這個流程涉及三類角色角色主要功能學(xué)生瀏覽課程、選課、退課、查看已選課程、查看成績教師維護課程信息、查看選課名單、錄入成績管理員管理學(xué)生賬號、教師賬號、課程信息、開課學(xué)期很多畢設(shè)項目會把管理員功能做得很大比如部門管理、菜單管理、操作日志統(tǒng)計等。作為畢設(shè)系統(tǒng)這些功能可以做但真正決定項目質(zhì)量的是“選課約束”是否嚴(yán)謹(jǐn)。也就是說學(xué)生選課時系統(tǒng)能不能真的防止重復(fù)選、超容量選、同一時間沖突選而不是只在頁面上提示一個空泛的錯誤。1.2 四個不能回避的業(yè)務(wù)邊界實際做這個系統(tǒng)時會反復(fù)遇到這幾個邊界條件它們是后端代碼設(shè)計的主線。第一一個學(xué)期內(nèi)只能操作當(dāng)前學(xué)期的課程。課程必須帶有學(xué)期字段學(xué)生選課記錄也要綁定學(xué)期否則上一屆的歷史數(shù)據(jù)會混進來。第二選課前必須校驗是否已經(jīng)選過同一門課。這里的判斷不能只靠代碼里的集合判斷還要靠數(shù)據(jù)庫唯一索引兜底防止并發(fā)請求同時寫入。第三選課時必須判斷課程容量。課程有容量上限已選人數(shù)不能超過容量。比如課程容量是 60第 61 個學(xué)生再來選課時必須被拒絕。第四同一天同一時間段不能安排兩門課。判斷時間沖突需要拿到學(xué)生所有已選課程再和當(dāng)前課程的時間段做交叉比對。這四條如果全部落地項目就已經(jīng)超過很多只做增刪改查的畢設(shè)。答辯時被問到“系統(tǒng)怎么保證選課數(shù)據(jù)正確”可以直接從這四個約束入手展開。1.3 為什么選 Spring Boot 作為畢設(shè)基礎(chǔ)框架選課管理系統(tǒng)的功能集中在業(yè)務(wù)邏輯和數(shù)據(jù)操作適合用 Spring Boot 這種“約定優(yōu)先于配置”的框架快速搭建。Spring Boot 自帶內(nèi)嵌的 Tomcat寫完代碼后一個java -jar就能啟動不需要單獨安裝和配置外部服務(wù)器這對計算機設(shè)計演示很有幫助。Spring Boot 的自動配置機制能減少大量 XML 配置數(shù)據(jù)庫連接、事務(wù)管理、Web 請求處理都可以在application.yml里集中維護。更重要的是 Spring Boot 與 MyBatis、MyBatis-Plus、Thymeleaf、Vue 等常見技術(shù)的配合非常成熟。遇到問題搜索時可以找到大量資料適合第一次完整做項目的學(xué)生閱讀和排查。選課管理系統(tǒng)的數(shù)據(jù)量不大、業(yè)務(wù)鏈路清晰不需要微服務(wù)和高性能并發(fā)方案Spring Boot 單體架構(gòu)已經(jīng)足夠。2. 環(huán)境準(zhǔn)備與技術(shù)棧選型2.1 版本約定要一致否則后面全是坑版本選擇是畢設(shè)項目最容易被忽略的地方。很多同學(xué)把別人的源碼拉到本地一啟動就報各種錯誤原因往往是本機 JDK 版本和項目的 Spring Boot 版本不匹配。下面是一套比較穩(wěn)妥的版本組合本次示例代碼也按這個組合設(shè)計組件推薦版本說明JDK8 或 17Spring Boot 2.7.x 用 JDK 8Spring Boot 3.x 用 JDK 17Maven3.6用于依賴管理和打包Spring Boot2.7.x兼容性強資料最多適合畢設(shè)MySQL8.08.0 需要關(guān)注時區(qū)配置MyBatis-Plus3.5.x減少基礎(chǔ) SQL 編寫降低工作量前端方案Thymeleaf 或 Vue 3快速完成選 Thymeleaf想展示前后端分離選 Vue注意如果本機已經(jīng)安裝了 JDK 17建議直接選擇 Spring Boot 3.x。反過來如果本機是 JDK 8卻使用了 Spring Boot 3.x編譯時會出現(xiàn)UnsupportedClassVersionError因為 Spring Boot 3.x 的最低要求是 Java 17。開始編碼之前先使用java -version和mvn -v確認(rèn)本機環(huán)境。2.2 Maven 工程結(jié)構(gòu)規(guī)劃推薦按下面這種結(jié)構(gòu)組織代碼分層清晰答辯時也容易講course-management-system ├── src/main/java/com/example/course │ ├── CourseManagementApplication.java │ ├── config │ │ ├── InterceptorConfig.java │ │ └── WebMvcConfig.java │ ├── controller │ │ ├── LoginController.java │ │ ├── StudentCourseController.java │ │ ├── TeacherCourseController.java │ │ └── AdminController.java │ ├── entity │ │ ├── User.java │ │ ├── Course.java │ │ └── StudentCourse.java │ ├── mapper │ │ ├── UserMapper.java │ │ ├── CourseMapper.java │ │ └── StudentCourseMapper.java │ ├── service │ │ ├── UserService.java │ │ ├── CourseService.java │ │ └── StudentCourseService.java │ ├── interceptor │ │ └── LoginInterceptor.java │ └── vo │ ├── Result.java │ ├── LoginRequest.java │ └── CourseSelectForm.java └── src/main/resources ├── application.yml ├── mapper │ ├── UserMapper.xml │ ├── CourseMapper.xml │ └── StudentCourseMapper.xml └── templates ├── login.html ├── student │ ├── courseList.html │ └── selectedList.html └── teacher ├── courseManage.html └── scoreInput.html業(yè)務(wù)層級按照Controller - Service - Mapper組織實體類放在entity包接口返回數(shù)據(jù)封裝在vo包。這樣每個類的職責(zé)具體答辯時可以直接說清楚每一層的作用。2.3 引入核心依賴在pom.xml中加入以下依賴dependencies dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-web/artifactId /dependency dependency groupIdcom.baomidou/groupId artifactIdmybatis-plus-boot-starter/artifactId version3.5.3.1/version /dependency dependency groupIdmysql/groupId artifactIdmysql-connector-java/artifactId scoperuntime/scope /dependency dependency groupIdorg.projectlombok/groupId artifactIdlombok/artifactId optionaltrue/optional /dependency dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-thymeleaf/artifactId /dependency /dependencies這里把 MyBatis-Plus 放在基礎(chǔ) SQL 編寫的位置可以省去大量重復(fù)的insert、selectById代碼讓關(guān)注點集中在選課規(guī)則上。如果希望練習(xí)手寫 SQL也可以把依賴換成mybatis-spring-boot-starter兩種方式對畢設(shè)都夠用。2.4 配置文件注意時區(qū)和駝峰映射application.yml是項目能否連接數(shù)據(jù)庫的關(guān)鍵下面是一份完整配置server: port: 8080 spring: datasource: driver-class-name: com.mysql.cj.jdbc.Driver url: jdbc:mysql://localhost:3306/course_db?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/Shanghai username: root password: 123456 thymeleaf: cache: false mybatis-plus: configuration: map-underscore-to-camel-case: true log-impl: org.apache.ibatis.logging.stdout.StdOutImpl global-config: db-config: id-type: autoserverTimezoneAsia/Shanghai用于解決 MySQL 8.0 的時區(qū)報錯。map-underscore-to-camel-case: true讓數(shù)據(jù)庫的student_id字段自動映射到實體的studentId屬性避免每次手寫繁瑣的 resultMap。log-impl會把執(zhí)行的 SQL 打印到控制臺選課邏輯出錯時可以直接看到 SQL 語句這在調(diào)試階段非常有用。3. 數(shù)據(jù)庫設(shè)計要支撐業(yè)務(wù)約束3.1 核心表結(jié)構(gòu)總覽選課管理系統(tǒng)的數(shù)據(jù)庫至少包含三張核心表。用戶表保存學(xué)生、教師、管理員賬號課程表保存課程的容量、時間、學(xué)分等基本信息選課記錄表保存學(xué)生和課程之間的綁定關(guān)系以及成績。表名用途user用戶基本信息區(qū)分角色course課程基本信息、容量、時間、學(xué)期student_course學(xué)生選課記錄、成績?nèi)绻枰暾啬M高校場景可以增加student表、teacher表和semester表。畢設(shè)階段為了控制復(fù)雜度可以先合并為上面的三表結(jié)構(gòu)答辯時再說明擴展思路。3.2 建表 SQL下面是一份可以直接執(zhí)行的建表 SQLCREATE DATABASE IF NOT EXISTS course_db DEFAULT CHARACTER SET utf8mb4; USE course_db; CREATE TABLE user ( id BIGINT NOT NULL AUTO_INCREMENT, username VARCHAR(50) NOT NULL UNIQUE, password VARCHAR(100) NOT NULL, real_name VARCHAR(50) DEFAULT NULL, role VARCHAR(20) NOT NULL COMMENT STUDENT/TEACHER/ADMIN, PRIMARY KEY (id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; CREATE TABLE course ( id BIGINT NOT NULL AUTO_INCREMENT, course_name VARCHAR(100) NOT NULL, course_code VARCHAR(50) NOT NULL, teacher_id BIGINT DEFAULT NULL, credit DECIMAL(3, 1) DEFAULT 0, capacity INT NOT NULL DEFAULT 60, selected_num INT NOT NULL DEFAULT 0, start_week INT NOT NULL DEFAULT 1, end_week INT NOT NULL DEFAULT 18, day_of_week INT NOT NULL COMMENT 1-7 表示周一至周日, start_section INT NOT NULL DEFAULT 1 COMMENT 開始節(jié)次, end_section INT NOT NULL DEFAULT 2 COMMENT 結(jié)束節(jié)次, classroom VARCHAR(100) DEFAULT NULL, term VARCHAR(30) NOT NULL COMMENT 例如 2025-2026-1, PRIMARY KEY (id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; CREATE TABLE student_course ( id BIGINT NOT NULL AUTO_INCREMENT, student_id BIGINT NOT NULL, course_id BIGINT NOT NULL, select_time DATETIME DEFAULT CURRENT_TIMESTAMP, score DECIMAL(5, 2) DEFAULT NULL, PRIMARY KEY (id), UNIQUE KEY uk_student_course (student_id, course_id), KEY idx_course_id (course_id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;初始化一些演示賬號INSERT INTO user (username, password, real_name, role) VALUES (admin, 123456, 系統(tǒng)管理員, ADMIN), (teacher01, 123456, 王老師, TEACHER), (student01, 123456, 張三, STUDENT), (student02, 123456, 李四, STUDENT);3.3 字段設(shè)計里的三個關(guān)鍵決策第一個關(guān)鍵決策是選課記錄表必須加唯一索引。只靠 Service 層代碼判斷“是否已選”在單用戶操作時有效但兩個學(xué)生同時請求或者同一個學(xué)生快速點擊兩次選課按鈕時代碼判斷可能同時通過唯一索引uk_student_course會在數(shù)據(jù)庫層攔住重復(fù)數(shù)據(jù)。這是選課系統(tǒng)防止臟數(shù)據(jù)最重要的兜底手段。第二個關(guān)鍵決策是課程表設(shè)計了selected_num冗余字段。它保存當(dāng)前已選人數(shù)目的是在選課操作時執(zhí)行UPDATE course SET selected_num selected_num 1 WHERE id ? AND selected_num capacity這種原子更新而不是先查人數(shù)再更新人數(shù)。這樣即使并發(fā)選課數(shù)據(jù)庫也能通過行鎖保證不會超過容量。第三個關(guān)鍵決策是時間字段拆分成day_of_week、start_section、end_section而不是直接存一個字符串。拆分之后判斷兩門課是否沖突的邏輯更容易實現(xiàn)。比如課程 A 是周一 1-2 節(jié)課程 B 是周一 2-3 節(jié)兩條記錄可以按“星期相同且節(jié)次區(qū)間有交集”來判斷沖突。4. 后端核心實現(xiàn)把約束寫進代碼4.1 登錄認(rèn)證和角色權(quán)限攔截先實現(xiàn)一個簡單的登錄接口。登錄成功后把用戶信息放進 Session后續(xù)請求通過攔截器校驗。RestController RequestMapping(/api/auth) public class LoginController { Resource private UserService userService; PostMapping(/login) public Result login(RequestBody LoginRequest request, HttpSession session) { User user userService.login(request.getUsername(), request.getPassword()); if (user null) { return Result.error(用戶名或密碼錯誤); } session.setAttribute(loginUser, user); return Result.success(user); } PostMapping(/logout) public Result logout(HttpSession session) { session.invalidate(); return Result.success(null); } }攔截器用來統(tǒng)一校驗是否登錄以及訪問路徑是否匹配角色public class LoginInterceptor implements HandlerInterceptor { Override public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception { HttpSession session request.getSession(); User user (User) session.getAttribute(loginUser); if (user null) { response.setContentType(application/json;charsetUTF-8); response.getWriter().write({\code\:401,\message\:\未登錄\}); return false; } String uri request.getRequestURI(); if (uri.startsWith(/api/teacher) !TEACHER.equals(user.getRole()) !ADMIN.equals(user.getRole())) { response.getWriter().write({\code\:403,\message\:\無權(quán)限\}); return false; } return true; } }在配置類里注冊攔截器路徑Configuration public class WebMvcConfig implements WebMvcConfigurer { Override public void addInterceptors(InterceptorRegistry registry) { registry.addInterceptor(new LoginInterceptor()) .addPathPatterns(/api/**) .excludePathPatterns(/api/auth/login); } }攔截器方案比引入 Spring Security 更容易理解適合畢設(shè)項目的代碼講解。如果評委問為什么不直接用 Spring Security可以回答當(dāng)前系統(tǒng)角色只有三種業(yè)務(wù)重點是選課約束使用攔截器可以把復(fù)雜度控制在合理范圍后續(xù)需要細(xì)粒度權(quán)限時再引入安全框架。4.2 課程管理接口課程管理主要包含分頁查詢課程、新增課程、修改課程信息。學(xué)生端只能查詢教師端可以維護課程。RestController RequestMapping(/api/course) public class CourseController { Resource private CourseService courseService; GetMapping(/list) public Result listCourse( RequestParam(required false) String keyword, RequestParam(defaultValue 1) int page, RequestParam(defaultValue 10) int size, HttpSession session) { User user (User) session.getAttribute(loginUser); PageCourse result courseService.getPage(keyword, page, size); return Result.success(result); } PostMapping(/add) public Result addCourse(RequestBody Course course) { courseService.saveCourse(course); return Result.success(null); } }分頁查詢使用 MyBatis-Plus 的Page對象Service public class CourseService { Resource private CourseMapper courseMapper; public PageCourse getPage(String keyword, int page, int size) { LambdaQueryWrapperCourse wrapper new LambdaQueryWrapper(); if (StringUtils.hasText(keyword)) { wrapper.like(Course::getCourseName, keyword) .or().like(Course::getCourseCode, keyword); } PageCourse p new Page(page, size); return courseMapper.selectPage(p, wrapper); } }4.3 核心選課邏輯怎么保證不重復(fù)、不超選、不沖突選課是整個系統(tǒng)技術(shù)含量最高的地方。先定義一個選課表單對象public class CourseSelectForm { private Long courseId; }然后編寫選課 Service 方法Service public class StudentCourseService { Resource private StudentCourseMapper studentCourseMapper; Resource private CourseMapper courseMapper; Autowired private TransactionTemplate transactionTemplate; public Result selectCourse(Long studentId, Long courseId) { Course course courseMapper.selectById(courseId); if (course null) { return Result.error(課程不存在); } // 1. 防止重復(fù)選課 Long count studentCourseMapper.countByStudentAndCourse(studentId, courseId); if (count 0) { return Result.error(不能重復(fù)選擇同一門課程); } // 2. 容量校驗 原子更新防止超選 int updated courseMapper.increaseSelectedNum(courseId); if (updated 0) { return Result.error(課程已選滿); } // 3. 時間沖突校驗 ListCourse selectedCourses studentCourseMapper.findSelectedCourses(studentId); for (Course selected : selectedCourses) { if (isTimeConflict(course, selected)) { // 容量回滾因為后續(xù)不會真正插入選課記錄 courseMapper.decreaseSelectedNum(courseId); return Result.error(與課程[ selected.getCourseName() ]時間沖突); } } StudentCourse record new StudentCourse(); record.setStudentId(studentId); record.setCourseId(courseId); studentCourseMapper.insert(record); return Result.success(null); } private boolean isTimeConflict(Course newCourse, Course existCourse) { if (!newCourse.getDayOfWeek().equals(existCourse.getDayOfWeek())) { return false; } return newCourse.getStartSection() existCourse.getEndSection() existCourse.getStartSection() newCourse.getEndSection(); } }這里要特別注意事務(wù)邊界。上面示例使用TransactionTemplate手動控制事務(wù)避免多個操作之間出現(xiàn)問題。也可以直接在方法上使用Transactional(rollbackFor Exception.class)但這個方法的難點在于“時間沖突”屬于業(yè)務(wù)校驗失敗而不是拋出運行時異常如果直接用Transactional并且返回Result.error事務(wù)不會回滾已經(jīng)執(zhí)行成功的increaseSelectedNum就會把課程人數(shù)加錯。所以要在校驗失敗時執(zhí)行courseMapper.decreaseSelectedNum(courseId)或者把整段邏輯拆成兩次獨立事務(wù)。更穩(wěn)妥的寫法是使用TransactionTemplate把“扣減容量 插入選課記錄”放在同一個事務(wù)中任何一步拋異常都會回滾。CourseMapper中對應(yīng)的原子更新 SQLupdate idincreaseSelectedNum UPDATE course SET selected_num selected_num 1 WHERE id #{courseId} AND selected_num lt; capacity /updatedecreaseSelectedNum對應(yīng)update iddecreaseSelectedNum UPDATE course SET selected_num selected_num - 1 WHERE id #{courseId} /update這種方案的好處是數(shù)據(jù)庫通過selected_num capacity條件保證不會超選即使兩個學(xué)生同時執(zhí)行該 SQL也只有一個會更新成功。4.4 退課、選課名單和成績錄入退課邏輯相對簡單刪除選課記錄的同時把課程的selected_num減 1。Transactional(rollbackFor Exception.class) public void cancelCourse(Long studentId, Long courseId) { studentCourseMapper.deleteByStudentAndCourse(studentId, courseId); courseMapper.decreaseSelectedNum(courseId); }成績錄入由教師操作直接更新student_course表RestController RequestMapping(/api/teacher) public class TeacherController { Resource private StudentCourseService studentCourseService; GetMapping(/course/{courseId}/students) public Result listSelectedStudents(PathVariable Long courseId) { ListStudentCourseVO list studentCourseService.listByCourse(courseId); return Result.success(list); } PostMapping(/score) public Result saveScore(RequestBody ScoreRequest request) { studentCourseService.saveScore(request.getStudentCourseId(), request.getScore()); return Result.success(null); } }5. 前端頁面與聯(lián)調(diào)方式5.1 使用 Thymeleaf 快速完成后臺頁面如果不想做前后端分離可以用 Thymeleaf 直接渲染頁面。選課頁面的核心代碼可以這樣寫!DOCTYPE html html xmlns:thhttp://www.thymeleaf.org head meta charsetUTF-8 title選課/title /head body h1課程列表/h1 table border1 tr th課程名稱/th th教師/th th學(xué)分/th th容量/th th已選/th th上課時間/th th操作/th /tr tr th:eachcourse : ${page.records} td th:text${course.courseName}課程名/td td th:text${course.teacherName}教師/td td th:text${course.credit}學(xué)分/td td th:text${course.capacity}容量/td td th:text${course.selectedNum}已選/td td th:text${course.dayOfWeek 第 course.startSection - course.endSection 節(jié)}時間/td td form th:action{/api/student/course/select} methodpost input typehidden namecourseId th:value${course.id} button typesubmit選課/button /form /td /tr /table /body /htmlThymeleaf 的優(yōu)點是部署簡單、不需要跨域處理適合時間緊張的畢設(shè)項目。缺點是前后端耦合在一起遇到復(fù)雜交互時需要寫較多 JavaScript。5.2 使用 Vue 前后端分離時需要統(tǒng)一接口格式如果選擇 Vue 3 做前端后端接口應(yīng)該返回固定格式的 JSON方便前端統(tǒng)一處理?？梢远x一個Result類public class Result { private Integer code; private String message; private Object data; public static Result success(Object data) { Result r new Result(); r.code 200; r.message success; r.data data; return r; } public static Result error(String message) { Result r new Result(); r.code 500; r.message message; return r; } }前端使用 Axios 時只需要攔截code字段axios.post(/api/student/course/select, { courseId: id }) .then(res { if (res.data.code 200) { alert(選課成功); } else { alert(res.data.message); } });前后端分離項目的地址要提前約定好。本地開發(fā)時 Vue 一般運行在 5173 端口后端運行在 8080 端口需要在 Vue 的vite.config.js里配置代理export default { server: { proxy: { /api: { target: http://localhost:8080, changeOrigin: true } } } }這樣前端請求/api/xxx時會被代理轉(zhuǎn)發(fā)到后端不會出現(xiàn)跨域問題。5.3 頁面和接口的對應(yīng)關(guān)系頁面接口功能登錄頁POST /api/auth/login登錄學(xué)生選課頁GET /api/course/list查詢課程列表學(xué)生選課頁POST /api/student/course/select選課學(xué)生已選頁GET /api/student/course/selected查詢已選課程學(xué)生已選頁POST /api/student/course/cancel退課教師課程頁GET /api/teacher/course/{courseId}/students查詢選課名單教師成績頁POST /api/teacher/score錄入成績管理員用戶頁POST /api/admin/user/add新增用戶6. 啟動、驗證和打包發(fā)布6.1 啟動前檢查清單在運行項目之前按下面的順序逐項檢查能避免大多數(shù)環(huán)境問題檢查 MySQL 是否已經(jīng)啟動是否能通過mysql -u root -p登錄。檢查本機 JDK 版本java -version輸出是否和 Spring Boot 版本匹配。檢查 Maven 倉庫是否能正常下載依賴mvn -v命令是否可用。檢查application.yml中的數(shù)據(jù)庫密碼、用戶名是否正確。檢查 8080 端口是否被占用執(zhí)行netstat -ano | findstr 8080Windows或lsof -i:8080Linux/macOS。啟動成功后控制臺會出現(xiàn)類似下面的內(nèi)容Tomcat started on port(s): 8080 (http) Started CourseManagementApplication in 2.34 seconds6.2 用接口用例驗證核心功能啟動項目后建議用接口用例把核心鏈路驗證一遍。下面以選課流程為例給出關(guān)鍵接口調(diào)用。登錄接口curl -X POST http://localhost:8080/api/auth/login \ -H Content-Type: application/json \ -d {username:student01,password:123456}查詢課程列表curl -X GET http://localhost:8080/api/course/list?page1size10選課接口curl -X POST http://localhost:8080/api/student/course/select \ -H Content-Type: application/json \ -d {courseId:1}重復(fù)選課驗證curl -X POST http://localhost:8080/api/student/course/select \ -H Content-Type: application/json \ -d {courseId:1}第二次請求應(yīng)該返回“不能重復(fù)選擇同一門課程”。如果返回成功說明唯一索引或查詢邏輯沒有生效。還可以用以下表格整理驗證用例畢設(shè)測試報告中也可以直接引用驗證項操作預(yù)期結(jié)果登錄成功輸入正確賬號密碼返回用戶信息登錄失敗輸入錯誤密碼提示用戶名或密碼錯誤選課成功學(xué)生選擇未選課程選課記錄插入成功重復(fù)選課學(xué)生再次選擇同一課程提示不能重復(fù)選擇超容量選課已選人數(shù)等于容量時繼續(xù)選課提示課程已選滿時間沖突選課選擇同一天同一節(jié)次的課程提示時間沖突退課成功學(xué)生退掉已選課程記錄刪除且人數(shù)減一成績錄入教師錄入成績學(xué)生可查詢到成績6.3 Maven 打包和部署驗證完成之后使用 Maven 打包mvn clean package -DskipTests打包完成后在target目錄下生成course-management-system-0.0.1-SNAPSHOT.jar使用命令啟動java -jar target/course-management-system-0.0.1-SNAPSHOT.jar6.4 學(xué)習(xí)環(huán)境與生產(chǎn)環(huán)境的關(guān)鍵差異畢設(shè)演示環(huán)境可以簡化很多配置但如果是實際高校內(nèi)部使用還需要補齊以下內(nèi)容項目學(xué)習(xí)環(huán)境生產(chǎn)環(huán)境數(shù)據(jù)庫密碼寫死可以接受使用環(huán)境變量或配置中心日志控制臺輸出文件輸出 按天切割 日志監(jiān)控上傳圖片本地目錄對象存儲或獨立文件服務(wù)并發(fā)搶課單機測試需要緩存、隊列、限流數(shù)據(jù)備份不涉及定期備份數(shù)據(jù)庫主從前端部署本地運行Nginx 靜態(tài)資源部署7. 畢設(shè)項目常見問題排查路徑7.1 項目啟動失敗現(xiàn)象SpringApplication啟動時報錯程序直接退出。問題現(xiàn)象常見原因檢查方式處理建議Port 8080 was already in use端口被占用查看啟動日志中的Port already in use換端口或在application.yml中修改server.portUnsupportedClassVersionErrorJDK 版本和 Spring Boot 版本不匹配用java -version檢查版本Spring Boot 2.x 配 JDK 8Spring Boot 3.x 配 JDK 17You arent using a compiler supported by lombokLombok 版本和 JDK 版本不兼容檢查編譯日志升級 Lombok 為最新穩(wěn)定版或者更換 JDK 版本7.2 數(shù)據(jù)庫連接失敗現(xiàn)象項目能啟動但訪問任意接口時報數(shù)據(jù)庫異常。問題現(xiàn)象常見原因檢查方式處理建議Access denied for user rootlocalhost數(shù)據(jù)庫密碼錯誤用命令行登錄 MySQL 驗證修改application.yml中的密碼Server returns invalid timezone未指定時區(qū)查看異常里的時區(qū)提示在 JDBC URL 增加serverTimezoneAsia/ShanghaiPublic Key Retrieval is not allowedMySQL 8.0 的認(rèn)證方式問題檢查連接 URL在 JDBC URL 后增加allowPublicKeyRetrievaltrueuseSSLfalse7.3 選課業(yè)務(wù)邏輯問題選課是業(yè)務(wù)核心最容易出問題的點包括數(shù)據(jù)重復(fù)、容量錯誤和時間判斷不準(zhǔn)確。問題現(xiàn)象常見原因檢查方式處理建議重復(fù)選課成功只做了代碼查詢沒有唯一索引直接執(zhí)行 SQL 插入重復(fù)記錄給student_course表加唯一索引選課人數(shù)超過容量先查詢再更新沒有用條件更新查看數(shù)據(jù)庫的selected_num和capacity改成UPDATE ... WHERE selected_num capacity時間沖突判斷不準(zhǔn)直接用字符串比較時間段打印兩門課的時間字段將星期、節(jié)次拆分為數(shù)字類型再比較區(qū)間交集選課失敗后人數(shù)仍增加業(yè)務(wù)校驗失敗沒有回滾查看selected_num是否比實際多失敗時執(zhí)行人數(shù)遞減或使用TransactionTemplate包裹7.4 前端頁面和靜態(tài)資源問題現(xiàn)象瀏覽器訪問頁面時出現(xiàn)Whitelabel Error Page或靜態(tài)資源加載不出來。問題現(xiàn)象常見原因檢查方式處理建議出現(xiàn) Whitelabel Error Page控制器返回了沒有匹配的視圖查看控制臺 404 日志檢查RestController和Controller是否用混修改 HTML 不生效Thymeleaf 緩存開啟刷新頁面仍是舊內(nèi)容在配置中設(shè)置spring.thymeleaf.cachefalse靜態(tài)資源 404靜態(tài)資源路徑錯誤檢查瀏覽器請求 URL靜態(tài)文件放在src/main/resources/static7.5 排查鏈路建議遇到問題不要盲目改代碼按下面的順序排查更高效看控制臺完整日志找到第一處Caused by后面的堆棧通常是跟隨異常。判斷是編譯期問題還是運行期問題。編譯期問題先看 Maven 依賴和 JDK 版本。運行期問題先看數(shù)據(jù)庫是否能連通再看 SQL 是否正確。使用 MyBatis 日志輸出 SQL把 SQL 復(fù)制到數(shù)據(jù)庫客戶端里執(zhí)行確認(rèn)數(shù)據(jù)狀態(tài)。業(yè)務(wù)邏輯問題優(yōu)先在 Service 層加日志輸出入?yún)?、查詢結(jié)果和每一步的校驗結(jié)果。8. 答辯準(zhǔn)備與項目擴展方向8.1 答辯中高頻問題及應(yīng)答思路答辯功能演示只是一部分評委更關(guān)心的是你有沒有理解系統(tǒng)的設(shè)計。提前準(zhǔn)備下面幾個問題會比臨場發(fā)揮更從容。問題一系統(tǒng)如何防止學(xué)生重復(fù)選課回答思路兩層校驗。業(yè)務(wù)層先查詢student_course表是否已有記錄如果已有就返回錯誤。數(shù)據(jù)庫層通過uk_student_course唯一索引兜底即使并發(fā)請求同時到達也會因為唯一約束而只插入一條記錄。問題二課程容量滿了怎么辦回答思路容量字段是capacity當(dāng)前已選人數(shù)是selected_num。選課操作執(zhí)行UPDATE course SET selected_num selected_num 1 WHERE id ? AND selected_num capacity數(shù)據(jù)庫返回更新行數(shù)為 0 時表示課程已滿選課失敗。這種條件更新能避免先查詢再更新帶來的超選問題。問題三為什么不用 Spring Security回答思路本系統(tǒng)角色只有三種權(quán)限規(guī)則比較簡單用攔截器可以滿足需求且代碼更少。如果需要實現(xiàn)細(xì)粒度權(quán)限、OAuth2 登錄、動態(tài)菜單可以在此基礎(chǔ)上引入 Spring Security當(dāng)前攔截器方案不影響后續(xù)擴展。問題四如何判斷兩門課時間沖突回答思路課程表保存了星期幾和節(jié)次區(qū)間。選課時查詢學(xué)生所有已選課程對每門已選課程判斷星期是否相同如果相同再判斷節(jié)次區(qū)間是否有交集即新課程的start_section 已選課程的 end_section且 已選課程的start_section 新課程的 end_section。問題五數(shù)據(jù)庫為什么冗余selected_num字段回答思路如果不冗余查詢選課人數(shù)需要每次統(tǒng)計student_course表課程列表頁會反復(fù)執(zhí)行聚合查詢。冗余字段把“已選人數(shù)”變成課程表的普通字段選課時通過單條 UPDATE 完成校驗和更新性能更好。代價是需要保證刪除選課記錄時同步扣減人數(shù)。8.2 可擴展方向如果做完基礎(chǔ)功能還想加深項目難度可以從下面幾個方向選一個擴展方向難度說明Redis 緩存課程列表中等減少數(shù)據(jù)庫查詢壓力答辯時可以講緩存一致性RabbitMQ 異步處理選課請求較高緩解搶課瞬時壓力引入消息隊列削峰定時任務(wù)自動釋放未交費名額中等使用 Spring 的Scheduled定時掃描Vue 3 前端重構(gòu)中等展示前后端分離能力JWT 無狀態(tài)登錄中等替代 Session適合前后端分離Flowable 工作流審批較高用于退課審批、加選審批等流程新增擴展功能時要注意保持原有接口兼容。后端接口全部返回統(tǒng)一Result前端新增頁面時只需要調(diào)用對應(yīng)接口即可不需要重構(gòu)已有模塊。8.3 代碼、文檔和講解如何配套畢設(shè)項目不只是能跑就行代碼、文檔和講解要能互相呼應(yīng)。代碼要做到小步提交注釋寫清楚關(guān)鍵方法。比如選課方法中的容量校驗、時間沖突判斷每段邏輯都要寫注釋因為答辯時很可能直接講這個方法。文檔報告建議包含需求分析、數(shù)據(jù)庫設(shè)計、接口說明、測試用例、部署說明五個部分。數(shù)據(jù)庫設(shè)計直接復(fù)制建表 SQL 和字段說明表接口說明把Result返回格式和核心接口列出來。測試用例可以使用本文第 6.2 節(jié)的用例表。代碼講解時不要從頭到尾逐行念代碼?？梢园础坝脩舻卿?- 學(xué)生選課 - 教師錄成績”三條業(yè)務(wù)鏈路講每條鏈路講清 Controller、Service、Mapper 三個層次的調(diào)用關(guān)系。選課鏈路講到容量校驗和時間沖突時停下來重點解釋為什么使用條件更新和唯一索引這部分是整個項目的技術(shù)亮點。完成這些工作后這套選課管理系統(tǒng)不僅能通過答辯也能作為后續(xù)學(xué)習(xí)微服務(wù)、消息隊列、安全框架的起步項目。做項目的價值在于理解約束如何從業(yè)務(wù)轉(zhuǎn)化到代碼再落到數(shù)據(jù)庫這個過程培養(yǎng)的工程意識比功能齊全更值得體現(xiàn)。