畢業(yè)設(shè)計(jì)里基于SpringBoot的學(xué)生選課管理系統(tǒng)是一個(gè)出現(xiàn)頻率很高的選題。它看起來只是管理課程和學(xué)生選課實(shí)際上要處理角色權(quán)限、課程資源約束、選課沖突、成績回填等多個(gè)環(huán)節(jié)做完之后幾乎可以把 JavaWeb 階段的知識點(diǎn)全部串起來。這篇博客按照一個(gè)完整畢設(shè)項(xiàng)目的推進(jìn)順序展開從業(yè)務(wù)拆分、表結(jié)構(gòu)設(shè)計(jì)、后端接口實(shí)現(xiàn)、前端頁面聯(lián)調(diào)到打包部署和常見故障排查全部走一遍。無論你是準(zhǔn)備用這個(gè)題目寫畢設(shè)還是想復(fù)現(xiàn)一個(gè) SpringBoot 管理系統(tǒng)加深理解都可以按文章步驟跑出一套可演示、可答辯、可擴(kuò)展的系統(tǒng)。1. 先理解學(xué)生選課管理系統(tǒng)要解決什么問題1.1 高校選課的核心業(yè)務(wù)流程選課管理系統(tǒng)并不是一個(gè)單純的“課程增刪改查”項(xiàng)目。它的核心業(yè)務(wù)是在一個(gè)學(xué)期內(nèi)學(xué)生從開設(shè)的課程列表中選擇自己要修的課程系統(tǒng)要保證這門課沒有選滿、學(xué)生沒有重復(fù)選擇、課程時(shí)間沒有和其他已選課程沖突。選課結(jié)束后教師還需要看到選課名單錄入成績學(xué)生才能查到最終成績。這個(gè)流程涉及三類角色角色主要功能學(xué)生瀏覽課程、選課、退課、查看已選課程、查看成績教師維護(hù)課程信息、查看選課名單、錄入成績管理員管理學(xué)生賬號、教師賬號、課程信息、開課學(xué)期很多畢設(shè)項(xiàng)目會(huì)把管理員功能做得很大比如部門管理、菜單管理、操作日志統(tǒng)計(jì)等。作為畢設(shè)系統(tǒng)這些功能可以做但真正決定項(xiàng)目質(zhì)量的是“選課約束”是否嚴(yán)謹(jǐn)。也就是說學(xué)生選課時(shí)系統(tǒng)能不能真的防止重復(fù)選、超容量選、同一時(shí)間沖突選而不是只在頁面上提示一個(gè)空泛的錯(cuò)誤。1.2 四個(gè)不能回避的業(yè)務(wù)邊界實(shí)際做這個(gè)系統(tǒng)時(shí)會(huì)反復(fù)遇到這幾個(gè)邊界條件它們是后端代碼設(shè)計(jì)的主線。第一一個(gè)學(xué)期內(nèi)只能操作當(dāng)前學(xué)期的課程。課程必須帶有學(xué)期字段學(xué)生選課記錄也要綁定學(xué)期否則上一屆的歷史數(shù)據(jù)會(huì)混進(jìn)來。第二選課前必須校驗(yàn)是否已經(jīng)選過同一門課。這里的判斷不能只靠代碼里的集合判斷還要靠數(shù)據(jù)庫唯一索引兜底防止并發(fā)請求同時(shí)寫入。第三選課時(shí)必須判斷課程容量。課程有容量上限已選人數(shù)不能超過容量。比如課程容量是 60第 61 個(gè)學(xué)生再來選課時(shí)必須被拒絕。第四同一天同一時(shí)間段不能安排兩門課。判斷時(shí)間沖突需要拿到學(xué)生所有已選課程再和當(dāng)前課程的時(shí)間段做交叉比對。這四條如果全部落地項(xiàng)目就已經(jīng)超過很多只做增刪改查的畢設(shè)。答辯時(shí)被問到“系統(tǒng)怎么保證選課數(shù)據(jù)正確”可以直接從這四個(gè)約束入手展開。1.3 為什么選 Spring Boot 作為畢設(shè)基礎(chǔ)框架選課管理系統(tǒng)的功能集中在業(yè)務(wù)邏輯和數(shù)據(jù)操作適合用 Spring Boot 這種“約定優(yōu)先于配置”的框架快速搭建。Spring Boot 自帶內(nèi)嵌的 Tomcat寫完代碼后一個(gè)java -jar就能啟動(dòng)不需要單獨(dú)安裝和配置外部服務(wù)器這對計(jì)算機(jī)設(shè)計(jì)演示很有幫助。Spring Boot 的自動(dòng)配置機(jī)制能減少大量 XML 配置數(shù)據(jù)庫連接、事務(wù)管理、Web 請求處理都可以在application.yml里集中維護(hù)。更重要的是 Spring Boot 與 MyBatis、MyBatis-Plus、Thymeleaf、Vue 等常見技術(shù)的配合非常成熟。遇到問題搜索時(shí)可以找到大量資料適合第一次完整做項(xiàng)目的學(xué)生閱讀和排查。選課管理系統(tǒng)的數(shù)據(jù)量不大、業(yè)務(wù)鏈路清晰不需要微服務(wù)和高性能并發(fā)方案Spring Boot 單體架構(gòu)已經(jīng)足夠。2. 環(huán)境準(zhǔn)備與技術(shù)棧選型2.1 版本約定要一致否則后面全是坑版本選擇是畢設(shè)項(xiàng)目最容易被忽略的地方。很多同學(xué)把別人的源碼拉到本地一啟動(dòng)就報(bào)各種錯(cuò)誤原因往往是本機(jī) JDK 版本和項(xiàng)目的 Spring Boot 版本不匹配。下面是一套比較穩(wěn)妥的版本組合本次示例代碼也按這個(gè)組合設(shè)計(jì)組件推薦版本說明JDK8 或 17Spring Boot 2.7.x 用 JDK 8Spring Boot 3.x 用 JDK 17Maven3.6用于依賴管理和打包Spring Boot2.7.x兼容性強(qiáng)資料最多適合畢設(shè)MySQL8.08.0 需要關(guān)注時(shí)區(qū)配置MyBatis-Plus3.5.x減少基礎(chǔ) SQL 編寫降低工作量前端方案Thymeleaf 或 Vue 3快速完成選 Thymeleaf想展示前后端分離選 Vue注意如果本機(jī)已經(jīng)安裝了 JDK 17建議直接選擇 Spring Boot 3.x。反過來如果本機(jī)是 JDK 8卻使用了 Spring Boot 3.x編譯時(shí)會(huì)出現(xiàn)UnsupportedClassVersionError因?yàn)?Spring Boot 3.x 的最低要求是 Java 17。開始編碼之前先使用java -version和mvn -v確認(rèn)本機(jī)環(huán)境。2.2 Maven 工程結(jié)構(gòu)規(guī)劃推薦按下面這種結(jié)構(gòu)組織代碼分層清晰答辯時(shí)也容易講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組織實(shí)體類放在entity包接口返回?cái)?shù)據(jù)封裝在vo包。這樣每個(gè)類的職責(zé)具體答辯時(shí)可以直接說清楚每一層的作用。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)注點(diǎn)集中在選課規(guī)則上。如果希望練習(xí)手寫 SQL也可以把依賴換成mybatis-spring-boot-starter兩種方式對畢設(shè)都夠用。2.4 配置文件注意時(shí)區(qū)和駝峰映射application.yml是項(xiàng)目能否連接數(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 的時(shí)區(qū)報(bào)錯(cuò)。map-underscore-to-camel-case: true讓數(shù)據(jù)庫的student_id字段自動(dòng)映射到實(shí)體的studentId屬性避免每次手寫繁瑣的 resultMap。log-impl會(huì)把執(zhí)行的 SQL 打印到控制臺選課邏輯出錯(cuò)時(shí)可以直接看到 SQL 語句這在調(diào)試階段非常有用。3. 數(shù)據(jù)庫設(shè)計(jì)要支撐業(yè)務(wù)約束3.1 核心表結(jié)構(gòu)總覽選課管理系統(tǒng)的數(shù)據(jù)庫至少包含三張核心表。用戶表保存學(xué)生、教師、管理員賬號課程表保存課程的容量、時(shí)間、學(xué)分等基本信息選課記錄表保存學(xué)生和課程之間的綁定關(guān)系以及成績。表名用途user用戶基本信息區(qū)分角色course課程基本信息、容量、時(shí)間、學(xué)期student_course學(xué)生選課記錄、成績?nèi)绻枰暾啬M高校場景可以增加student表、teacher表和semester表。畢設(shè)階段為了控制復(fù)雜度可以先合并為上面的三表結(jié)構(gòu)答辯時(shí)再說明擴(kuò)展思路。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è)計(jì)里的三個(gè)關(guān)鍵決策第一個(gè)關(guān)鍵決策是選課記錄表必須加唯一索引。只靠 Service 層代碼判斷“是否已選”在單用戶操作時(shí)有效但兩個(gè)學(xué)生同時(shí)請求或者同一個(gè)學(xué)生快速點(diǎn)擊兩次選課按鈕時(shí)代碼判斷可能同時(shí)通過唯一索引uk_student_course會(huì)在數(shù)據(jù)庫層攔住重復(fù)數(shù)據(jù)。這是選課系統(tǒng)防止臟數(shù)據(jù)最重要的兜底手段。第二個(gè)關(guān)鍵決策是課程表設(shè)計(jì)了selected_num冗余字段。它保存當(dāng)前已選人數(shù)目的是在選課操作時(shí)執(zhí)行UPDATE course SET selected_num selected_num 1 WHERE id ? AND selected_num capacity這種原子更新而不是先查人數(shù)再更新人數(shù)。這樣即使并發(fā)選課數(shù)據(jù)庫也能通過行鎖保證不會(huì)超過容量。第三個(gè)關(guān)鍵決策是時(shí)間字段拆分成day_of_week、start_section、end_section而不是直接存一個(gè)字符串。拆分之后判斷兩門課是否沖突的邏輯更容易實(shí)現(xiàn)。比如課程 A 是周一 1-2 節(jié)課程 B 是周一 2-3 節(jié)兩條記錄可以按“星期相同且節(jié)次區(qū)間有交集”來判斷沖突。4. 后端核心實(shí)現(xiàn)把約束寫進(jìn)代碼4.1 登錄認(rèn)證和角色權(quán)限攔截先實(shí)現(xiàn)一個(gè)簡單的登錄接口。登錄成功后把用戶信息放進(jìn) Session后續(xù)請求通過攔截器校驗(yàn)。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(用戶名或密碼錯(cuò)誤); } session.setAttribute(loginUser, user); return Result.success(user); } PostMapping(/logout) public Result logout(HttpSession session) { session.invalidate(); return Result.success(null); } }攔截器用來統(tǒng)一校驗(yàn)是否登錄以及訪問路徑是否匹配角色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è)項(xiàng)目的代碼講解。如果評委問為什么不直接用 Spring Security可以回答當(dāng)前系統(tǒng)角色只有三種業(yè)務(wù)重點(diǎn)是選課約束使用攔截器可以把復(fù)雜度控制在合理范圍后續(xù)需要細(xì)粒度權(quán)限時(shí)再引入安全框架。4.2 課程管理接口課程管理主要包含分頁查詢課程、新增課程、修改課程信息。學(xué)生端只能查詢教師端可以維護(hù)課程。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ù)、不超選、不沖突選課是整個(gè)系統(tǒng)技術(shù)含量最高的地方。先定義一個(gè)選課表單對象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. 容量校驗(yàn) 原子更新防止超選 int updated courseMapper.increaseSelectedNum(courseId); if (updated 0) { return Result.error(課程已選滿); } // 3. 時(shí)間沖突校驗(yàn) ListCourse selectedCourses studentCourseMapper.findSelectedCourses(studentId); for (Course selected : selectedCourses) { if (isTimeConflict(course, selected)) { // 容量回滾因?yàn)楹罄m(xù)不會(huì)真正插入選課記錄 courseMapper.decreaseSelectedNum(courseId); return Result.error(與課程[ selected.getCourseName() ]時(shí)間沖突); } } 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手動(dòng)控制事務(wù)避免多個(gè)操作之間出現(xiàn)問題。也可以直接在方法上使用Transactional(rollbackFor Exception.class)但這個(gè)方法的難點(diǎn)在于“時(shí)間沖突”屬于業(yè)務(wù)校驗(yàn)失敗而不是拋出運(yùn)行時(shí)異常如果直接用Transactional并且返回Result.error事務(wù)不會(huì)回滾已經(jīng)執(zhí)行成功的increaseSelectedNum就會(huì)把課程人數(shù)加錯(cuò)。所以要在校驗(yàn)失敗時(shí)執(zhí)行courseMapper.decreaseSelectedNum(courseId)或者把整段邏輯拆成兩次獨(dú)立事務(wù)。更穩(wěn)妥的寫法是使用TransactionTemplate把“扣減容量 插入選課記錄”放在同一個(gè)事務(wù)中任何一步拋異常都會(huì)回滾。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條件保證不會(huì)超選即使兩個(gè)學(xué)生同時(shí)執(zhí)行該 SQL也只有一個(gè)會(huì)更新成功。4.4 退課、選課名單和成績錄入退課邏輯相對簡單刪除選課記錄的同時(shí)把課程的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上課時(shí)間/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é)}時(shí)間/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)點(diǎn)是部署簡單、不需要跨域處理適合時(shí)間緊張的畢設(shè)項(xiàng)目。缺點(diǎn)是前后端耦合在一起遇到復(fù)雜交互時(shí)需要寫較多 JavaScript。5.2 使用 Vue 前后端分離時(shí)需要統(tǒng)一接口格式如果選擇 Vue 3 做前端后端接口應(yīng)該返回固定格式的 JSON方便前端統(tǒng)一處理?？梢远x一個(gè)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 時(shí)只需要攔截code字段axios.post(/api/student/course/select, { courseId: id }) .then(res { if (res.data.code 200) { alert(選課成功); } else { alert(res.data.message); } });前后端分離項(xiàng)目的地址要提前約定好。本地開發(fā)時(shí) Vue 一般運(yùn)行在 5173 端口后端運(yùn)行在 8080 端口需要在 Vue 的vite.config.js里配置代理export default { server: { proxy: { /api: { target: http://localhost:8080, changeOrigin: true } } } }這樣前端請求/api/xxx時(shí)會(huì)被代理轉(zhuǎn)發(fā)到后端不會(huì)出現(xiàn)跨域問題。5.3 頁面和接口的對應(yīng)關(guān)系頁面接口功能登錄頁P(yáng)OST /api/auth/login登錄學(xué)生選課頁GET /api/course/list查詢課程列表學(xué)生選課頁P(yáng)OST /api/student/course/select選課學(xué)生已選頁GET /api/student/course/selected查詢已選課程學(xué)生已選頁P(yáng)OST /api/student/course/cancel退課教師課程頁GET /api/teacher/course/{courseId}/students查詢選課名單教師成績頁P(yáng)OST /api/teacher/score錄入成績管理員用戶頁P(yáng)OST /api/admin/user/add新增用戶6. 啟動(dòng)、驗(yàn)證和打包發(fā)布6.1 啟動(dòng)前檢查清單在運(yùn)行項(xiàng)目之前按下面的順序逐項(xiàng)檢查能避免大多數(shù)環(huán)境問題檢查 MySQL 是否已經(jīng)啟動(dòng)是否能通過mysql -u root -p登錄。檢查本機(jī) JDK 版本java -version輸出是否和 Spring Boot 版本匹配。檢查 Maven 倉庫是否能正常下載依賴mvn -v命令是否可用。檢查application.yml中的數(shù)據(jù)庫密碼、用戶名是否正確。檢查 8080 端口是否被占用執(zhí)行netstat -ano | findstr 8080Windows或lsof -i:8080Linux/macOS。啟動(dòng)成功后控制臺會(huì)出現(xiàn)類似下面的內(nèi)容Tomcat started on port(s): 8080 (http) Started CourseManagementApplication in 2.34 seconds6.2 用接口用例驗(yàn)證核心功能啟動(dòng)項(xiàng)目后建議用接口用例把核心鏈路驗(yàn)證一遍。下面以選課流程為例給出關(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ù)選課驗(yàn)證curl -X POST http://localhost:8080/api/student/course/select \ -H Content-Type: application/json \ -d {courseId:1}第二次請求應(yīng)該返回“不能重復(fù)選擇同一門課程”。如果返回成功說明唯一索引或查詢邏輯沒有生效。還可以用以下表格整理驗(yàn)證用例畢設(shè)測試報(bào)告中也可以直接引用驗(yàn)證項(xiàng)操作預(yù)期結(jié)果登錄成功輸入正確賬號密碼返回用戶信息登錄失敗輸入錯(cuò)誤密碼提示用戶名或密碼錯(cuò)誤選課成功學(xué)生選擇未選課程選課記錄插入成功重復(fù)選課學(xué)生再次選擇同一課程提示不能重復(fù)選擇超容量選課已選人數(shù)等于容量時(shí)繼續(xù)選課提示課程已選滿時(shí)間沖突選課選擇同一天同一節(jié)次的課程提示時(shí)間沖突退課成功學(xué)生退掉已選課程記錄刪除且人數(shù)減一成績錄入教師錄入成績學(xué)生可查詢到成績6.3 Maven 打包和部署驗(yàn)證完成之后使用 Maven 打包mvn clean package -DskipTests打包完成后在target目錄下生成course-management-system-0.0.1-SNAPSHOT.jar使用命令啟動(dòng)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)境可以簡化很多配置但如果是實(shí)際高校內(nèi)部使用還需要補(bǔ)齊以下內(nèi)容項(xiàng)目學(xué)習(xí)環(huán)境生產(chǎn)環(huán)境數(shù)據(jù)庫密碼寫死可以接受使用環(huán)境變量或配置中心日志控制臺輸出文件輸出 按天切割 日志監(jiān)控上傳圖片本地目錄對象存儲或獨(dú)立文件服務(wù)并發(fā)搶課單機(jī)測試需要緩存、隊(duì)列、限流數(shù)據(jù)備份不涉及定期備份數(shù)據(jù)庫主從前端部署本地運(yùn)行Nginx 靜態(tài)資源部署7. 畢設(shè)項(xiàng)目常見問題排查路徑7.1 項(xiàng)目啟動(dòng)失敗現(xiàn)象SpringApplication啟動(dòng)時(shí)報(bào)錯(cuò)程序直接退出。問題現(xiàn)象常見原因檢查方式處理建議Port 8080 was already in use端口被占用查看啟動(dòng)日志中的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)象項(xiàng)目能啟動(dòng)但訪問任意接口時(shí)報(bào)數(shù)據(jù)庫異常。問題現(xiàn)象常見原因檢查方式處理建議Access denied for user rootlocalhost數(shù)據(jù)庫密碼錯(cuò)誤用命令行登錄 MySQL 驗(yàn)證修改application.yml中的密碼Server returns invalid timezone未指定時(shí)區(qū)查看異常里的時(shí)區(qū)提示在 JDBC URL 增加serverTimezoneAsia/ShanghaiPublic Key Retrieval is not allowedMySQL 8.0 的認(rèn)證方式問題檢查連接 URL在 JDBC URL 后增加allowPublicKeyRetrievaltrueuseSSLfalse7.3 選課業(yè)務(wù)邏輯問題選課是業(yè)務(wù)核心最容易出問題的點(diǎn)包括數(shù)據(jù)重復(fù)、容量錯(cuò)誤和時(shí)間判斷不準(zhǔn)確。問題現(xiàn)象常見原因檢查方式處理建議重復(fù)選課成功只做了代碼查詢沒有唯一索引直接執(zhí)行 SQL 插入重復(fù)記錄給student_course表加唯一索引選課人數(shù)超過容量先查詢再更新沒有用條件更新查看數(shù)據(jù)庫的selected_num和capacity改成UPDATE ... WHERE selected_num capacity時(shí)間沖突判斷不準(zhǔn)直接用字符串比較時(shí)間段打印兩門課的時(shí)間字段將星期、節(jié)次拆分為數(shù)字類型再比較區(qū)間交集選課失敗后人數(shù)仍增加業(yè)務(wù)校驗(yàn)失敗沒有回滾查看selected_num是否比實(shí)際多失敗時(shí)執(zhí)行人數(shù)遞減或使用TransactionTemplate包裹7.4 前端頁面和靜態(tài)資源問題現(xiàn)象瀏覽器訪問頁面時(shí)出現(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)資源路徑錯(cuò)誤檢查瀏覽器請求 URL靜態(tài)文件放在src/main/resources/static7.5 排查鏈路建議遇到問題不要盲目改代碼按下面的順序排查更高效看控制臺完整日志找到第一處Caused by后面的堆棧通常是跟隨異常。判斷是編譯期問題還是運(yùn)行期問題。編譯期問題先看 Maven 依賴和 JDK 版本。運(yùn)行期問題先看數(shù)據(jù)庫是否能連通再看 SQL 是否正確。使用 MyBatis 日志輸出 SQL把 SQL 復(fù)制到數(shù)據(jù)庫客戶端里執(zhí)行確認(rèn)數(shù)據(jù)狀態(tài)。業(yè)務(wù)邏輯問題優(yōu)先在 Service 層加日志輸出入?yún)?、查詢結(jié)果和每一步的校驗(yàn)結(jié)果。8. 答辯準(zhǔn)備與項(xiàng)目擴(kuò)展方向8.1 答辯中高頻問題及應(yīng)答思路答辯功能演示只是一部分評委更關(guān)心的是你有沒有理解系統(tǒng)的設(shè)計(jì)。提前準(zhǔn)備下面幾個(gè)問題會(huì)比臨場發(fā)揮更從容。問題一系統(tǒng)如何防止學(xué)生重復(fù)選課回答思路兩層校驗(yàn)。業(yè)務(wù)層先查詢student_course表是否已有記錄如果已有就返回錯(cuò)誤。數(shù)據(jù)庫層通過uk_student_course唯一索引兜底即使并發(fā)請求同時(shí)到達(dá)也會(huì)因?yàn)槲ㄒ患s束而只插入一條記錄。問題二課程容量滿了怎么辦回答思路容量字段是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 時(shí)表示課程已滿選課失敗。這種條件更新能避免先查詢再更新帶來的超選問題。問題三為什么不用 Spring Security回答思路本系統(tǒng)角色只有三種權(quán)限規(guī)則比較簡單用攔截器可以滿足需求且代碼更少。如果需要實(shí)現(xiàn)細(xì)粒度權(quán)限、OAuth2 登錄、動(dòng)態(tài)菜單可以在此基礎(chǔ)上引入 Spring Security當(dāng)前攔截器方案不影響后續(xù)擴(kuò)展。問題四如何判斷兩門課時(shí)間沖突回答思路課程表保存了星期幾和節(jié)次區(qū)間。選課時(shí)查詢學(xué)生所有已選課程對每門已選課程判斷星期是否相同如果相同再判斷節(jié)次區(qū)間是否有交集即新課程的start_section 已選課程的 end_section且 已選課程的start_section 新課程的 end_section。問題五數(shù)據(jù)庫為什么冗余selected_num字段回答思路如果不冗余查詢選課人數(shù)需要每次統(tǒng)計(jì)student_course表課程列表頁會(huì)反復(fù)執(zhí)行聚合查詢。冗余字段把“已選人數(shù)”變成課程表的普通字段選課時(shí)通過單條 UPDATE 完成校驗(yàn)和更新性能更好。代價(jià)是需要保證刪除選課記錄時(shí)同步扣減人數(shù)。8.2 可擴(kuò)展方向如果做完基礎(chǔ)功能還想加深項(xiàng)目難度可以從下面幾個(gè)方向選一個(gè)擴(kuò)展方向難度說明Redis 緩存課程列表中等減少數(shù)據(jù)庫查詢壓力答辯時(shí)可以講緩存一致性RabbitMQ 異步處理選課請求較高緩解搶課瞬時(shí)壓力引入消息隊(duì)列削峰定時(shí)任務(wù)自動(dòng)釋放未交費(fèi)名額中等使用 Spring 的Scheduled定時(shí)掃描Vue 3 前端重構(gòu)中等展示前后端分離能力JWT 無狀態(tài)登錄中等替代 Session適合前后端分離Flowable 工作流審批較高用于退課審批、加選審批等流程新增擴(kuò)展功能時(shí)要注意保持原有接口兼容。后端接口全部返回統(tǒng)一Result前端新增頁面時(shí)只需要調(diào)用對應(yīng)接口即可不需要重構(gòu)已有模塊。8.3 代碼、文檔和講解如何配套畢設(shè)項(xiàng)目不只是能跑就行代碼、文檔和講解要能互相呼應(yīng)。代碼要做到小步提交注釋寫清楚關(guān)鍵方法。比如選課方法中的容量校驗(yàn)、時(shí)間沖突判斷每段邏輯都要寫注釋因?yàn)榇疝q時(shí)很可能直接講這個(gè)方法。文檔報(bào)告建議包含需求分析、數(shù)據(jù)庫設(shè)計(jì)、接口說明、測試用例、部署說明五個(gè)部分。數(shù)據(jù)庫設(shè)計(jì)直接復(fù)制建表 SQL 和字段說明表接口說明把Result返回格式和核心接口列出來。測試用例可以使用本文第 6.2 節(jié)的用例表。代碼講解時(shí)不要從頭到尾逐行念代碼?？梢园础坝脩舻卿?- 學(xué)生選課 - 教師錄成績”三條業(yè)務(wù)鏈路講每條鏈路講清 Controller、Service、Mapper 三個(gè)層次的調(diào)用關(guān)系。選課鏈路講到容量校驗(yàn)和時(shí)間沖突時(shí)停下來重點(diǎn)解釋為什么使用條件更新和唯一索引這部分是整個(gè)項(xiàng)目的技術(shù)亮點(diǎn)。完成這些工作后這套選課管理系統(tǒng)不僅能通過答辯也能作為后續(xù)學(xué)習(xí)微服務(wù)、消息隊(duì)列、安全框架的起步項(xiàng)目。做項(xiàng)目的價(jià)值在于理解約束如何從業(yè)務(wù)轉(zhuǎn)化到代碼再落到數(shù)據(jù)庫這個(gè)過程培養(yǎng)的工程意識比功能齊全更值得體現(xiàn)。