1. 项目概述与背景教务管理系统作为高校信息化建设的核心组成部分其重要性不言而喻。我最近完成了一个基于Vue3前端SpringBoot后端的全栈式教务管理系统开发这个项目从需求分析到最终部署上线历时三个月期间踩过不少坑也积累了不少实战经验。不同于传统的JSP/Thymeleaf方案我们采用前后端分离架构后端使用SpringBoot 2.7提供RESTful API前端则基于Vue3Element Plus构建响应式界面数据库选用MySQL 8.0作为持久层存储。这个系统主要解决三大核心问题多角色协同管理管理员、教师、学生教务全流程数字化从选课到成绩管理高并发场景下的系统稳定性系统上线后实测在500并发用户情况下平均响应时间保持在800ms以内较学校原有系统性能提升近3倍。下面我将从技术选型、架构设计到具体实现详细拆解这个项目的开发全过程。2. 技术栈选型解析2.1 后端技术栈选择SpringBoot作为后端框架主要基于以下几点考量快速启动通过starter依赖可快速集成MyBatis、Redis等组件内嵌容器无需额外配置Tomcat通过spring-boot-starter-web即可运行生态丰富Spring Security用于权限控制Spring Cache实现缓存抽象具体版本选择parent groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-parent/artifactId version2.7.5/version /parent数据库选型对比了MySQL和PostgreSQL最终选择MySQL 8.0的原因学校IT部门现有运维体系对MySQL支持更完善JSON字段支持满足课程信息的灵活存储需求窗口函数等特性足以应对复杂统计查询2.2 前端技术栈Vue3组合式API相比Options API更适合教务系统的开发逻辑复用将选课逻辑、成绩计算等封装成composable函数TypeScript支持完善的类型定义减少运行时错误性能优化静态提升和补丁标志使更新更高效典型组件结构示例// 选课组件 script setup const { courses, selected } useCourseSelection() const { submit } useCourseAPI() /script template el-table :datacourses el-table-column propname label课程名称/ el-table-column template #default{row} el-button clickselected.push(row)选择/el-button /template /el-table-column /el-table /template2.3 开发环境配置推荐使用以下开发环境组合JDKAmazon Corretto 11LTS版本商业友好IDEIntelliJ IDEA智能代码补全 VS Code前端开发数据库工具DBeaver跨平台或Navicat PremiumAPI测试Postman接口调试 Swagger UI文档生成重要提示开发环境建议统一使用Docker容器化配置避免在我机器上能跑的问题。我们使用docker-compose管理MySQL和Redis服务具体配置见项目中的docker-compose.yml3. 系统架构设计3.1 整体架构图系统采用典型的分层架构┌───────────────────────────────────────┐ │ 前端层 │ │ ┌───────────┐ ┌─────────────┐ │ │ │ Vue3 │ │ Element Plus │ │ │ └───────────┘ └─────────────┘ │ └───────────────────┬───────────────────┘ │ HTTP/HTTPS ┌───────────────────▼───────────────────┐ │ 网关层 │ │ ┌─────────────────────────────────┐ │ │ │ Spring Cloud Gateway │ │ │ └─────────────────────────────────┘ │ └───────────────────┬───────────────────┘ │ ┌───────────────────▼───────────────────┐ │ 应用层 │ │ ┌───────────┐ ┌─────────────┐ │ │ │ SpringBoot │ │ MyBatis │ │ │ └───────────┘ └─────────────┘ │ └───────────────────┬───────────────────┘ │ ┌───────────────────▼───────────────────┐ │ 数据层 │ │ ┌───────────┐ ┌─────────────┐ │ │ │ MySQL │ │ Redis │ │ │ └───────────┘ └─────────────┘ │ └───────────────────────────────────────┘3.2 数据库设计要点教务系统的数据库设计有几个关键考量点角色权限分离采用RBAC模型设计权限系统CREATE TABLE sys_user ( id BIGINT NOT NULL AUTO_INCREMENT, username VARCHAR(50) NOT NULL COMMENT 登录账号, role_id INT NOT NULL COMMENT 角色ID, PRIMARY KEY (id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; CREATE TABLE sys_role ( id INT NOT NULL AUTO_INCREMENT, name VARCHAR(20) NOT NULL COMMENT 角色名称, code VARCHAR(20) NOT NULL COMMENT 角色编码, PRIMARY KEY (id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;选课关系设计学生与课程的多对多关系CREATE TABLE course_selection ( id BIGINT NOT NULL AUTO_INCREMENT, student_id BIGINT NOT NULL, course_id BIGINT NOT NULL, selection_time DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP, status TINYINT NOT NULL DEFAULT 0 COMMENT 0-待审核 1-已通过, PRIMARY KEY (id), UNIQUE KEY uk_student_course (student_id,course_id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;成绩表设计考虑补考、重修等场景CREATE TABLE course_score ( id BIGINT NOT NULL AUTO_INCREMENT, selection_id BIGINT NOT NULL, regular_score DECIMAL(5,2) COMMENT 平时成绩, exam_score DECIMAL(5,2) COMMENT 考试成绩, final_score DECIMAL(5,2) GENERATED ALWAYS AS ( COALESCE(regular_score*0.3,0) COALESCE(exam_score*0.7,0) ) STORED COMMENT 最终成绩, term VARCHAR(20) NOT NULL COMMENT 学期, is_rebuild TINYINT DEFAULT 0 COMMENT 是否重修, PRIMARY KEY (id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;3.3 API设计规范我们采用RESTful风格设计API遵循以下原则资源命名使用复数形式状态码规范200成功请求400参数错误401未授权403无权限404资源不存在响应体统一格式{ code: 200, message: success, data: {...}, timestamp: 1630000000000 }典型API示例选课接口RestController RequestMapping(/api/courses) public class CourseController { PostMapping(/{courseId}/selections) PreAuthorize(hasRole(STUDENT)) public ResponseEntityResult selectCourse( PathVariable Long courseId, CurrentUser Student student) { if (courseService.isConflict(student.getId(), courseId)) { return ResponseEntity.badRequest() .body(Result.error(课程时间冲突)); } Selection selection selectionService.createSelection( student.getId(), courseId); return ResponseEntity.ok(Result.success(selection)); } }4. 核心功能实现4.1 选课系统实现选课功能是教务系统的核心我们实现了以下关键特性选课冲突检测基于课程时间矩阵判断人数限制使用Redis分布式计数器选课流程采用状态机模式关键代码实现Service RequiredArgsConstructor public class CourseSelectionServiceImpl implements CourseSelectionService { private final RedisTemplateString, String redisTemplate; private final CourseRepository courseRepo; private final SelectionRepository selectionRepo; Transactional public Selection createSelection(Long studentId, Long courseId) { Course course courseRepo.findById(courseId) .orElseThrow(() - new BusinessException(课程不存在)); // 检查是否已选 if (selectionRepo.existsByStudentIdAndCourseId(studentId, courseId)) { throw new BusinessException(已选择该课程); } // 使用Redis Lua脚本保证原子性 String script local count redis.call(GET, KEYS[1]) if count and tonumber(count) tonumber(ARGV[1]) then return 0 else redis.call(INCR, KEYS[1]) return 1 end; String key course:limit: courseId; Boolean success redisTemplate.execute( new DefaultRedisScript(script, Boolean.class), Collections.singletonList(key), String.valueOf(course.getMaxStudents())); if (Boolean.FALSE.equals(success)) { throw new BusinessException(选课人数已满); } Selection selection new Selection(); selection.setStudentId(studentId); selection.setCourseId(courseId); selection.setStatus(SelectionStatus.PENDING); return selectionRepo.save(selection); } }4.2 成绩管理模块成绩管理包含以下技术要点Excel导入导出使用EasyExcel处理大数据量成绩计算采用策略模式支持不同计算规则成绩分析集成ECharts生成可视化报表成绩导入示例PostMapping(/scores/import) public void importScores(RequestParam MultipartFile file) { // 使用监听器模式处理大数据量 EasyExcel.read(file.getInputStream(), ScoreData.class, new ScoreImportListener(scoreService)) .sheet() .doRead(); } // 自定义监听器 public class ScoreImportListener extends AnalysisEventListenerScoreData { private final ScoreService scoreService; Override public void invoke(ScoreData data, AnalysisContext context) { // 数据校验 if (data.getScore() 0 || data.getScore() 100) { throw new BusinessException(成绩范围不合法); } scoreService.saveScore(data); } Override public void doAfterAllAnalysed(AnalysisContext context) { log.info(成绩导入完成); } }4.3 权限控制系统基于Spring Security JWT实现的安全控制登录流程sequenceDiagram participant Client participant Server Client-Server: 提交用户名/密码 Server-Server: 验证凭证 Server--Client: 返回JWT令牌 Client-Server: 携带令牌请求API Server-Server: 验证令牌有效性 Server--Client: 返回请求数据具体实现代码Configuration EnableWebSecurity RequiredArgsConstructor public class SecurityConfig extends WebSecurityConfigurerAdapter { private final UserDetailsService userDetailsService; private final JwtAuthenticationFilter jwtFilter; Override protected void configure(HttpSecurity http) throws Exception { http.csrf().disable() .authorizeRequests() .antMatchers(/api/auth/**).permitAll() .antMatchers(/api/admin/**).hasRole(ADMIN) .antMatchers(/api/teacher/**).hasRole(TEACHER) .anyRequest().authenticated() .and() .sessionManagement() .sessionCreationPolicy(SessionCreationPolicy.STATELESS); http.addFilterBefore(jwtFilter, UsernamePasswordAuthenticationFilter.class); } Bean public PasswordEncoder passwordEncoder() { return new BCryptPasswordEncoder(); } }5. 性能优化实践5.1 数据库优化索引优化为所有外键和查询条件添加索引ALTER TABLE course_selection ADD INDEX idx_student (student_id); ALTER TABLE course_selection ADD INDEX idx_course (course_id);查询优化使用JOIN替代多次查询Query(SELECT s FROM Selection s JOIN FETCH s.course JOIN FETCH s.student WHERE s.student.id :studentId) ListSelection findByStudentWithAssociations(Long studentId);分库分表对成绩表按学期分表Table(course_score_#{#tableSuffix}) public class CourseScore { // 动态表名通过AOP实现 }5.2 缓存策略采用多级缓存架构本地缓存Caffeine缓存课程基本信息分布式缓存Redis缓存选课人数等热点数据数据库缓存MySQL查询缓存缓存配置示例Configuration EnableCaching public class CacheConfig { Bean public CacheManager cacheManager() { CaffeineCacheManager manager new CaffeineCacheManager(); manager.setCaffeine(Caffeine.newBuilder() .expireAfterWrite(10, TimeUnit.MINUTES) .maximumSize(1000)); return manager; } } Service CacheConfig(cacheNames courses) public class CourseServiceImpl implements CourseService { Cacheable(key #id) public Course getById(Long id) { return courseRepo.findById(id).orElseThrow(); } CacheEvict(key #course.id) public void updateCourse(Course course) { courseRepo.save(course); } }5.3 并发控制选课高峰期采用以下策略乐观锁防止超选Transactional public boolean selectCourse(Long studentId, Long courseId) { Course course courseRepo.findWithLockById(courseId); if (course.getSelected() course.getCapacity()) { return false; } course.setSelected(course.getSelected() 1); courseRepo.save(course); // 创建选课记录... return true; }限流措施使用Guava RateLimiterRestController RequestMapping(/api/selections) public class SelectionController { private final RateLimiter rateLimiter RateLimiter.create(100.0); PostMapping public ResponseEntity? createSelection( RequestBody SelectionDTO dto) { if (!rateLimiter.tryAcquire()) { return ResponseEntity.status(429).build(); } // 处理选课逻辑 } }6. 部署与监控6.1 容器化部署使用Docker Compose编排服务version: 3.8 services: mysql: image: mysql:8.0 environment: MYSQL_ROOT_PASSWORD: ${DB_PASSWORD} volumes: - mysql_data:/var/lib/mysql ports: - 3306:3306 redis: image: redis:6.2 ports: - 6379:6379 backend: build: ./backend ports: - 8080:8080 depends_on: - mysql - redis frontend: build: ./frontend ports: - 80:80 volumes: mysql_data:6.2 监控方案Spring Boot Actuator暴露健康检查端点management.endpoints.web.exposure.includehealth,metrics,prometheus management.metrics.export.prometheus.enabledtruePrometheus Grafana监控看板JVM内存使用数据库连接池状态API响应时间P99日志收集ELK Stackdependency groupIdnet.logstash.logback/groupId artifactIdlogstash-logback-encoder/artifactId version7.2/version /dependency7. 踩坑经验分享7.1 事务失效场景自调用问题同类中方法调用不会触发代理Service public class CourseService { public void methodA() { methodB(); // 事务不会生效 } Transactional public void methodB() { // ... } }解决方案注入自身代理或拆分到不同类异常捕获捕获异常后事务不会回滚Transactional public void updateCourse() { try { // 可能抛出异常的操作 } catch (Exception e) { log.error(错误, e); // 事务不会回滚 } }正确做法Transactional public void updateCourse() { try { // 业务代码 } catch (BusinessException e) { throw e; // 重新抛出 } }7.2 性能陷阱N1查询问题ListSelection selections selectionRepo.findAll(); selections.forEach(s - { Course c courseRepo.findById(s.getCourseId()); // 每次都会查询 });解决方案使用EntityGraph定义抓取策略编写JOIN FETCH查询大事务问题成绩导入时整个方法加事务导致内存溢出优化方案public void importScores(ListScoreData dataList) { int batchSize 100; for (int i 0; i dataList.size(); i batchSize) { ListScoreData batch dataList.subList(i, Math.min(i batchSize, dataList.size())); processBatch(batch); // 每个批次单独事务 } } Transactional(propagation Propagation.REQUIRES_NEW) public void processBatch(ListScoreData batch) { // 处理批次数据 }7.3 前后端协作日期时间处理统一使用ISO8601格式// 前端axios配置 axios.defaults.transformRequest [(data, headers) { if (data instanceof Date) { return data.toISOString() } return data }]枚举值映射建立前后端一致的枚举定义// 后端枚举 public enum SelectionStatus { PENDING(0), APPROVED(1), REJECTED(2); JsonValue private final int code; }// 前端对应类型 enum SelectionStatus { PENDING 0, APPROVED 1, REJECTED 2 }8. 扩展与改进方向微服务改造将成绩管理、选课系统拆分为独立服务消息队列引入使用RabbitMQ处理选课结果通知分布式事务采用Seata保证选课-成绩记录的一致性智能推荐基于学生历史选课数据推荐课程当前架构已经预留了扩展点例如通过实现CourseRecommendationStrategy接口可以轻松添加新的推荐算法public interface CourseRecommendationStrategy { ListCourse recommend(Long studentId); } Service RequiredArgsConstructor public class CourseService { private final ListCourseRecommendationStrategy strategies; public ListCourse getRecommendations(Long studentId) { return strategies.stream() .flatMap(s - s.recommend(studentId).stream()) .distinct() .collect(Collectors.toList()); } }这个教务管理系统从技术选型到架构设计再到具体实现每个环节都经过仔细考量。在实际开发中最大的体会是一定要提前做好性能规划特别是在选课这种高并发场景下合理的缓存策略和并发控制至关重要。另外前后端分离架构虽然提高了开发效率但也带来了接口协作的挑战建立完善的API文档和类型定义非常必要。 
长河君 · 2026/9/21 18:20:41 · 阅读 1.2k Vue3+SpringBoot全栈教务系统开发实战
1. 项目概述与背景教务管理系统作为高校信息化建设的核心组成部分其重要性不言而喻。我最近完成了一个基于Vue3前端SpringBoot后端的全栈式教务管理系统开发这个项目从需求分析到最终部署上线历时三个月期间踩过不少坑也积累了不少实战经验。不同于传统的JSP/Thymeleaf方案我们采用前后端分离架构后端使用SpringBoot 2.7提供RESTful API前端则基于Vue3Element Plus构建响应式界面数据库选用MySQL 8.0作为持久层存储。这个系统主要解决三大核心问题多角色协同管理管理员、教师、学生教务全流程数字化从选课到成绩管理高并发场景下的系统稳定性系统上线后实测在500并发用户情况下平均响应时间保持在800ms以内较学校原有系统性能提升近3倍。下面我将从技术选型、架构设计到具体实现详细拆解这个项目的开发全过程。2. 技术栈选型解析2.1 后端技术栈选择SpringBoot作为后端框架主要基于以下几点考量快速启动通过starter依赖可快速集成MyBatis、Redis等组件内嵌容器无需额外配置Tomcat通过spring-boot-starter-web即可运行生态丰富Spring Security用于权限控制Spring Cache实现缓存抽象具体版本选择parent groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-parent/artifactId version2.7.5/version /parent数据库选型对比了MySQL和PostgreSQL最终选择MySQL 8.0的原因学校IT部门现有运维体系对MySQL支持更完善JSON字段支持满足课程信息的灵活存储需求窗口函数等特性足以应对复杂统计查询2.2 前端技术栈Vue3组合式API相比Options API更适合教务系统的开发逻辑复用将选课逻辑、成绩计算等封装成composable函数TypeScript支持完善的类型定义减少运行时错误性能优化静态提升和补丁标志使更新更高效典型组件结构示例// 选课组件 script setup const { courses, selected } useCourseSelection() const { submit } useCourseAPI() /script template el-table :datacourses el-table-column propname label课程名称/ el-table-column template #default{row} el-button clickselected.push(row)选择/el-button /template /el-table-column /el-table /template2.3 开发环境配置推荐使用以下开发环境组合JDKAmazon Corretto 11LTS版本商业友好IDEIntelliJ IDEA智能代码补全 VS Code前端开发数据库工具DBeaver跨平台或Navicat PremiumAPI测试Postman接口调试 Swagger UI文档生成重要提示开发环境建议统一使用Docker容器化配置避免在我机器上能跑的问题。我们使用docker-compose管理MySQL和Redis服务具体配置见项目中的docker-compose.yml3. 系统架构设计3.1 整体架构图系统采用典型的分层架构┌───────────────────────────────────────┐ │ 前端层 │ │ ┌───────────┐ ┌─────────────┐ │ │ │ Vue3 │ │ Element Plus │ │ │ └───────────┘ └─────────────┘ │ └───────────────────┬───────────────────┘ │ HTTP/HTTPS ┌───────────────────▼───────────────────┐ │ 网关层 │ │ ┌─────────────────────────────────┐ │ │ │ Spring Cloud Gateway │ │ │ └─────────────────────────────────┘ │ └───────────────────┬───────────────────┘ │ ┌───────────────────▼───────────────────┐ │ 应用层 │ │ ┌───────────┐ ┌─────────────┐ │ │ │ SpringBoot │ │ MyBatis │ │ │ └───────────┘ └─────────────┘ │ └───────────────────┬───────────────────┘ │ ┌───────────────────▼───────────────────┐ │ 数据层 │ │ ┌───────────┐ ┌─────────────┐ │ │ │ MySQL │ │ Redis │ │ │ └───────────┘ └─────────────┘ │ └───────────────────────────────────────┘3.2 数据库设计要点教务系统的数据库设计有几个关键考量点角色权限分离采用RBAC模型设计权限系统CREATE TABLE sys_user ( id BIGINT NOT NULL AUTO_INCREMENT, username VARCHAR(50) NOT NULL COMMENT 登录账号, role_id INT NOT NULL COMMENT 角色ID, PRIMARY KEY (id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; CREATE TABLE sys_role ( id INT NOT NULL AUTO_INCREMENT, name VARCHAR(20) NOT NULL COMMENT 角色名称, code VARCHAR(20) NOT NULL COMMENT 角色编码, PRIMARY KEY (id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;选课关系设计学生与课程的多对多关系CREATE TABLE course_selection ( id BIGINT NOT NULL AUTO_INCREMENT, student_id BIGINT NOT NULL, course_id BIGINT NOT NULL, selection_time DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP, status TINYINT NOT NULL DEFAULT 0 COMMENT 0-待审核 1-已通过, PRIMARY KEY (id), UNIQUE KEY uk_student_course (student_id,course_id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;成绩表设计考虑补考、重修等场景CREATE TABLE course_score ( id BIGINT NOT NULL AUTO_INCREMENT, selection_id BIGINT NOT NULL, regular_score DECIMAL(5,2) COMMENT 平时成绩, exam_score DECIMAL(5,2) COMMENT 考试成绩, final_score DECIMAL(5,2) GENERATED ALWAYS AS ( COALESCE(regular_score*0.3,0) COALESCE(exam_score*0.7,0) ) STORED COMMENT 最终成绩, term VARCHAR(20) NOT NULL COMMENT 学期, is_rebuild TINYINT DEFAULT 0 COMMENT 是否重修, PRIMARY KEY (id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;3.3 API设计规范我们采用RESTful风格设计API遵循以下原则资源命名使用复数形式状态码规范200成功请求400参数错误401未授权403无权限404资源不存在响应体统一格式{ code: 200, message: success, data: {...}, timestamp: 1630000000000 }典型API示例选课接口RestController RequestMapping(/api/courses) public class CourseController { PostMapping(/{courseId}/selections) PreAuthorize(hasRole(STUDENT)) public ResponseEntityResult selectCourse( PathVariable Long courseId, CurrentUser Student student) { if (courseService.isConflict(student.getId(), courseId)) { return ResponseEntity.badRequest() .body(Result.error(课程时间冲突)); } Selection selection selectionService.createSelection( student.getId(), courseId); return ResponseEntity.ok(Result.success(selection)); } }4. 核心功能实现4.1 选课系统实现选课功能是教务系统的核心我们实现了以下关键特性选课冲突检测基于课程时间矩阵判断人数限制使用Redis分布式计数器选课流程采用状态机模式关键代码实现Service RequiredArgsConstructor public class CourseSelectionServiceImpl implements CourseSelectionService { private final RedisTemplateString, String redisTemplate; private final CourseRepository courseRepo; private final SelectionRepository selectionRepo; Transactional public Selection createSelection(Long studentId, Long courseId) { Course course courseRepo.findById(courseId) .orElseThrow(() - new BusinessException(课程不存在)); // 检查是否已选 if (selectionRepo.existsByStudentIdAndCourseId(studentId, courseId)) { throw new BusinessException(已选择该课程); } // 使用Redis Lua脚本保证原子性 String script local count redis.call(GET, KEYS[1]) if count and tonumber(count) tonumber(ARGV[1]) then return 0 else redis.call(INCR, KEYS[1]) return 1 end; String key course:limit: courseId; Boolean success redisTemplate.execute( new DefaultRedisScript(script, Boolean.class), Collections.singletonList(key), String.valueOf(course.getMaxStudents())); if (Boolean.FALSE.equals(success)) { throw new BusinessException(选课人数已满); } Selection selection new Selection(); selection.setStudentId(studentId); selection.setCourseId(courseId); selection.setStatus(SelectionStatus.PENDING); return selectionRepo.save(selection); } }4.2 成绩管理模块成绩管理包含以下技术要点Excel导入导出使用EasyExcel处理大数据量成绩计算采用策略模式支持不同计算规则成绩分析集成ECharts生成可视化报表成绩导入示例PostMapping(/scores/import) public void importScores(RequestParam MultipartFile file) { // 使用监听器模式处理大数据量 EasyExcel.read(file.getInputStream(), ScoreData.class, new ScoreImportListener(scoreService)) .sheet() .doRead(); } // 自定义监听器 public class ScoreImportListener extends AnalysisEventListenerScoreData { private final ScoreService scoreService; Override public void invoke(ScoreData data, AnalysisContext context) { // 数据校验 if (data.getScore() 0 || data.getScore() 100) { throw new BusinessException(成绩范围不合法); } scoreService.saveScore(data); } Override public void doAfterAllAnalysed(AnalysisContext context) { log.info(成绩导入完成); } }4.3 权限控制系统基于Spring Security JWT实现的安全控制登录流程sequenceDiagram participant Client participant Server Client-Server: 提交用户名/密码 Server-Server: 验证凭证 Server--Client: 返回JWT令牌 Client-Server: 携带令牌请求API Server-Server: 验证令牌有效性 Server--Client: 返回请求数据具体实现代码Configuration EnableWebSecurity RequiredArgsConstructor public class SecurityConfig extends WebSecurityConfigurerAdapter { private final UserDetailsService userDetailsService; private final JwtAuthenticationFilter jwtFilter; Override protected void configure(HttpSecurity http) throws Exception { http.csrf().disable() .authorizeRequests() .antMatchers(/api/auth/**).permitAll() .antMatchers(/api/admin/**).hasRole(ADMIN) .antMatchers(/api/teacher/**).hasRole(TEACHER) .anyRequest().authenticated() .and() .sessionManagement() .sessionCreationPolicy(SessionCreationPolicy.STATELESS); http.addFilterBefore(jwtFilter, UsernamePasswordAuthenticationFilter.class); } Bean public PasswordEncoder passwordEncoder() { return new BCryptPasswordEncoder(); } }5. 性能优化实践5.1 数据库优化索引优化为所有外键和查询条件添加索引ALTER TABLE course_selection ADD INDEX idx_student (student_id); ALTER TABLE course_selection ADD INDEX idx_course (course_id);查询优化使用JOIN替代多次查询Query(SELECT s FROM Selection s JOIN FETCH s.course JOIN FETCH s.student WHERE s.student.id :studentId) ListSelection findByStudentWithAssociations(Long studentId);分库分表对成绩表按学期分表Table(course_score_#{#tableSuffix}) public class CourseScore { // 动态表名通过AOP实现 }5.2 缓存策略采用多级缓存架构本地缓存Caffeine缓存课程基本信息分布式缓存Redis缓存选课人数等热点数据数据库缓存MySQL查询缓存缓存配置示例Configuration EnableCaching public class CacheConfig { Bean public CacheManager cacheManager() { CaffeineCacheManager manager new CaffeineCacheManager(); manager.setCaffeine(Caffeine.newBuilder() .expireAfterWrite(10, TimeUnit.MINUTES) .maximumSize(1000)); return manager; } } Service CacheConfig(cacheNames courses) public class CourseServiceImpl implements CourseService { Cacheable(key #id) public Course getById(Long id) { return courseRepo.findById(id).orElseThrow(); } CacheEvict(key #course.id) public void updateCourse(Course course) { courseRepo.save(course); } }5.3 并发控制选课高峰期采用以下策略乐观锁防止超选Transactional public boolean selectCourse(Long studentId, Long courseId) { Course course courseRepo.findWithLockById(courseId); if (course.getSelected() course.getCapacity()) { return false; } course.setSelected(course.getSelected() 1); courseRepo.save(course); // 创建选课记录... return true; }限流措施使用Guava RateLimiterRestController RequestMapping(/api/selections) public class SelectionController { private final RateLimiter rateLimiter RateLimiter.create(100.0); PostMapping public ResponseEntity? createSelection( RequestBody SelectionDTO dto) { if (!rateLimiter.tryAcquire()) { return ResponseEntity.status(429).build(); } // 处理选课逻辑 } }6. 部署与监控6.1 容器化部署使用Docker Compose编排服务version: 3.8 services: mysql: image: mysql:8.0 environment: MYSQL_ROOT_PASSWORD: ${DB_PASSWORD} volumes: - mysql_data:/var/lib/mysql ports: - 3306:3306 redis: image: redis:6.2 ports: - 6379:6379 backend: build: ./backend ports: - 8080:8080 depends_on: - mysql - redis frontend: build: ./frontend ports: - 80:80 volumes: mysql_data:6.2 监控方案Spring Boot Actuator暴露健康检查端点management.endpoints.web.exposure.includehealth,metrics,prometheus management.metrics.export.prometheus.enabledtruePrometheus Grafana监控看板JVM内存使用数据库连接池状态API响应时间P99日志收集ELK Stackdependency groupIdnet.logstash.logback/groupId artifactIdlogstash-logback-encoder/artifactId version7.2/version /dependency7. 踩坑经验分享7.1 事务失效场景自调用问题同类中方法调用不会触发代理Service public class CourseService { public void methodA() { methodB(); // 事务不会生效 } Transactional public void methodB() { // ... } }解决方案注入自身代理或拆分到不同类异常捕获捕获异常后事务不会回滚Transactional public void updateCourse() { try { // 可能抛出异常的操作 } catch (Exception e) { log.error(错误, e); // 事务不会回滚 } }正确做法Transactional public void updateCourse() { try { // 业务代码 } catch (BusinessException e) { throw e; // 重新抛出 } }7.2 性能陷阱N1查询问题ListSelection selections selectionRepo.findAll(); selections.forEach(s - { Course c courseRepo.findById(s.getCourseId()); // 每次都会查询 });解决方案使用EntityGraph定义抓取策略编写JOIN FETCH查询大事务问题成绩导入时整个方法加事务导致内存溢出优化方案public void importScores(ListScoreData dataList) { int batchSize 100; for (int i 0; i dataList.size(); i batchSize) { ListScoreData batch dataList.subList(i, Math.min(i batchSize, dataList.size())); processBatch(batch); // 每个批次单独事务 } } Transactional(propagation Propagation.REQUIRES_NEW) public void processBatch(ListScoreData batch) { // 处理批次数据 }7.3 前后端协作日期时间处理统一使用ISO8601格式// 前端axios配置 axios.defaults.transformRequest [(data, headers) { if (data instanceof Date) { return data.toISOString() } return data }]枚举值映射建立前后端一致的枚举定义// 后端枚举 public enum SelectionStatus { PENDING(0), APPROVED(1), REJECTED(2); JsonValue private final int code; }// 前端对应类型 enum SelectionStatus { PENDING 0, APPROVED 1, REJECTED 2 }8. 扩展与改进方向微服务改造将成绩管理、选课系统拆分为独立服务消息队列引入使用RabbitMQ处理选课结果通知分布式事务采用Seata保证选课-成绩记录的一致性智能推荐基于学生历史选课数据推荐课程当前架构已经预留了扩展点例如通过实现CourseRecommendationStrategy接口可以轻松添加新的推荐算法public interface CourseRecommendationStrategy { ListCourse recommend(Long studentId); } Service RequiredArgsConstructor public class CourseService { private final ListCourseRecommendationStrategy strategies; public ListCourse getRecommendations(Long studentId) { return strategies.stream() .flatMap(s - s.recommend(studentId).stream()) .distinct() .collect(Collectors.toList()); } }这个教务管理系统从技术选型到架构设计再到具体实现每个环节都经过仔细考量。在实际开发中最大的体会是一定要提前做好性能规划特别是在选课这种高并发场景下合理的缓存策略和并发控制至关重要。另外前后端分离架构虽然提高了开发效率但也带来了接口协作的挑战建立完善的API文档和类型定义非常必要。