简介面向高校课程作业与毕业设计场景的 SpringBoot 教务管理系统完整项目以后端 SpringBoot 与前端 Vue.js 组成前后端分离架构覆盖课程管理、学生管理、教师管理、成绩管理四大核心模块并基于 MySQL 完成数据建模与存储体现教育信息化系统从需求到落地的完整实践路径。资源包共 361 个文件压缩包约 11.97MB主要包括 94 个 Java 后端源码、83 个 Vue 前端页面、40 个 JavaScript 脚本以及 CSS 样式、XML 配置、SQL 建表脚本、开发文档、用户手册等支撑性文件目录结构清晰适合按模块进行阅读与二次开发。系统在需求分析、数据库设计、编码实现、单元测试与集成测试等环节均有完整记录开发者可直接导入项目并在本地部署运行也可以参照其中的权限控制机制、模块划分方式和接口设计来完善自己的课程设计或毕业设计。作者还提供配套的开发文档与用户手册便于在撰写课程设计报告、准备答辩演示或进行功能展示时快速引用。当前已有 278 人学习下载适合正在完成同类选题或希望快速搭建教务管理原型的 Java 学习者。1. SpringBoot教务管理系统的落地思路先把业务闭环想清楚再写代码教务管理系统是个典型的看着简单、做起来绕的单体项目。很多团队一上来就分十几个模块学生管理、教师管理、课程管理、选课管理、成绩管理、公告管理铺满数据库结果一半精力耗在CRUD上真正的难点——选课冲突、成绩复核、权限边界——反而没写好。这个标题背后要解决的问题并不是怎么用SpringBoot建一个web项目而是怎么用SpringBoot把教务系统的数据闭环和业务规则稳定地跑起来。对5年以上的工程师来说这类系统真正值得关注的是数据模型设计、并发选课的事务控制、登录认证与接口权限管理。对正在做Java毕设或准备内部管理系统的开发来说SpringBoot只是骨架业务逻辑才是血肉。这套方案的可行路径是先定模块边界再建表再写接口最后用Spring Security控制入口。下文按这条路逐步展开每一层都给可直接复用的代码和参数说明。2. SpringBoot教务管理系统的模块边界与选型逻辑2.1 教务系统的模块边界课程、选课、成绩三条主线教务管理系统无论前端页面长什么样后端逻辑始终围绕三个主流程运转开课排课、学生选课、教师录入成绩。这三个流程形成一条数据链学期 - 课程 - 选课记录 - 成绩。其他功能如学生信息、教师信息、公告管理本质上是这条主链的附属数据。我一般会先画一张模块图把实体之间的关系定下来学生student与选课记录course_selection是一对多课程course与选课记录是一对多课程与教师是多对一一个教师可以带多门课成绩score挂在选课记录上而不是单独建一张与课程和学生都关联的表避免冗余。这个设计决定了后续所有接口的查询路径。比如查某个学生本学期成绩单SQL只需要join两张表course_selection 和 course不需要再去关联 student 表。数据模型精简接口写起来才快。2.2 用SpringBoot自动装配能力把分层骨架搭起来SpringBoot的核心价值在于自动装配引入一个starter依赖框架自动帮你把对应的Bean注册到容器里。搭建教务系统时我一般会在 pom.xml 里放这几组依赖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 groupIdcom.mysql/groupId artifactIdmysql-connector-j/artifactId scoperuntime/scope /dependency dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-validation/artifactId /dependency逻辑说明spring-boot-starter-web 负责内嵌Tomcat和Spring MVCmybatis-plus-boot-starter 帮我们把MyBatis的SqlSessionFactory、Mapper扫描等底层配置自动装配好省掉大量XML配置mysql-connector-j 是驱动validation 用于DTO参数校验。加完依赖后只需要在启动类上加 SpringBootApplication 注解再在 application.yml 里配置数据源即可。这里有个习惯值得一提SpringBoot版本的选择不要盲目追新。JDK8环境用2.7.xJDK17用3.x。2.7.x 对 javax.* 命名空间兼容最好很多老项目迁移成本低3.x 切换到了 jakarta.*如果团队不熟容易踩坑。2.3 组件选型的对照表与边界条件教务管理系统的技术选型不需要花哨但每一块都要能说出理由关注点推荐方案选型理由应用骨架SpringBoot 2.7.x 或 3.x自动装配省配置内嵌容器方便部署ORM框架MyBatis-Plus单表CRUD免写SQL复杂统计用注解SQL兜底权限认证Spring Security JWT过滤器链成熟方法级权限注解方便控制接口接口文档springdoc-openapi自动生成Swagger文档联调效率高生产环境要关闭缓存Redis验证码、幂等key、频繁查询的热点课程都可以放缓存要注意MyBatis-Plus不擅长复杂多表join的分页查询。选课报表这种场景我会在Mapper里写自定义SQL而不是靠Wrapper硬拼。此外如果后续并发量真的上来单体应用可以先加Redis缓存再不行才拆微服务。教务管理系统的瓶颈通常不在并发而在数据一致性和权限复杂度不要为了架构而架构。3. 教务核心数据模型建表、选课冲突检测与并发控制3.1 学生、课程、选课三张核心表的结构设计选课是教务系统里最容易出问题的环节所以表结构必须围绕它设计。下面是简化后的核心表结构CREATE TABLE student ( id BIGINT PRIMARY KEY AUTO_INCREMENT, student_no VARCHAR(20) NOT NULL UNIQUE COMMENT 学号, name VARCHAR(50) NOT NULL COMMENT 姓名, password VARCHAR(100) NOT NULL COMMENT 登录密码BCrypt加密, major VARCHAR(50) COMMENT 专业, grade INT COMMENT 年级, status TINYINT DEFAULT 1 COMMENT 1在校 0离校 ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; CREATE TABLE course ( id BIGINT PRIMARY KEY AUTO_INCREMENT, course_no VARCHAR(20) NOT NULL UNIQUE COMMENT 课程编号, course_name VARCHAR(100) NOT NULL COMMENT 课程名称, teacher_id BIGINT NOT NULL COMMENT 授课教师ID, credit DECIMAL(3,1) DEFAULT 2.0 COMMENT 学分, capacity INT NOT NULL DEFAULT 60 COMMENT 选课容量, selected_count INT DEFAULT 0 COMMENT 已选人数, semester VARCHAR(20) NOT NULL COMMENT 开课学期如2025-2026-1, schedule VARCHAR(100) COMMENT 上课时间如周一3-4节, version INT DEFAULT 0 COMMENT 乐观锁版本号 ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; CREATE TABLE course_selection ( id BIGINT PRIMARY KEY AUTO_INCREMENT, student_id BIGINT NOT NULL COMMENT 学生ID, course_id BIGINT NOT NULL COMMENT 课程ID, semester VARCHAR(20) NOT NULL COMMENT 学期, score DECIMAL(5,2) DEFAULT NULL COMMENT 成绩, status TINYINT DEFAULT 0 COMMENT 0已选 1退课 2已录入成绩, create_time DATETIME DEFAULT CURRENT_TIMESTAMP, UNIQUE KEY uk_student_course (student_id, course_id, semester) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;表结构说明course_selection 表里的唯一索引 uk_student_course 是防重复选课的第一道屏障比在代码里查一遍再插入可靠得多。course 表里的 selected_count 字段是一个冗余计数方便查课表时直接显示余量但它的更新必须放在事务里否则会出现超选。3.2 用MyBatis-Plus实现选课落库与冲突检测选课业务的核心逻辑有三步检查课程容量、检查上课时间冲突、插入选课记录并更新已选人数。用MyBatis-Plus写的话Service层代码大致是这个样子Service public class CourseSelectionServiceImpl implements CourseSelectionService { Autowired private CourseMapper courseMapper; Autowired private CourseSelectionMapper selectionMapper; Override Transactional(rollbackFor Exception.class) public boolean selectCourse(Long studentId, Long courseId, String semester) { // 1. 查询课程信息校验是否存在 Course course courseMapper.selectById(courseId); if (course null) { throw new BizException(课程不存在); } // 2. 用乐观锁更新已选人数防止并发超选 int updated courseMapper.updateSelectedCount(courseId, course.getVersion()); if (updated 0) { throw new BizException(选课人数已满请选择其他课程); } // 3. 插入选课记录捕获唯一索引冲突 CourseSelection selection new CourseSelection(); selection.setStudentId(studentId); selection.setCourseId(courseId); selection.setSemester(semester); try { selectionMapper.insert(selection); } catch (DuplicateKeyException e) { throw new BizException(您已选过该课程请勿重复操作); } return true; } }对应的 Mapper 方法需要写一条自定义SQLMapper public interface CourseMapper extends BaseMapperCourse { Update(UPDATE course SET selected_count selected_count 1, version version 1 WHERE id #{courseId} AND selected_count capacity AND version #{version}) int updateSelectedCount(Param(courseId) Long courseId, Param(version) Integer version); }逻辑说明updateSelectedCount 这个方法把查容量、加一人、改版本号合并成一条原子SQL数据库行锁会保证同一时刻只有一个事务能更新成功。update 返回0就说明容量已满或版本号变了直接抛异常让事务回滚。插入选课记录时捕获 DuplicateKeyException这样即使两个请求同时到达唯一索引也能拦住重复选课。3.3 事务边界与回滚的常见误用Transactional 放在哪一层很关键。我见过不少项目把事务直接写在Controller上这会让事务范围变得不可控一个接口里无关的读操作也被包进长事务数据库连接池容易被耗尽。正确做法是事务只放在写操作的Service方法上读接口不加事务。另外要注意 Transactional 默认只在RuntimeException时回滚如果业务代码抛的是 checked exception比如 FileNotFoundException事务不会回滚。所以我在代码里统一使用 rollbackFor Exception.class避免这个坑。还有一点事务里不要调用外部HTTP接口或做耗时操作。选课逻辑里如果同时要发通知邮件应该先提交事务再异步发消息。否则事务长时间不释放遇到高峰选课很容易出现死锁或连接池打满。4. SpringBoot登录认证与接口权限拦截4.1 基于JWT的无状态登录方案设计教务管理系统有学生、教师、管理员三种角色接口权限天然不同。传统Session方案在单体应用里够用但前后端分离场景下JWT更合适服务端不存会话状态登录成功后签发一个带角色信息的token前端每次请求放到Authorization头里后端用过滤器解析。JWT生成与解析的工具类可以直接复用下面的写法Component public class JwtUtil { Value(${jwt.secret}) private String secret; Value(${jwt.expire-hours}) private Long expireHours; public String generateToken(Long userId, String role) { return Jwts.builder() .setSubject(String.valueOf(userId)) .claim(role, role) .setIssuedAt(new Date()) .setExpiration(new Date(System.currentTimeMillis() expireHours * 3600 * 1000)) .signWith(SignatureAlgorithm.HS256, secret) .compact(); } public Claims parseToken(String token) { return Jwts.parser() .setSigningKey(secret) .parseClaimsJws(token) .getBody(); } }逻辑说明把jwt.secret和jwt.expire-hours放到application.yml里用Value注入而不是硬编码便于不同环境切换配置。HS256是常用的对称加密算法secret要足够长生产环境至少32位。token过期时间建议设8小时对管理系统来说够用了如果用户一直操作可以在拦截器里做续签。4.2 Spring Security过滤器链与白名单放行Spring Security的配置是整个权限体系的核心。教务系统的实际需求是登录接口和Swagger文档可以匿名访问其余接口都要带上token才能访问。SecurityConfig大致写成这样Configuration EnableWebSecurity EnableGlobalMethodSecurity(prePostEnabled true) public class SecurityConfig { Autowired private JwtAuthenticationFilter jwtAuthenticationFilter; Bean public SecurityFilterChain filterChain(HttpSecurity http) throws Exception { http.csrf(csrf - csrf.disable()) .sessionManagement(session - session.sessionCreationPolicy(SessionCreationPolicy.STATELESS)) .authorizeHttpRequests(auth - auth .requestMatchers(/api/auth/login, /doc.html, /webjars/**, /v3/api-docs/**).permitAll() .requestMatchers(HttpMethod.OPTIONS, /**).permitAll() .anyRequest().authenticated() ) .addFilterBefore(jwtAuthenticationFilter, UsernamePasswordAuthenticationFilter.class); return http.build(); } }逻辑说明csrf关闭是因为JWT方案本身就是无状态的不依赖CookieCSRF攻击面很小sessionManagement设为STATELESS表示不创建HttpSessionpermitAll放行登录接口和Swagger资源OPTIONS请求放行是为了跨域预检请求。这里有一个安全细节Swagger接口文件如果暴露到生产环境容易被扫描到未授权API所以生产环境配置里要去掉doc.html和v3/api-docs的放行规则。JwtAuthenticationFilter 的作用是拦截每个请求从请求头解析token把用户信息放进SecurityContextComponent public class JwtAuthenticationFilter extends OncePerRequestFilter { Override protected void doFilterInternal(HttpServletRequest request, HttpServletResponse response, FilterChain filterChain) throws ServletException, IOException { String authHeader request.getHeader(Authorization); if (authHeader ! null authHeader.startsWith(Bearer )) { String token authHeader.substring(7); try { Claims claims jwtUtil.parseToken(token); // 从数据库加载用户并构建认证对象 UsernamePasswordAuthenticationToken authentication new UsernamePasswordAuthenticationToken(user, null, user.getAuthorities()); SecurityContextHolder.getContext().setAuthentication(authentication); } catch (Exception e) { // token无效或过期不设置authentication后续会被拒绝 } } filterChain.doFilter(request, response); } }参数说明这里是鉴权链路的关键——只有当request带着有效tokenSecurityContext才会有用户信息后续的PreAuthorize才能判断角色。捕获到异常时不直接返回401而是继续走过滤器链最终由Spring Security的ExceptionTranslationFilter统一处理未认证请求这样错误响应格式能保持一致。4.3 用常用注解控制接口粒度SpringBoot管理系统里最常用的权限控制注解就是PreAuthorize。开启方式就是在SecurityConfig上加EnableGlobalMethodSecurity(prePostEnabled true)。然后在Controller上按角色限流RestController RequestMapping(/api/course) public class CourseController { PostMapping PreAuthorize(hasRole(ADMIN)) public Result? createCourse(Valid RequestBody CourseDTO dto) { return Result.ok(courseService.createCourse(dto)); } GetMapping(/my) PreAuthorize(hasAnyRole(STUDENT,TEACHER)) public Result? getMyCourses(RequestParam Long userId) { return Result.ok(courseService.listByUserId(userId)); } }逻辑说明hasRole(ADMIN)要求当前用户必须拥有ROLE_ADMIN权限hasAnyRole则允许两种角色访问。注意Spring Security默认会在角色前面加ROLE_前缀所以数据库里存的角色字段要么存ROLE_ADMIN要么代码里组装SimpleGrantedAuthority时手动补前缀。选课、成绩录入这些接口分别限定学生和教师管理员不参与具体业务操作。5. 用yml密文与幂等验证给SpringBoot教务系统收尾5.1 用ConfigurationProperties配合密文保护数据库密码SpringBoot项目里数据库密码、JWT密钥这些敏感信息如果明文写在application.yml里一旦项目代码泄露或被扫描到整个系统等于裸奔。常见的做法是使用Jasypt对敏感字段加密配置类用ConfigurationProperties把解密后的属性绑定到Java对象里。先在pom.xml引入依赖然后在application.yml里配置密文jasypt: encryptor: password: ${JASYPT_PASSWORD} algorithm: PBEWithMD5AndDES spring: datasource: url: jdbc:mysql://localhost:3306/edu?useUnicodetruecharacterEncodingutf8 username: root password: ENC(加密后的密文字符串)再用一个配置类读取Component ConfigurationProperties(prefix spring.datasource) Data public class DataSourceProperties { private String url; private String username; private String password; }逻辑说明Jasypt的ENC()包裹的密文在SpringBoot启动时会被自动解密真正的密码在配置里是看不到的。JASYPT_PASSWORD通过环境变量注入解密密钥避免密钥出现在代码仓库里。对于SpringBoot 3.x注意选择与JDK兼容的Jasypt版本否则会出现解密算法找不到的报错。另一个敏感信息泄露点来自SpringBoot Actuator的heapdump端点。如果项目引入了actuator且没有限制端点暴露攻击者可以通过heapdump下载堆内存文件从中提取数据库密码、JWT密钥等敏感数据。我一般在生产配置里关闭非必要端点management: endpoints: web: exposure: include: health,info5.2 选课接口的幂等验证与压测确认教务系统上线前选课接口是必测的。为了避免同一个人疯狂点击导致重复请求除了数据库唯一索引兜底还要在前端和后端双重做拦截。后端用Redis做幂等key是最直接的方案Override public boolean selectCourseWithIdempotent(Long studentId, Long courseId, String semester, String requestId) { // 利用Redis setnx同一个请求只允许第一次执行 Boolean first redisTemplate.opsForValue() .setIfAbsent(idempotent:select: requestId, 1, Duration.ofMinutes(10)); if (!Boolean.TRUE.equals(first)) { throw new BizException(请勿重复提交请求); } return selectCourse(studentId, courseId, semester); }逻辑说明requestId由前端在发起请求时生成同一用户快速点击时requestId相同第一次请求把key写入Redis之后的请求发现key已存在就直接拒绝。密钥过期时间设为10分钟防止用户犹豫不决导致key堆积。验证这一套流程是否正常工作时我们通常用curl连续提交两次相同请求curl -X POST http://localhost:8080/api/course/select \ -H Authorization: Bearer eyJhbGciOiJIUzI1NiJ9... \ -H Content-Type: application/json \ -d {courseId:1,semester:2025-2026-1,requestId:10086}第一次返回成功第二次应该返回请勿重复提交请求。如果第二次也成功说明唯一索引、Redis幂等、事务回滚三者至少有一个失效需要回头检查事务注解是否生效、Redis连接是否正常。生产环境的教务系统这个验证是上线的底线等到学生真的一起抢课再发现问题就晚了。本文还有配套的精品资源点击获取