Spring Boot学生成绩管理系统：从分层架构到权限与报表落地

简介基于Spring Boot框架的学生成绩管理系统源码包面向高校计算机相关专业的毕业设计、课程设计及Spring Boot初学者。项目覆盖用户登录与角色权限、成绩录入与批量Excel导入、成绩多条件查询、统计报表以及班级信息管理功能完整可直接运行或二次开发。源码包内共225个文件压缩包约2.39MB以88个Java源文件为核心包含Controller、Service、实体及配置类另有23个JS、13个HTML、6个CSS及Layui相关静态资源用于前端页面和交互附75个GIF演示图便于快速了解界面操作流程同时提供Gradle构建配置、application.yml和数据库脚本环境搭建相对省心。目前已有136人浏览学习适合用作论文配套源码或项目练手。整体目录结构清晰能直观看到业务分层与前端资源组织对理解Spring Boot整合前端模板有一定帮助。1. 学生成绩管理系统的业务痛点与Spring Boot选型理由学校的成绩管理从来不只是“存分数”这么简单。班主任要录平时分任课老师要录期末分教务处要按班级和课程汇总排名学生和家长还要能查到自己孩子的历次成绩。几套不同角色三种数据口径落到系统里就是权限隔离和统计口径问题。我经手过的几套成绩管理系统最费时间的往往不是写SQL而是理清“谁在什么时间能改什么分数”这条规则。Spring Boot在这个场景下的价值是开箱即用的工程化能力内嵌Tomcat让部署包就是一个JARSpring Data JPA或MyBatis把数据访问层收敛起来Spring Security负责角色控制Actuator提供运行时监控。相比SSH那种需要手工组装的环境Spring Boot让你把主要精力放在成绩业务本身而不是框架配置。下面这套方案从架构、编码、查询优化到上线部署完整铺开适合用Spring Boot做课设的开发者也适合要接手类似教务系统的工程师。2. 基于Spring Boot四层架构的成绩管理系统目录规范2.1 四层架构的职责边界Controller、Service、Repository的划分很多Spring Boot项目把业务代码堆在Controller里Controller直接调Repository看起来代码量少但成绩管理这类系统有明确的角色和状态转换比如补考成绩不能覆盖原成绩、成绩发布后修改需要审批。如果缺了Service这一层这些规则会散落在各个接口里改一处漏三处。这里说的四层架构是Controller、Service、Repository之外再加一层DTO/VO。DTO用来做接口入参校验和出参裁剪避免把Entity直接暴露给前端Entity和数据库表一一对应VO按页面需求组装。以成绩领域为例前端提交的是一个ScoreCreateDTO包括studentId、courseId、score、term、examType而ScoreEntity里还包含creatorId、createTime、updateTime这类审计字段。两者分离后接口文档清楚数据库表结构也更容易调整。Spring Boot 3.x下分层依然是最稳妥的工程约定到了Spring Boot 4.x自动配置类的位置有调整但Controller/Service/Repository的分层边界不会变反而因为模块化更强调接口隔离。2.2 成绩管理系统的标准目录结构与包名规范我一般会按下面这种方式组织包结构这是一个可以直接套用的Spring Boot目录规范com.example.score ├── controller # Web层接收请求和参数校验 │ ├── AuthController.java │ ├── ScoreController.java │ └── StudentController.java ├── service # 业务逻辑层事务边界在这里 │ ├── ScoreService.java │ └── impl │ └── ScoreServiceImpl.java ├── repository # 数据访问层Spring Data JPA或MyBatis Mapper │ ├── ScoreRepository.java │ └── StudentRepository.java ├── entity # 与数据库表对应的实体 │ ├── Score.java │ └── Student.java ├── dto # 入参校验对象和返回视图对象 │ ├── ScoreCreateDTO.java │ └── ScoreStatsVO.java ├── config # Security、数据源等自动配置类 │ └── SecurityConfig.java ├── common # 统一返回体、异常处理、工具类 │ ├── Result.java │ └── GlobalExceptionHandler.java └── ScoreApplication.java这个结构的关键点是controller里不出现SQLservice里不出现HttpServletRequestrepository里不出现业务判断。分层之后单测可以只针对service层mock repository接口压测也能定位到具体瓶颈。常见做法是团队里新人一上来就往controller里写业务review时我会要求他们把超过十行的业务逻辑下沉到service。还有一个约定跨模块的调用只允许上层依赖下层不允许repository直接调controller否则循环依赖会随着版本迭代越来越难解。2.3 成绩表设计、唯一索引与JPA实体映射成绩管理涉及的核心表一般是四张用户表user、学生表student、课程表course、成绩表score。学生和用户可以是同一张表也可以分开取决于学校是否给家长单独开放账号。下面是一份按常见需求设计的score表CREATE TABLE score ( id BIGINT AUTO_INCREMENT PRIMARY KEY, student_id BIGINT NOT NULL, course_id BIGINT NOT NULL, term VARCHAR(20) NOT NULL COMMENT 学期如2024-2025-1, exam_type TINYINT NOT NULL COMMENT 1平时 2期中 3期末 4补考, score DECIMAL(5,2) NOT NULL, creator_id BIGINT NOT NULL, audit_status TINYINT DEFAULT 0 COMMENT 0未审核 1已发布, create_time DATETIME DEFAULT CURRENT_TIMESTAMP, update_time DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP, UNIQUE KEY uk_student_course_term (student_id, course_id, term, exam_type) );表里唯一索引保证了同一学生在同一学期同一门课的同一考试类型只能有一条成绩这是防止重复录入的第一道防线。audit_status字段用于控制成绩是否对学生的查询端可见成绩录入后默认为0教务处审核后置为1。DECIMAL(5,2)可以存放0到999.99覆盖百分制及格率等常规场景。对应的JPA实体里用Table和Column注解标明映射关系其中score字段在Java侧用BigDecimal类型接收避免浮点数精度问题。在Repository中声明一个根据学生和课程查成绩的方法public interface ScoreRepository extends JpaRepositoryScore, Long { OptionalScore findByStudentIdAndCourseIdAndTermAndExamType( Long studentId, Long courseId, String term, Integer examType); }方法名的语义由Spring Data JPA自动解析你在service里直接调用即可。如果不想使用JPA这种基于方法命名约定的方式也可以换成MyBatis在XML里写SQL效果等价后面的聚合查询部分会给出MyBatis的写法。关于两者的选择我的建议是涉及大量动态条件组合查询就用MyBatisCRUD为主且字段固定用JPA成绩系统两种特性都有所以混用也是常见的。3. 学生成绩管理系统中的认证授权与成绩CRUD实现3.1 基于Spring Security的角色访问控制成绩管理系统里不同角色能操作的接口完全不同。老师可以录成绩但不能改发布后的成绩教务处可以审核和驳回学生只能查自己的成绩。用Spring Security做这件事核心是定义角色和对应的URL规则。Spring Security 6.x之后原来的WebSecurityConfigurerAdapter被移除现在推荐用SecurityFilterChain的Bean定义Bean public SecurityFilterChain securityFilterChain(HttpSecurity http) throws Exception { http.csrf().disable() .authorizeHttpRequests(auth - auth .requestMatchers(/api/auth/login).permitAll() .requestMatchers(/api/student/**).hasRole(STUDENT) .requestMatchers(/api/teacher/**).hasRole(TEACHER) .requestMatchers(/api/admin/**).hasRole(ADMIN) .anyRequest().authenticated()) .addFilterBefore(jwtAuthenticationFilter, UsernamePasswordAuthenticationFilter.class); return http.build(); }这里用requestMatchers按路径前缀做粗粒度控制controller内部再做细粒度数据权限校验比如学生只能查自己的成绩不能传一个别人的studentId就绕过权限。JWT方案适合前后端分离的教务系统token里携带userId、role和过期时间过滤器解析后放入SecurityContext。三个角色的访问范围可以用一张表说清楚角色可访问路径操作范围STUDENT/api/student/**查询本人成绩和排名TEACHER/api/teacher/**录入、导入、导出所教课程成绩ADMIN/api/admin/**审核发布、修改成绩、管理用户需要注意的是JWT的密钥要放在配置文件的加密占位里不要硬编码在代码中。发布后修改成绩这类高风险操作我一般会在service方法上再叠加PreAuthorize(hasRole(ADMIN) #dto.auditStatus 0)函数级的权限校验配合URL级校验避免接口路径调整后漏掉规则。3.2 成绩录入接口实现与参数校验成绩录入是系统里调用最频繁的接口需要考虑批量录入和单条更新两种场景。下面这段代码演示单条录入核心逻辑放在ScoreService中Service Transactional public class ScoreServiceImpl implements ScoreService { Autowired private ScoreRepository scoreRepository; Override public Long createScore(ScoreCreateDTO dto) { // 同一学生同一考试类型重复录入时直接报错由唯一索引兜底 OptionalScore existed scoreRepository .findByStudentIdAndCourseIdAndTermAndExamType( dto.getStudentId(), dto.getCourseId(), dto.getTerm(), dto.getExamType()); if (existed.isPresent()) { throw new BusinessException(该学生此考试类型成绩已存在); } Score score new Score(); score.setStudentId(dto.getStudentId()); score.setCourseId(dto.getCourseId()); score.setTerm(dto.getTerm()); score.setExamType(dto.getExamType()); score.setScore(dto.getScore()); score.setAuditStatus(0); return scoreRepository.save(score).getId(); } }Transactional保证了保存操作和唯一索引检查在同一个事务里并发下即使两个请求同时进入createScore数据库的唯一索引也会兜底阻止重复插入。dto在这里已经通过了JSR 303参数校验NotBlank校验termNotNull校验studentId和courseIdDecimalMax(100)限制成绩上限避免异常数据进入业务层。进入接口层的参数校验由Validated注解触发PostMapping(/api/teacher/score) public ResultLong create(RequestBody Validated ScoreCreateDTO dto) { return Result.success(scoreService.createScore(dto)); }传入非法的studentId时GlobalExceptionHandler里的MethodArgumentNotValidException处理逻辑会返回统一的错误JSON前端拿到message直接提示。这样service里不需要再写一堆if判断参数是否为空代码可读性高出不少。如果你用的Spring Boot 3.x注意javax.validation要换成jakarta.validationValidated和Valid的使用方式不变。3.3 成绩修改的乐观锁与审计日志成绩发布之后被修改必须留下记录这是教务系统合规的硬要求。我一般会在score表之外再建一张score_audit_log表记录修改前后的分数、操作人、操作时间。修改成绩时用乐观锁防止两个管理员同时更新同一条记录Modifying Query(UPDATE Score s SET s.score :newScore, s.version s.version 1 WHERE s.id :id AND s.version :version) int updateScoreWithVersion(Param(id) Long id, Param(newScore) BigDecimal newScore, Param(version) Integer version);score实体中加一个Version字段后Spring Data JPA执行save时也会自动带上版本判断更新行数为0时说明版本冲突service抛异常让用户重试。这种做法比select for update更轻不需要持有数据库行锁适合并发量不高的成绩录入场景。审计日志的写入放在同一个事务里成绩更新成功则日志一并落库失败则一起回滚。到这里成绩模块的增删改查主链路已经完整。接下来是查询端的问题成绩列表和统计报表才是学生和老师每天打开系统看到的页面查询性能比写入更影响体验。4. 成绩查询与统计分析的SQL和代码落地4.1 多条件组合查询的MyBatis动态SQL成绩列表页最常见的过滤条件是学期、班级、课程、考试类型、关键字。用MyBatis动态SQL写这个接口非常自然因为每个过滤条件都可选select idpageScores resultTypeScoreVO SELECT s.id, st.name AS studentName, c.name AS courseName, s.score, s.term, s.exam_type, s.audit_status FROM score s JOIN student st ON s.student_id st.id JOIN course c ON s.course_id c.id where if testterm ! null and term ! AND s.term #{term} /if if testclazzId ! null AND st.clazz_id #{clazzId} /if if testcourseId ! null AND s.course_id #{courseId} /if if testexamType ! null AND s.exam_type #{examType} /if if testkeyword ! null and keyword ! AND (st.name LIKE CONCAT(%, #{keyword}, %) OR st.student_no LIKE CONCAT(%, #{keyword}, %)) /if /where ORDER BY s.create_time DESC /select标签会自动去掉第一个多余AND未传的字段直接跳过。分页用PageHelper插件一行PageHelper.startPage(pageNum, pageSize)就能在查询前自动拼接limit。需要注意的是LIKE查询在数据量上来之后会走全表扫描student表超过十万行时建议对student_no建普通索引name字段做前缀索引。课设和中小型学校场景下MySQL加索引就够了。4.2 班级课程均分、及格率的聚合查询统计报表比列表查询更常见。教务处要一份每个班级每门课的平均分、最高分、最低分、及格率这用MyBatis或JPA都能做SQL写起来几乎一样select idsummarizeByClazzAndCourse resultTypeScoreStatsVO SELECT st.clazz_id AS clazzId, s.course_id AS courseId, COUNT(*) AS totalCount, ROUND(AVG(s.score), 2) AS avgScore, MAX(s.score) AS maxScore, MIN(s.score) AS minScore, ROUND(SUM(CASE WHEN s.score 60 THEN 1 ELSE 0 END) / COUNT(*) * 100, 2) AS passRate FROM score s JOIN student st ON s.student_id st.id WHERE s.term #{term} AND s.exam_type 3 GROUP BY st.clazz_id, s.course_id ORDER BY st.clazz_id, s.course_id /selectGROUP BY后面只放clazz_id和course_id两个维度选择列也必须是这两个维度或其聚合结果否则MySQL开了only_full_group_by之后会直接报错。ROUND保留两位小数CASE WHEN里判断及格线。这里将考试类型限定为期末加在WHERE里能在分组前过滤掉平时分对统计的干扰。4.3 排名的窗口函数写法与VO裁剪除了均分和及格率班级排名也是家长高频查询的功能。MySQL 8.0支持窗口函数用RANK()做排名比在Java里排序再分页更优雅SELECT student_id, score, RANK() OVER (PARTITION BY course_id ORDER BY score DESC) AS rank_no FROM score WHERE term #{term} AND exam_type 3PARTITION BY course_id表示按课程分组排名ORDER BY score DESC决定排名依据。RANK()遇到并列分数会跳号比如两个并列第一下一个是第三名需要连续排名就换成DENSE_RANK()。成绩排名接口返回的ScoreStatsVO不需要字段全量暴露把studentId、score、rankNo、totalCount四个字段组装成VO返回前端拿这个结构画榜单就够。聚合查询返回的是VO不要直接复用Score实体因为Score里没有clazzId和passRate这些字段。MyBatis的resultType映射依赖列别名或开启驼峰转换如果没有开启需要在application.yml里加一行mybatis: configuration: map-underscore-to-camel-case: true这个配置开启后数据库的clazz_id会自动映射到VO里的clazzId省去每个查询都写resultMap的麻烦。开启前确保表字段命名统一为下划线风格Java字段用驼峰风格团队规范里明确这两条能省掉后面大量隐患。5. 学生成绩管理系统的Excel导入导出与文件处理5.1 批量导入的MultipartFile上传接口学校期末时老师手里仍然是一份Excel表系统里批量导入是不可缺的功能。批量导入的口径按课程和考试类型展开Excel里一行是一个学生的成绩。接口接收MultipartFile先校验文件扩展名和大小再交给EasyExcel逐行解析PostMapping(/api/teacher/score/import) public ResultString importScores(RequestParam(file) MultipartFile file, RequestParam Long courseId, RequestParam String term, RequestParam Integer examType) { if (file.isEmpty()) { throw new BusinessException(上传文件为空); } String filename file.getOriginalFilename(); if (!filename.endsWith(.xlsx) !filename.endsWith(.xls)) { throw new BusinessException(仅支持Excel文件); } if (file.getSize() 10 * 1024 * 1024) { throw new BusinessException(文件大小不能超过10MB); } // 解析逻辑由EasyExcel完成doReadSync同步读取小文件 ListScoreImportRow rows EasyExcel.read(file.getInputStream()) .head(ScoreImportRow.class) .sheet() .doReadSync(); // 逐行校验和落库省略 return Result.success(导入成功); }文件大小限制在Web层做一次Nginx或网关层也要配client_max_body_size保持一致否则请求会在网关层被直接拒绝应用层根本收不到文件。EasyExcel用doReadSync同步读取适合小文件批量导入超过一千行时建议改成监听器异步读取配合线程池把解析和落库解耦。服务端要有临时目录存储上传文件Spring Boot默认的spring.servlet.multipart.max-file-size是1MB最大请求大小为10MB需要按业务调整。5.2 导出全校成绩时的流式Excel写入导出场景比导入更需要注意内存。很多人直接用EasyExcel的write方法一条条往Workbook里塞几千行没问题但一旦导出全校成绩汇总行数可能到几万堆内存直接被撑爆。常用做法是流式写String fileName 成绩汇总.xlsx; response.setContentType(application/vnd.openxmlformats-officedocument.spreadsheetml.sheet); response.setCharacterEncoding(utf-8); response.setHeader(Content-disposition, attachment;filename URLEncoder.encode(fileName, UTF-8)); ExcelWriter writer EasyExcel.write(response.getOutputStream(), ScoreExportVO.class).build(); WriteSheet sheet EasyExcel.writerSheet(成绩).build(); // 分批从数据库查询避免一次性加载全部数据 for (int page 1; page totalPage; page) { ListScoreExportVO pageData scoreService.pageForExport(page, 500); writer.write(pageData, sheet); } writer.finish();每次只从数据库查出500行写入Excel内存占用固定在一个很小范围。response header里的Content-disposition用于告诉浏览器这是附件下载而不是HTML页面文件名做了URL编码防止中文乱码。导出大数据量时数据库查询也要带上索引不要对score表做全表扫描否则慢SQL比内存问题先到。5.3 导入失败的错误行回显设计导入Excel最麻烦的是坏数据比如某一行的学号在student表里不存在或者分数超过100。逐行校验时把错误行号、学号、错误原因收集起来导入结束后以错误报告的形式返回给前端{ successCount: 198, failedCount: 2, errors: [ { row: 15, studentNo: 20230102, reason: 学号不存在 }, { row: 32, studentNo: 20230217, reason: 分数不能大于100 } ] }前端收到这个结构后可以把错误行在表格里标红老师按行修改后重新上传。这个信息差处理方式比导入时直接中断整个文件要好用得多用户能直观看到哪行需要修。批量校验的逻辑写在service里和数据库交互统一走Repository不要在校验循环里多次查询数据库先把studentId集合一次性查出来放Map再逐行匹配能省下大量IO。6. Spring Boot Actuator监控与成绩系统的部署避坑6.1 Actuator最小化暴露与防未授权访问Actuator是Spring Boot自带的监控组件但默认暴露端点时非常危险历史上出现过未授权访问/env或/heapdump泄露配置和内存数据的问题。成绩管理系统里只保留健康检查和基础指标两个端点management: endpoints: web: exposure: include: health,metrics,info endpoint: health: show-details: always这段配置把暴露范围限制在health、metrics、info三个端点。health的show-details设为always后可以查看数据库连接、磁盘空间、Redis等组件状态方便排障。注意生产环境必须在Spring Security里对这些端点加IP白名单或认证否则外网直接访问/actuator/health虽然只是状态信息但/actuator/metrics会泄露接口调用次数等运行细节。6.2 健康检查接入告警的验证方法把health端点接到告警平台前先手动验证一遍返回体是否满足预期curl http://localhost:8080/actuator/health | jq返回的status为UP且各个组件的details里没有DOWN项再接入定时探测。如果数据库连接池被耗尽health的db组件会切到DOWN此时需要回查慢SQL和连接池配置。spring.datasource.hikari.maximum-pool-size默认是10并发大的成绩查询场景可以适当调到20但同步上调连接池意味着数据库端max_connections也要留出余量不然应用层不报错数据库先拒绝连接。6.3 启动参数、时区与日志保留策略生产部署时的JVM参数、日志保留策略、时区设置直接影响系统稳定性。我通常这样启动jarjava -Xms512m -Xmx1024m -Duser.timezoneAsia/Shanghai -jar score-system.jar-Xms和-Xmx直接决定堆内存大小成绩系统如果包含大量导出功能建议堆空间至少预留1G。Duser.timezone不设置的话MySQL的连接时区和JVM时区不一致DATETIME字段查询结果会差8小时这是最容易踩的坑。日志方面在logback配置里对score.log保留30天避免导出功能打出的日志占满磁盘频繁触发的GC反而拖垮接口响应。本文还有配套的精品资源点击获取