尧图网页设计 
简介一份基于SpringBoot的学生成绩管理系统设计与实现文档面向计算机专业毕业设计学生、JavaWeb开发学习者及教务管理人员。文档完整梳理了系统开发全流程涵盖绪论、可行性分析、需求分析、概要设计、数据库概念与表结构设计以及管理员、教师、学生三端功能的具体实现并包含注册登录等核心模块的单元测试与集成测试说明可作为毕业设计论文撰写范式或项目参考。资源仅含1个docx文件体积1.14MB内容紧凑便于阅读与二次编辑。该资源已有8554人学习下载适合需要快速理解SpringBoot、MySQL与JavaWeb技术整合思路并完成成绩管理系统设计文档写作的读者。1. 为什么是 SpringBoot学生成绩管理系统技术栈取舍与受众定位每到毕业季学生成绩管理系统都是 Java 方向出现频率最高的选题之一。教务处的 Excel 表越攒越多平时分、期末分、补考成绩散落在不同的表格里老师要按班级导出排名学生要查自己挂没挂科——这套看似简单的 CRUD实际做起来要同时处理数据建模、权限控制和统计导出。用 SpringBoot 来做这类系统核心优势不在框架本身而在它内置了 Tomcat、自动装配和大量起步依赖让你把一个完整 Web 项目从零跑起来的时间压缩到一两天。适合这个选题的主要是两类人第一类是 Java 基础一般、但需要独立完成毕设或课程设计的本科生SpringBoot 帮你省掉了 Spring MVC 里繁琐的 XML 配置写接口的路径变得非常短第二类是给小型培训机构、中学教务做外包开发的从业者需要快速交付一个可演示、可部署的版本。网上关于 SpringBoot 的学生管理系统教程虽多但多数只贴代码不解释取舍照着敲完仍然答不上答辩老师的问题。这篇文章就从项目设计讲到代码落地再讲到容易翻车的位置帮你把这个题目做扎实。2. 从用例图到数据模型成绩管理系统的模块划分与 ER 设计2.1 角色与用例图教师、学生、管理员三类角色的读改写边界做成绩管理系统第一步不是建工程而是把用例图画清楚。学生成绩管理系统的核心需求可以从三个角色的视角拆开管理员负责基础数据维护比如班级、教师账号、课程信息教师负责成绩业务包括录入成绩、修改成绩、按班级查看统计和导出清单学生只读查自己的成绩、排名和学分情况。很多同学一上来就把“成绩管理”想成一个功能实际上它至少包含录入、修改、审核、查询、统计五类子功能角色不同能触碰的数据范围完全不一样。用例图画的时候我一般会在成绩用例下面拆出两个子用例录入成绩和成绩复核。录入指首次把平时分、期末分输入系统复核指成绩有误时走修改流程。这两个用例看起来相似但在数据建模上会决定你是否需要一个“成绩审核状态”。如果只是课设或小型教务系统可以不做审核流直接允许教师修改成绩用一个 update_time 字段留痕但如果论文里写了“成绩准确性保障”就最好在成绩表里加一个 status 字段0 表示暂存、1 表示已提交未提交的成绩对学生不可见。用例图还要明确一个边界管理员不直接改成绩。这是答辩时经常被追问的点。管理员维护的是课程和学生的基础档案成绩的写操作只属于任课教师否则会出现老师录入成绩后管理员误改数据查不出责任的问题。权限控制的代码实现会在第 5 章展开这里先把用例边界定住后面建表和写接口才不会乱。2.2 数据表设计学生、课程、成绩三张表是关键选课表怎么省略学生成绩管理系统的表可以拆得很多但核心只有三张student学生表、course课程表、score成绩表。学生表存学号、姓名、班级、入学年份课程表存课程号、课程名、学分、开课学期成绩表存学号、课程号、分数、总评成绩、成绩状态。很多教材会把选课表student_course再单独建一张但考虑到这套系统的核心诉求是“出成绩”而不是“管理选课”我一般建议把选课关系直接合并到成绩表里成绩表插入一条记录就代表该学生选了这门课。三张表里成绩表是最容易设计错的。常见问题是没有唯一约束导致同一学生同一门课程被录入两次统计平均分时数据重复。解决办法是在建表时给成绩表加联合唯一索引索引指向 student_id 和 course_id再考虑到一个学生可能补考同一门课最好把 semester 字段也加进唯一索引。如果系统要支持多次补考那就要引入“考试批次”的概念而不是简单地把第二次成绩覆盖掉第一次。另一个常被忽视的是物理外键。课设论文里放 ER 图时画上连线很美观但实际建表我建议不要加物理外键约束外键带来的插入校验在成绩批量导入时会拖慢速度删课程时还有可能被成绩表挡住。用逻辑外键也就是普通索引加上应用层校验足够撑起一个成绩管理系统的体量。2.3 字段类型与约束清单decimal、smallint、唯一索引的参数怎么定成绩相关的字段类型选择有一个最常见的翻车点把分数存成 int。期末成绩允许一位小数时int 会直接把小数截掉录入 89.5 分变成 89 分。成绩字段应该用 decimal精度按需求定义成 decimal(5,2)意思是最大 3 位整数加 2 位小数足够存 100 分或 150 分制的成绩。总评成绩和平时分同理如果采用百分制建议统一用 decimal(5,2)避免不同字段精度不一致导致 Java 端 BigDecimal 比较时出问题。表名字段类型约束说明studentidbigint主键自增或直接用学号studentstudent_novarchar(20)唯一索引学号不允许重复studentnamevarchar(50)非空普通索引便于按名查courseidbigint主键自增coursecourse_novarchar(20)唯一索引课程号scoreidbigint主键自增scorestudent_idbigint普通索引关联学生表scorecourse_idbigint普通索引关联课程表scoresemestervarchar(20)如 2024-2025-1scoreregular_scoredecimal(5,2)平时分允许 nullscoreexam_scoredecimal(5,2)期末卷面分scoretotal_scoredecimal(5,2)总评可由程序计算scorestatustinyint0 暂存1 已提交当你看到这里建表的原则基本就清楚了。所有时间字段统一用 datetime不区分 date 和 timestamp减少不同类型带来的比较麻烦状态字段用 tinyint 而不是 varchar 存“已提交”三个字因为字符串在索引和 Java 枚举映射上都没有整数方便。唯一索引的作用我们会在第 4 章批量录入时看到它的威力——它不只是防重复还能配合 INSERT IGNORE 或 ON DUPLICATE KEY UPDATE 做幂等写入这是成绩导入功能能扛住几千行数据的关键。3. 搭建工程并落地核心接口SpringBoot MyBatis 的最小实现3.1 项目结构与起步依赖一个能跑起来的 pom.xml 长什么样确定好表结构接下来搭建工程。先说结论学习阶段的 SpringBoot 项目结构我喜欢分成 controller、service、mapper、entity、dto、config 六个包不要分太多层也不要搞一个 common 包把什么都往里塞。成绩管理系统这种体量分层多了是负担答辩问起来反而容易露怯。用 IDEA 新建 Spring Initializr 项目时依赖选择上我建议只勾 Spring Web其他都不要在创建时勾MyBatis、MySQL 驱动和 Lombok 后面手工加进 pom.xml这样你能看清每个依赖是干什么的。最小可用的一套依赖组合如下parent groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-parent/artifactId version2.7.18/version relativePath/ /parent dependencies dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-web/artifactId /dependency dependency groupIdorg.mybatis.spring.boot/groupId artifactIdmybatis-spring-boot-starter/artifactId version2.3.2/version /dependency dependency groupIdmysql/groupId artifactIdmysql-connector-java/artifactId scoperuntime/scope /dependency dependency groupIdorg.projectlombok/groupId artifactIdlombok/artifactId optionaltrue/optional /dependency /dependencies这段配置里最关键的是 SpringBoot 父工程管理版本号spring-boot-starter-web 会自动拉起 Tomcat 和 Spring MVCmybatis-spring-boot-starter 则由 MyBatis 官方提供自动装配不需要你再写 SqlSessionFactory 的 XML。版本选择上注意两点SpringBoot 2.7.x 配合 JDK 8 或 11 比较稳如果机器上装的是 JDK 17 就想办法用后面 3.x 分支依赖里不要随便写 latest 或具体高版本号我有一次把 MyBatis starter 从 2.3.2 升级到 2.3.x 却发现兼容 SpringBoot 2.7 没问题但换成 3.x 后项目直接起不来。3.2 配置文件与数据源application.yml 里的关键参数依赖就位后在 src/main/resources 下新建 application.yml代替默认的 application.properties。相比 propertiesyml 的层级缩进更直观写多数据源或嵌套配置时不至于一大串前缀。下面是一个成绩管理系统最小可用的配置server: port: 8080 spring: datasource: driver-class-name: com.mysql.cj.jdbc.Driver url: jdbc:mysql://localhost:3306/grade_db?useUnicodetruecharacterEncodingutf8useSSLfalseserverTimezoneAsia/Shanghai username: root password: root mybatis: mapper-locations: classpath:mapper/*.xml type-aliases-package: com.example.grade.entity configuration: map-underscore-to-camel-case: true log-impl: org.apache.ibatis.logging.stdout.StdOutImpl logging: level: com.example.grade.mapper: debug注意 url 里必须带serverTimezoneAsia/ShanghaiMySQL 8 的驱动默认要求时区缺了这个会直接报连接超时useSSLfalse 是给本地开发用的别在生产环境照抄。map-underscore-to-camel-case 开启后数据库里的 student_no 能自动映射到 Java 类的 studentNo不然你每个实体类都要配 ResultMap接口量一多就很痛苦。log-impl 配合 logging.level 调试 Mapper 时能看到完整的 SQL 日志。3.3 从 Controller 到 Mapper成绩录入接口的最小链路配置完成开始写第一个接口把一条成绩插入数据库。这里我用“新增成绩”作为例子从 Controller 一路写到 Mapper XML目标是让你看清 SpringBoot MyBatis 的调用链。先看实体类Data public class Score { private Long id; private Long studentId; private Long courseId; private String semester; private BigDecimal regularScore; private BigDecimal examScore; private BigDecimal totalScore; private Integer status; }Data 是 Lombok 提供的注解自动生成 getter/setter。如果你不想引入 Lombok手写这些方法也可以但项目字段一多会变得很臃肿答辩时解释 Lombok 的原理也容易。紧接着是 Controller 层RestController RequestMapping(/api/score) public class ScoreController { Resource private ScoreService scoreService; PostMapping(/add) public Result add(RequestBody Validated ScoreAddDTO dto) { scoreService.addScore(dto); return Result.success(); } }RestController 表示这个类所有方法的返回值直接写进响应体。RequestBody 接收前端传来的 JSON参数校验交给 Validated在 DTO 字段上加 NotNull 或 DecimalMax 就能拦截非法输入。这里把 Controller 写薄是有意为之所有业务逻辑都放 Service答辩时讲 MVC 分层结构更有说服力。Service 层负责业务逻辑这里只演示最简插入第 4 章会加入总评计算和事务处理Service public class ScoreServiceImpl implements ScoreService { Resource private ScoreMapper scoreMapper; Override public void addScore(ScoreAddDTO dto) { Score score new Score(); score.setStudentId(dto.getStudentId()); score.setCourseId(dto.getCourseId()); score.setSemester(dto.getSemester()); score.setRegularScore(dto.getRegularScore()); score.setExamScore(dto.getExamScore()); score.setStatus(0); scoreMapper.insert(score); } }Mapper 接口和 XML 对应如下。接口只定义方法SQL 写在 mapper 目录下的 XML 里public interface ScoreMapper { int insert(Score score); }insert idinsert parameterTypecom.example.grade.entity.Score INSERT INTO score ( student_id, course_id, semester, regular_score, exam_score, total_score, status ) VALUES ( #{studentId}, #{courseId}, #{semester}, #{regularScore}, #{examScore}, #{totalScore}, #{status} ) /insertXML 里的#{studentId}对应 Score 实体类里的属性名开启驼峰映射后 MyBatis 会自动把实体属性转换为下划线字段这里故意没传 totalScore它会在业务层计算后再 set 进对象。parameterType 在 MyBatis 3 里其实可以省略写上是为了让小白看清楚参数类型代码审查时也更直观。3.4 把一个接口跑起来IDEA 里启动与 Postman 验证代码写完运行主类上的 main 方法SpringBoot 会启动内置 Tomcat。控制台出现Started Application in x.xxx seconds就说明启动成功注意这时如果连不上数据库会出现红色错误栈先回去看 yml 里的用户名密码。启动后在 IDEA 里按两下 Shift 搜索并打开 HTTP Client或者直接用 Postman 测试。curl -X POST http://localhost:8080/api/score/add \ -H Content-Type: application/json \ -d {studentId:1,courseId:1,semester:2024-2025-1,regularScore:88.5,examScore:92.0}用 curl 或 Postman 发送这段 JSON返回 Result.success 后去数据库里查询看到 student_id 为 1 的记录插入成功。到这里你已经跑通一条完整的接口链路。SpringBoot 自动装配原理会在这里第一次被看到你写了一个接口没有任何配置 Tomcat 的代码但它能对外服务原因是 spring-boot-starter-web 里的 SpringApplication.run 方法背后完成了自动装配这也是答辩时的高频考点把这句话理解透就够了。4. 分数计算、统计查询与批量保存的坑成绩逻辑与事务边界4.1 平时分期末分怎么算总评计算放数据库还是放 Java成绩录入只是开始真正让系统有说服力的是总评计算。最常见的规则是总评 平时分 × 30% 期末分 × 70%但这套规则在不同课程里可能完全不一样——有的课只算期末分有的课程期中占 20%。设计系统时千万不要把比例写死在 Java 代码里不然每学期换一次规则都要重新发版。我一般会把评分规则抽到 course 表里字段就是 regular_ratio默认 0.3。总评计算放在 Service 层用一个方法统一处理。这样做的好处是规则在界面上展示时比较直观答辩老师看到你的比例可配置会认为你有“系统演进”的考虑public BigDecimal calculateTotal(Score score, BigDecimal regularRatio) { BigDecimal regular score.getRegularScore() null ? BigDecimal.ZERO : score.getRegularScore(); BigDecimal exam score.getExamScore() null ? BigDecimal.ZERO : score.getExamScore(); BigDecimal total regular.multiply(regularRatio) .add(exam.multiply(BigDecimal.ONE.subtract(regularRatio))); return total.setScale(2, RoundingMode.HALF_UP); }这段代码里的乘法和加法都用了 BigDecimal 的方法而不是用*和。用 SQL 在数据库里算总评看起来更省事但总评规则会散落在多个查询语句里改起来容易漏。Java 里算也有代价如果成绩表有几万条逐条读出再算会慢这个体量在成绩管理系统里不算问题所以优先保证规则维护性。这里保留两位小数用 HALF_UP 四舍五入而不是直接截断避免出现 89.45 分显示成 89.4 的尴尬。4.2 批量录入防止半成功Transactional 的正确打开方式老师录成绩从来不是一条一条插而是拿着 Excel 表格一次性导入几十上百条。这种情况下如果循环 insert 中间有一条失败前面成功的那些就会残留在表里学生看到的成绩一半有一半没有。解决这个问题靠事务注解Transactional(rollbackFor Exception.class) Override public void batchAdd(ListScoreAddDTO dtoList) { for (ScoreAddDTO dto : dtoList) { addScore(dto); } }Transactional 的 rollbackFor 必须写成 Exception.class默认情况下 Spring 事务只对 RuntimeException 回滚如果 insert 抛了一个受检异常事务不会回滚数据照样半成功。批量导入的另一个坑是数据量大时事务时间太长几百条没问题上万条就会拖慢数据库这时候应该用批量 insert 而不是循环单条 insert。MyBatis 里可以用 foreach 拼成一条多值 INSERTinsert idbatchInsert INSERT INTO score ( student_id, course_id, semester, regular_score, exam_score, total_score, status ) VALUES foreach collectionlist itemitem separator, (#{item.studentId}, #{item.courseId}, #{item.semester}, #{item.regularScore}, #{item.examScore}, #{item.totalScore}, 0) /foreach /insertforeach 里 separator, 会把每条记录的值组拼起来最后形成一条 INSERT 带多组 VALUESMySQL 对这种写法优化得比较好。注意 MySQL 默认有 max_allowed_packet 限制一次插入太大会报错一般一个批次控制在 500 条以内。配合唯一索引重复请求同一份数据时会直接报 DuplicateKeyException你在 Service 里 catch 后可以提示“第几行的数据重复”比逐条先查后插效率高得多。4.3 挂科率、平均分统计一张临时表还是实时 count成绩录进去以后下一个高频需求是统计。最常见的是这三类班级平均分、课程及格率、学生排名。很多同学一拿到需求就新建一张统计表每天用定时任务去刷这在小体量的成绩管理系统里完全没必要。几十门课几千条成绩的记录实时聚合一点压力都没有多一张统计表反而要多维护数据的同步逻辑。SELECT c.course_name, COUNT(*) AS total_count, SUM(CASE WHEN s.total_score 60 THEN 1 ELSE 0 END) AS pass_count, ROUND(AVG(s.total_score), 2) AS avg_score FROM score s JOIN course c ON s.course_id c.id WHERE s.semester #{semester} GROUP BY c.id, c.course_name;这个 SQL 用 SUM CASE WHEN 实现了条件计数不用先查出全部记录再在 Java 里循环判断。AVG 函数直接算平均分配合 ROUND 保留两位。如果是按班级统计就再加一个 JOIN 到 student 表然后 GROUP BY s.studentNo 的前几位或者班级字段。要提醒的是GROUP BY 之后出现在 SELECT 里的非聚合列必须也在 GROUP BY 里否则 MySQL 5.7 之后会直接报错这是很多新手在统计接口上翻车的第一原因。排名统计则利用窗口函数 ROW_NUMBER 或 RANK 实现MySQL 8.0 以上都支持。如果你用的是 5.7窗口函数用不了就只能把排名放到 Java 里按 totalScore 排序后循环打上序号。做课设时先确认数据库版本再选方案这也是答辩前必须知道的边界。4.4 跨浏览器导出 Excel 与打印排版的兼容性边界成绩管理系统的最后一个硬需求是导出。老师要把班级成绩导出成 Excel 发给教务处或者打印成绩单存档案。这里我推荐用 EasyExcel 做导出而不是 POI 手写EasyExcel 对 poi 做了封装写出一个带表头的 .xlsx 只需要几十行代码。真正容易出问题的地方在文件名编码和响应头GetMapping(/export) public void export(HttpServletResponse response) throws IOException { response.setContentType(application/vnd.openxmlformats-officedocument.spreadsheetml.sheet); String fileName URLEncoder.encode(2024-2025-1期末成绩.xlsx, UTF-8); response.setHeader(Content-Disposition, attachment; filename\ fileName \); ListScoreExcelVO data scoreMapper.selectForExport(); EasyExcel.write(response.getOutputStream(), ScoreExcelVO.class) .sheet(成绩表) .doWrite(data); }Content-Disposition 里的文件名一定要 URLEncoder 编码否则在 Chrome 正常、在你 Windows 上用 Edge 打开时文件名直接乱码这就是一种很典型的跨浏览器兼容问题。另外 Excel 里如果学号是 18 位长数字导出到 Excel 后会被自动转成科学计数法显示成 1.23E17。解决办法是在 EasyExcel 对应的导出 VO 字段上加一个注解或者把学号类字段先拼一个制表符再输出。Word、WPS 打开同一份 xlsx 的时候对小数位和单元格格式的解析略有差异我在导出时统一在总评列上写死保留两位小数别让格式跟着 Excel 自动识别跑。5. 登录鉴权与接口防刷的踩坑排查从 Session 到 JWT 的三种权限方案5.1 用 Spring Security 还是自己写拦截器课设系统的取舍学生成绩管理系统必须做登录但不能不做角色区分普通学生能查自己的成绩绝不能顺手调一下接口就把全班的成绩拉出来。权限方案上有两条路一是引入 Spring Security 全家桶过滤链加注解权限控制二是用拦截器 登录标记自己实现。Spring Security 功能完善但配置复杂登录页、密码加密、CSRF 默认全开着新手一旦没配好接口被 403 挡得一头雾水。我的建议是如果目标是快速完成课设且答辩能讲清楚原理自己写 HandlerInterceptor 加一个 JWT 或者 Session 工具类就够。SpringBoot 的拦截器注册只有一个实现 WebMvcConfigurer 的配置类配好了比背 Spring Security 的过滤链容易得多。如果论文里想写“基于 Spring Security 的安全控制”那就要做好心理准备最新版本安全配置改动很大网上搜出来的配置可能在新版本上直接失效You 可以把 Security 只用来做密码加密其他权限逻辑仍然走拦截器这样既用了安全框架又不会被它绑架。5.2 拦截器放行名单漏配导致的白屏现象 → 原因 → 解决现象登录页能从浏览器打开输入账号密码调登录接口也正常但登录成功后跳转到首页页面一片白打开浏览器开发者工具看到一堆 404。原因登录接口走的是/api/user/login你把它加进了白名单但静态资源比如前端 Vue 打包后的 js、css 文件和你自己写的返回首页数据的/api/student/list都没有白名单。拦截器把所有未登录请求都拦下来返回 401前端拿到 401 之后的跳转逻辑没做处理就表现成白屏。解决在 WebMvcConfigurer 里把静态资源和不需要鉴权的接口都登记进去。生产环境里前端页面和 SpringBoot 打成一个 jar 包时尤其要注意Vue 打包后的 index.html 和 static 目录会出现在 classpath 下拦截器默认拦 / 下的所有路径此时用排除方式配置白名单Override public void addInterceptors(InterceptorRegistry registry) { registry.addInterceptor(new LoginInterceptor()) .addPathPatterns(/**) .excludePathPatterns( /api/user/login, /, /index.html, /static/**, /assets/**, /error ); }excludePathPatterns 的路径写法要和实际请求匹配。Vue 打包放入 SpringBoot 的常见做法是修改前端打包配置把资源路径从绝对路径改成相对路径再把 dist 目录复制到 src/main/resources/static 下这样 SpringBoot 启动后直接访问 8080 根路径就能看到页面。我因为这个白名单漏配曾经浪费过一个下午最后一路排除到只留 /api 下面的接口要鉴权才恢复正常。这里给出的习惯是先放行所有请求跑通功能再加拦截器逐步缩小范围别逆着来。5.3 RequestBody 接收不到前端参数Content-Type 与字段名不一致现象前端 Vue 用 axios 发请求后端 Controller 里用 RequestBody 接收 DTO结果接口被调用后 DTO 所有字段都是 null数据库插进去一行全空的数据。原因两个可能。第一axios 默认的 Content-Type 是 application/x-www-form-urlencoded而后端 RequestBody 期望的是 application/json参数格式对不上SpringBoot 把表单格式按 JSON 解析解析出来一个空对象。第二前端传的是student_id而下划线后端 DTO 字段是studentId驼峰Fastjson 或 Jackson 默认不会自动把下划线映射成驼峰。解决前端请求库统一在创建实例时设置 headeraxios.defaults.headers[Content-Type] application/json;后端如果要用下划线风格的参数可以在 Jackson 配置里开启SNAKE_CASE策略但更推荐的做法是保持前后端都用驼峰字段名。为了排查这类问题我习惯在登录接口加一行日志打印 DTO.toString()后端能看到实际接收到的 JSON前端也能从 Network 面板看到请求体两端一对比就知道是传参问题还是接收问题。5.4 跨域拦截到 OPTIONS 请求导致的 401浏览器预检请求处理现象前端单独跑在 localhost:3000后端跑在 localhost:8080前端请求后端接口时浏览器控制台报 CORS 错误后端日志里能看到 OPTIONS 请求被拦截器拦下返回 401。原因跨源资源共享机制里浏览器在发送真正的 POST 请求之前会先发一个 OPTIONS 预检请求。这个请求不带业务数据也没有我们自定义的 token 头但拦截器不认识它直接把它当成未登录请求拦掉了。前端看到的所谓跨域报错实际上是浏览器收到了 401 后阻止了后续请求而不是 SpringBoot 没配跨域。解决在拦截器里直接放行 OPTIONS 方法同时给项目加一个跨域配置类public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) { if (OPTIONS.equalsIgnoreCase(request.getMethod())) { return true; } // 其余鉴权逻辑 }跨域配置用 WebMvcConfigurer 里重写 addCorsMappings 即可allowedOriginPatterns 不要写成*因为如果后面用了携带 Cookie 的鉴权方式*会被浏览器拒绝。allowedOriginPatterns 允许你写具体的域名或端口模式星号和带凭据的请求不冲突这是与 allowedOrigins 的一个关键区别。5.5 密码明文入库与弱口令至少做一次 Hash 和复杂度校验现象数据库 user 表里密码字段存了 123456、admin888 这种明文登录接口把用户输入的密码原样拿去和数据库比对。一旦数据库泄露所有账号直接暴露答辩老师问到安全性时也很难给出合理解释。原因图省事觉得课设系统不会有真实用户。但成绩系统里会存学生的学号、姓名、班级、成绩信息它属于典型的个人信息数据明文密码无论如何都说不过去。解决不引入完整的 Spring Security 也能做密码哈希。常见的做法是用 Spring Security Crypto 里的 BCryptPasswordEncoder它不需要 Spring 管理new 一个就可以用。注意引入的是spring-security-crypto不是整个 Spring SecurityBCryptPasswordEncoder encoder new BCryptPasswordEncoder(); String encoded encoder.encode(rawPassword);判断密码时调用encoder.matches(rawPassword, encoded)不要把 encode 的结果拿去和数据库里的 hash 再比对一次matches 内部会把同一盐值逻辑处理好。BCrypt 的特点是同一次明文每次加密结果不一样因为内部自动加了盐数据库里存的是算法标识加盐加哈希的组合串比 MD5 加固定盐的方式抗彩虹表攻击能力强很多。密码复杂度校验在注册接口里写一个正则即可至少要求八位且包含字母和数字这一条在系统演示和论文安全分析里都能成为加分项。6. 有用的进阶加一个成绩分析看板和自动导出让答辩更稳前面几章已经让你具备一个完整可运行的系统但这只是毕设的及格线。如果想让答辩老师眼前一亮我建议在最后一周加上两个小功能成绩分布统计看板和定时导出报表。成绩分布看板用 ECharts 就能实现后端给一个统计接口返回各分数段的人数前端用柱状图渲染。这个功能本身很简单但它在答辩中的价值非常大因为它是整个系统里唯一有“视觉冲击力”的页面。按键分别统计 90-100、80-89、70-79、60-69、60 以下的人数SQL 和第 4 章的挂科率统计几乎一样只是把 CASE WHEN 的区间拆细一点。演示时从录入成绩到图表更新一气呵成比展示十张 CRUD 表格更有说服力。定时导出报表则能体现你对 SpringBoot 定时任务的理解。在启动类或配置类上加EnableScheduling然后在需要定时执行的方法上加Scheduled(cron 0 0 8 * * ?)意思是每天上午 8 点导出前一天提交的成绩数据到服务器指定目录。这类功能不用做得很完整导出文件放在服务器的 reports 文件夹里即可。答辩时老师问“系统如何减轻教务老师工作量”你直接用这个功能作答比说“查询很方便”有力得多。我给学生的做法还有一个习惯在交付前把整个系统按演示脚本走一遍从管理员登录、创建班级、导入学生到教师登录录入成绩、查看统计再到学生登录查询成绩全程录屏保存。录屏不需要剪辑但能保证现场演示时就算网络断了、前端崩了也能用录像兜底。这套系统最大的坑往往不在代码本身而在跨浏览器打开页面时的样式错位、中文乱码这类环境问题提前把 Chrome、Edge 都测一遍导出文件的文件名在两种浏览器下多看一眼。系统做完以后自己要知道哪些地方是答辩时会被追问的自动装配原理、事务失效场景、成绩统计 SQL 的聚合逻辑每一条都在前面几章的细节里提到了能把这些坑讲清楚才是一个合格的“基于 SpringBoot 的学生成绩管理系统设计与实现”。希望帮到你。本文还有配套的精品资源点击获取 基于SpringBoot的学生成绩管理系统设计与实现全解析
简介一份基于SpringBoot的学生成绩管理系统设计与实现文档面向计算机专业毕业设计学生、JavaWeb开发学习者及教务管理人员。文档完整梳理了系统开发全流程涵盖绪论、可行性分析、需求分析、概要设计、数据库概念与表结构设计以及管理员、教师、学生三端功能的具体实现并包含注册登录等核心模块的单元测试与集成测试说明可作为毕业设计论文撰写范式或项目参考。资源仅含1个docx文件体积1.14MB内容紧凑便于阅读与二次编辑。该资源已有8554人学习下载适合需要快速理解SpringBoot、MySQL与JavaWeb技术整合思路并完成成绩管理系统设计文档写作的读者。1. 为什么是 SpringBoot学生成绩管理系统技术栈取舍与受众定位每到毕业季学生成绩管理系统都是 Java 方向出现频率最高的选题之一。教务处的 Excel 表越攒越多平时分、期末分、补考成绩散落在不同的表格里老师要按班级导出排名学生要查自己挂没挂科——这套看似简单的 CRUD实际做起来要同时处理数据建模、权限控制和统计导出。用 SpringBoot 来做这类系统核心优势不在框架本身而在它内置了 Tomcat、自动装配和大量起步依赖让你把一个完整 Web 项目从零跑起来的时间压缩到一两天。适合这个选题的主要是两类人第一类是 Java 基础一般、但需要独立完成毕设或课程设计的本科生SpringBoot 帮你省掉了 Spring MVC 里繁琐的 XML 配置写接口的路径变得非常短第二类是给小型培训机构、中学教务做外包开发的从业者需要快速交付一个可演示、可部署的版本。网上关于 SpringBoot 的学生管理系统教程虽多但多数只贴代码不解释取舍照着敲完仍然答不上答辩老师的问题。这篇文章就从项目设计讲到代码落地再讲到容易翻车的位置帮你把这个题目做扎实。2. 从用例图到数据模型成绩管理系统的模块划分与 ER 设计2.1 角色与用例图教师、学生、管理员三类角色的读改写边界做成绩管理系统第一步不是建工程而是把用例图画清楚。学生成绩管理系统的核心需求可以从三个角色的视角拆开管理员负责基础数据维护比如班级、教师账号、课程信息教师负责成绩业务包括录入成绩、修改成绩、按班级查看统计和导出清单学生只读查自己的成绩、排名和学分情况。很多同学一上来就把“成绩管理”想成一个功能实际上它至少包含录入、修改、审核、查询、统计五类子功能角色不同能触碰的数据范围完全不一样。用例图画的时候我一般会在成绩用例下面拆出两个子用例录入成绩和成绩复核。录入指首次把平时分、期末分输入系统复核指成绩有误时走修改流程。这两个用例看起来相似但在数据建模上会决定你是否需要一个“成绩审核状态”。如果只是课设或小型教务系统可以不做审核流直接允许教师修改成绩用一个 update_time 字段留痕但如果论文里写了“成绩准确性保障”就最好在成绩表里加一个 status 字段0 表示暂存、1 表示已提交未提交的成绩对学生不可见。用例图还要明确一个边界管理员不直接改成绩。这是答辩时经常被追问的点。管理员维护的是课程和学生的基础档案成绩的写操作只属于任课教师否则会出现老师录入成绩后管理员误改数据查不出责任的问题。权限控制的代码实现会在第 5 章展开这里先把用例边界定住后面建表和写接口才不会乱。2.2 数据表设计学生、课程、成绩三张表是关键选课表怎么省略学生成绩管理系统的表可以拆得很多但核心只有三张student学生表、course课程表、score成绩表。学生表存学号、姓名、班级、入学年份课程表存课程号、课程名、学分、开课学期成绩表存学号、课程号、分数、总评成绩、成绩状态。很多教材会把选课表student_course再单独建一张但考虑到这套系统的核心诉求是“出成绩”而不是“管理选课”我一般建议把选课关系直接合并到成绩表里成绩表插入一条记录就代表该学生选了这门课。三张表里成绩表是最容易设计错的。常见问题是没有唯一约束导致同一学生同一门课程被录入两次统计平均分时数据重复。解决办法是在建表时给成绩表加联合唯一索引索引指向 student_id 和 course_id再考虑到一个学生可能补考同一门课最好把 semester 字段也加进唯一索引。如果系统要支持多次补考那就要引入“考试批次”的概念而不是简单地把第二次成绩覆盖掉第一次。另一个常被忽视的是物理外键。课设论文里放 ER 图时画上连线很美观但实际建表我建议不要加物理外键约束外键带来的插入校验在成绩批量导入时会拖慢速度删课程时还有可能被成绩表挡住。用逻辑外键也就是普通索引加上应用层校验足够撑起一个成绩管理系统的体量。2.3 字段类型与约束清单decimal、smallint、唯一索引的参数怎么定成绩相关的字段类型选择有一个最常见的翻车点把分数存成 int。期末成绩允许一位小数时int 会直接把小数截掉录入 89.5 分变成 89 分。成绩字段应该用 decimal精度按需求定义成 decimal(5,2)意思是最大 3 位整数加 2 位小数足够存 100 分或 150 分制的成绩。总评成绩和平时分同理如果采用百分制建议统一用 decimal(5,2)避免不同字段精度不一致导致 Java 端 BigDecimal 比较时出问题。表名字段类型约束说明studentidbigint主键自增或直接用学号studentstudent_novarchar(20)唯一索引学号不允许重复studentnamevarchar(50)非空普通索引便于按名查courseidbigint主键自增coursecourse_novarchar(20)唯一索引课程号scoreidbigint主键自增scorestudent_idbigint普通索引关联学生表scorecourse_idbigint普通索引关联课程表scoresemestervarchar(20)如 2024-2025-1scoreregular_scoredecimal(5,2)平时分允许 nullscoreexam_scoredecimal(5,2)期末卷面分scoretotal_scoredecimal(5,2)总评可由程序计算scorestatustinyint0 暂存1 已提交当你看到这里建表的原则基本就清楚了。所有时间字段统一用 datetime不区分 date 和 timestamp减少不同类型带来的比较麻烦状态字段用 tinyint 而不是 varchar 存“已提交”三个字因为字符串在索引和 Java 枚举映射上都没有整数方便。唯一索引的作用我们会在第 4 章批量录入时看到它的威力——它不只是防重复还能配合 INSERT IGNORE 或 ON DUPLICATE KEY UPDATE 做幂等写入这是成绩导入功能能扛住几千行数据的关键。3. 搭建工程并落地核心接口SpringBoot MyBatis 的最小实现3.1 项目结构与起步依赖一个能跑起来的 pom.xml 长什么样确定好表结构接下来搭建工程。先说结论学习阶段的 SpringBoot 项目结构我喜欢分成 controller、service、mapper、entity、dto、config 六个包不要分太多层也不要搞一个 common 包把什么都往里塞。成绩管理系统这种体量分层多了是负担答辩问起来反而容易露怯。用 IDEA 新建 Spring Initializr 项目时依赖选择上我建议只勾 Spring Web其他都不要在创建时勾MyBatis、MySQL 驱动和 Lombok 后面手工加进 pom.xml这样你能看清每个依赖是干什么的。最小可用的一套依赖组合如下parent groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-parent/artifactId version2.7.18/version relativePath/ /parent dependencies dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-web/artifactId /dependency dependency groupIdorg.mybatis.spring.boot/groupId artifactIdmybatis-spring-boot-starter/artifactId version2.3.2/version /dependency dependency groupIdmysql/groupId artifactIdmysql-connector-java/artifactId scoperuntime/scope /dependency dependency groupIdorg.projectlombok/groupId artifactIdlombok/artifactId optionaltrue/optional /dependency /dependencies这段配置里最关键的是 SpringBoot 父工程管理版本号spring-boot-starter-web 会自动拉起 Tomcat 和 Spring MVCmybatis-spring-boot-starter 则由 MyBatis 官方提供自动装配不需要你再写 SqlSessionFactory 的 XML。版本选择上注意两点SpringBoot 2.7.x 配合 JDK 8 或 11 比较稳如果机器上装的是 JDK 17 就想办法用后面 3.x 分支依赖里不要随便写 latest 或具体高版本号我有一次把 MyBatis starter 从 2.3.2 升级到 2.3.x 却发现兼容 SpringBoot 2.7 没问题但换成 3.x 后项目直接起不来。3.2 配置文件与数据源application.yml 里的关键参数依赖就位后在 src/main/resources 下新建 application.yml代替默认的 application.properties。相比 propertiesyml 的层级缩进更直观写多数据源或嵌套配置时不至于一大串前缀。下面是一个成绩管理系统最小可用的配置server: port: 8080 spring: datasource: driver-class-name: com.mysql.cj.jdbc.Driver url: jdbc:mysql://localhost:3306/grade_db?useUnicodetruecharacterEncodingutf8useSSLfalseserverTimezoneAsia/Shanghai username: root password: root mybatis: mapper-locations: classpath:mapper/*.xml type-aliases-package: com.example.grade.entity configuration: map-underscore-to-camel-case: true log-impl: org.apache.ibatis.logging.stdout.StdOutImpl logging: level: com.example.grade.mapper: debug注意 url 里必须带serverTimezoneAsia/ShanghaiMySQL 8 的驱动默认要求时区缺了这个会直接报连接超时useSSLfalse 是给本地开发用的别在生产环境照抄。map-underscore-to-camel-case 开启后数据库里的 student_no 能自动映射到 Java 类的 studentNo不然你每个实体类都要配 ResultMap接口量一多就很痛苦。log-impl 配合 logging.level 调试 Mapper 时能看到完整的 SQL 日志。3.3 从 Controller 到 Mapper成绩录入接口的最小链路配置完成开始写第一个接口把一条成绩插入数据库。这里我用“新增成绩”作为例子从 Controller 一路写到 Mapper XML目标是让你看清 SpringBoot MyBatis 的调用链。先看实体类Data public class Score { private Long id; private Long studentId; private Long courseId; private String semester; private BigDecimal regularScore; private BigDecimal examScore; private BigDecimal totalScore; private Integer status; }Data 是 Lombok 提供的注解自动生成 getter/setter。如果你不想引入 Lombok手写这些方法也可以但项目字段一多会变得很臃肿答辩时解释 Lombok 的原理也容易。紧接着是 Controller 层RestController RequestMapping(/api/score) public class ScoreController { Resource private ScoreService scoreService; PostMapping(/add) public Result add(RequestBody Validated ScoreAddDTO dto) { scoreService.addScore(dto); return Result.success(); } }RestController 表示这个类所有方法的返回值直接写进响应体。RequestBody 接收前端传来的 JSON参数校验交给 Validated在 DTO 字段上加 NotNull 或 DecimalMax 就能拦截非法输入。这里把 Controller 写薄是有意为之所有业务逻辑都放 Service答辩时讲 MVC 分层结构更有说服力。Service 层负责业务逻辑这里只演示最简插入第 4 章会加入总评计算和事务处理Service public class ScoreServiceImpl implements ScoreService { Resource private ScoreMapper scoreMapper; Override public void addScore(ScoreAddDTO dto) { Score score new Score(); score.setStudentId(dto.getStudentId()); score.setCourseId(dto.getCourseId()); score.setSemester(dto.getSemester()); score.setRegularScore(dto.getRegularScore()); score.setExamScore(dto.getExamScore()); score.setStatus(0); scoreMapper.insert(score); } }Mapper 接口和 XML 对应如下。接口只定义方法SQL 写在 mapper 目录下的 XML 里public interface ScoreMapper { int insert(Score score); }insert idinsert parameterTypecom.example.grade.entity.Score INSERT INTO score ( student_id, course_id, semester, regular_score, exam_score, total_score, status ) VALUES ( #{studentId}, #{courseId}, #{semester}, #{regularScore}, #{examScore}, #{totalScore}, #{status} ) /insertXML 里的#{studentId}对应 Score 实体类里的属性名开启驼峰映射后 MyBatis 会自动把实体属性转换为下划线字段这里故意没传 totalScore它会在业务层计算后再 set 进对象。parameterType 在 MyBatis 3 里其实可以省略写上是为了让小白看清楚参数类型代码审查时也更直观。3.4 把一个接口跑起来IDEA 里启动与 Postman 验证代码写完运行主类上的 main 方法SpringBoot 会启动内置 Tomcat。控制台出现Started Application in x.xxx seconds就说明启动成功注意这时如果连不上数据库会出现红色错误栈先回去看 yml 里的用户名密码。启动后在 IDEA 里按两下 Shift 搜索并打开 HTTP Client或者直接用 Postman 测试。curl -X POST http://localhost:8080/api/score/add \ -H Content-Type: application/json \ -d {studentId:1,courseId:1,semester:2024-2025-1,regularScore:88.5,examScore:92.0}用 curl 或 Postman 发送这段 JSON返回 Result.success 后去数据库里查询看到 student_id 为 1 的记录插入成功。到这里你已经跑通一条完整的接口链路。SpringBoot 自动装配原理会在这里第一次被看到你写了一个接口没有任何配置 Tomcat 的代码但它能对外服务原因是 spring-boot-starter-web 里的 SpringApplication.run 方法背后完成了自动装配这也是答辩时的高频考点把这句话理解透就够了。4. 分数计算、统计查询与批量保存的坑成绩逻辑与事务边界4.1 平时分期末分怎么算总评计算放数据库还是放 Java成绩录入只是开始真正让系统有说服力的是总评计算。最常见的规则是总评 平时分 × 30% 期末分 × 70%但这套规则在不同课程里可能完全不一样——有的课只算期末分有的课程期中占 20%。设计系统时千万不要把比例写死在 Java 代码里不然每学期换一次规则都要重新发版。我一般会把评分规则抽到 course 表里字段就是 regular_ratio默认 0.3。总评计算放在 Service 层用一个方法统一处理。这样做的好处是规则在界面上展示时比较直观答辩老师看到你的比例可配置会认为你有“系统演进”的考虑public BigDecimal calculateTotal(Score score, BigDecimal regularRatio) { BigDecimal regular score.getRegularScore() null ? BigDecimal.ZERO : score.getRegularScore(); BigDecimal exam score.getExamScore() null ? BigDecimal.ZERO : score.getExamScore(); BigDecimal total regular.multiply(regularRatio) .add(exam.multiply(BigDecimal.ONE.subtract(regularRatio))); return total.setScale(2, RoundingMode.HALF_UP); }这段代码里的乘法和加法都用了 BigDecimal 的方法而不是用*和。用 SQL 在数据库里算总评看起来更省事但总评规则会散落在多个查询语句里改起来容易漏。Java 里算也有代价如果成绩表有几万条逐条读出再算会慢这个体量在成绩管理系统里不算问题所以优先保证规则维护性。这里保留两位小数用 HALF_UP 四舍五入而不是直接截断避免出现 89.45 分显示成 89.4 的尴尬。4.2 批量录入防止半成功Transactional 的正确打开方式老师录成绩从来不是一条一条插而是拿着 Excel 表格一次性导入几十上百条。这种情况下如果循环 insert 中间有一条失败前面成功的那些就会残留在表里学生看到的成绩一半有一半没有。解决这个问题靠事务注解Transactional(rollbackFor Exception.class) Override public void batchAdd(ListScoreAddDTO dtoList) { for (ScoreAddDTO dto : dtoList) { addScore(dto); } }Transactional 的 rollbackFor 必须写成 Exception.class默认情况下 Spring 事务只对 RuntimeException 回滚如果 insert 抛了一个受检异常事务不会回滚数据照样半成功。批量导入的另一个坑是数据量大时事务时间太长几百条没问题上万条就会拖慢数据库这时候应该用批量 insert 而不是循环单条 insert。MyBatis 里可以用 foreach 拼成一条多值 INSERTinsert idbatchInsert INSERT INTO score ( student_id, course_id, semester, regular_score, exam_score, total_score, status ) VALUES foreach collectionlist itemitem separator, (#{item.studentId}, #{item.courseId}, #{item.semester}, #{item.regularScore}, #{item.examScore}, #{item.totalScore}, 0) /foreach /insertforeach 里 separator, 会把每条记录的值组拼起来最后形成一条 INSERT 带多组 VALUESMySQL 对这种写法优化得比较好。注意 MySQL 默认有 max_allowed_packet 限制一次插入太大会报错一般一个批次控制在 500 条以内。配合唯一索引重复请求同一份数据时会直接报 DuplicateKeyException你在 Service 里 catch 后可以提示“第几行的数据重复”比逐条先查后插效率高得多。4.3 挂科率、平均分统计一张临时表还是实时 count成绩录进去以后下一个高频需求是统计。最常见的是这三类班级平均分、课程及格率、学生排名。很多同学一拿到需求就新建一张统计表每天用定时任务去刷这在小体量的成绩管理系统里完全没必要。几十门课几千条成绩的记录实时聚合一点压力都没有多一张统计表反而要多维护数据的同步逻辑。SELECT c.course_name, COUNT(*) AS total_count, SUM(CASE WHEN s.total_score 60 THEN 1 ELSE 0 END) AS pass_count, ROUND(AVG(s.total_score), 2) AS avg_score FROM score s JOIN course c ON s.course_id c.id WHERE s.semester #{semester} GROUP BY c.id, c.course_name;这个 SQL 用 SUM CASE WHEN 实现了条件计数不用先查出全部记录再在 Java 里循环判断。AVG 函数直接算平均分配合 ROUND 保留两位。如果是按班级统计就再加一个 JOIN 到 student 表然后 GROUP BY s.studentNo 的前几位或者班级字段。要提醒的是GROUP BY 之后出现在 SELECT 里的非聚合列必须也在 GROUP BY 里否则 MySQL 5.7 之后会直接报错这是很多新手在统计接口上翻车的第一原因。排名统计则利用窗口函数 ROW_NUMBER 或 RANK 实现MySQL 8.0 以上都支持。如果你用的是 5.7窗口函数用不了就只能把排名放到 Java 里按 totalScore 排序后循环打上序号。做课设时先确认数据库版本再选方案这也是答辩前必须知道的边界。4.4 跨浏览器导出 Excel 与打印排版的兼容性边界成绩管理系统的最后一个硬需求是导出。老师要把班级成绩导出成 Excel 发给教务处或者打印成绩单存档案。这里我推荐用 EasyExcel 做导出而不是 POI 手写EasyExcel 对 poi 做了封装写出一个带表头的 .xlsx 只需要几十行代码。真正容易出问题的地方在文件名编码和响应头GetMapping(/export) public void export(HttpServletResponse response) throws IOException { response.setContentType(application/vnd.openxmlformats-officedocument.spreadsheetml.sheet); String fileName URLEncoder.encode(2024-2025-1期末成绩.xlsx, UTF-8); response.setHeader(Content-Disposition, attachment; filename\ fileName \); ListScoreExcelVO data scoreMapper.selectForExport(); EasyExcel.write(response.getOutputStream(), ScoreExcelVO.class) .sheet(成绩表) .doWrite(data); }Content-Disposition 里的文件名一定要 URLEncoder 编码否则在 Chrome 正常、在你 Windows 上用 Edge 打开时文件名直接乱码这就是一种很典型的跨浏览器兼容问题。另外 Excel 里如果学号是 18 位长数字导出到 Excel 后会被自动转成科学计数法显示成 1.23E17。解决办法是在 EasyExcel 对应的导出 VO 字段上加一个注解或者把学号类字段先拼一个制表符再输出。Word、WPS 打开同一份 xlsx 的时候对小数位和单元格格式的解析略有差异我在导出时统一在总评列上写死保留两位小数别让格式跟着 Excel 自动识别跑。5. 登录鉴权与接口防刷的踩坑排查从 Session 到 JWT 的三种权限方案5.1 用 Spring Security 还是自己写拦截器课设系统的取舍学生成绩管理系统必须做登录但不能不做角色区分普通学生能查自己的成绩绝不能顺手调一下接口就把全班的成绩拉出来。权限方案上有两条路一是引入 Spring Security 全家桶过滤链加注解权限控制二是用拦截器 登录标记自己实现。Spring Security 功能完善但配置复杂登录页、密码加密、CSRF 默认全开着新手一旦没配好接口被 403 挡得一头雾水。我的建议是如果目标是快速完成课设且答辩能讲清楚原理自己写 HandlerInterceptor 加一个 JWT 或者 Session 工具类就够。SpringBoot 的拦截器注册只有一个实现 WebMvcConfigurer 的配置类配好了比背 Spring Security 的过滤链容易得多。如果论文里想写“基于 Spring Security 的安全控制”那就要做好心理准备最新版本安全配置改动很大网上搜出来的配置可能在新版本上直接失效You 可以把 Security 只用来做密码加密其他权限逻辑仍然走拦截器这样既用了安全框架又不会被它绑架。5.2 拦截器放行名单漏配导致的白屏现象 → 原因 → 解决现象登录页能从浏览器打开输入账号密码调登录接口也正常但登录成功后跳转到首页页面一片白打开浏览器开发者工具看到一堆 404。原因登录接口走的是/api/user/login你把它加进了白名单但静态资源比如前端 Vue 打包后的 js、css 文件和你自己写的返回首页数据的/api/student/list都没有白名单。拦截器把所有未登录请求都拦下来返回 401前端拿到 401 之后的跳转逻辑没做处理就表现成白屏。解决在 WebMvcConfigurer 里把静态资源和不需要鉴权的接口都登记进去。生产环境里前端页面和 SpringBoot 打成一个 jar 包时尤其要注意Vue 打包后的 index.html 和 static 目录会出现在 classpath 下拦截器默认拦 / 下的所有路径此时用排除方式配置白名单Override public void addInterceptors(InterceptorRegistry registry) { registry.addInterceptor(new LoginInterceptor()) .addPathPatterns(/**) .excludePathPatterns( /api/user/login, /, /index.html, /static/**, /assets/**, /error ); }excludePathPatterns 的路径写法要和实际请求匹配。Vue 打包放入 SpringBoot 的常见做法是修改前端打包配置把资源路径从绝对路径改成相对路径再把 dist 目录复制到 src/main/resources/static 下这样 SpringBoot 启动后直接访问 8080 根路径就能看到页面。我因为这个白名单漏配曾经浪费过一个下午最后一路排除到只留 /api 下面的接口要鉴权才恢复正常。这里给出的习惯是先放行所有请求跑通功能再加拦截器逐步缩小范围别逆着来。5.3 RequestBody 接收不到前端参数Content-Type 与字段名不一致现象前端 Vue 用 axios 发请求后端 Controller 里用 RequestBody 接收 DTO结果接口被调用后 DTO 所有字段都是 null数据库插进去一行全空的数据。原因两个可能。第一axios 默认的 Content-Type 是 application/x-www-form-urlencoded而后端 RequestBody 期望的是 application/json参数格式对不上SpringBoot 把表单格式按 JSON 解析解析出来一个空对象。第二前端传的是student_id而下划线后端 DTO 字段是studentId驼峰Fastjson 或 Jackson 默认不会自动把下划线映射成驼峰。解决前端请求库统一在创建实例时设置 headeraxios.defaults.headers[Content-Type] application/json;后端如果要用下划线风格的参数可以在 Jackson 配置里开启SNAKE_CASE策略但更推荐的做法是保持前后端都用驼峰字段名。为了排查这类问题我习惯在登录接口加一行日志打印 DTO.toString()后端能看到实际接收到的 JSON前端也能从 Network 面板看到请求体两端一对比就知道是传参问题还是接收问题。5.4 跨域拦截到 OPTIONS 请求导致的 401浏览器预检请求处理现象前端单独跑在 localhost:3000后端跑在 localhost:8080前端请求后端接口时浏览器控制台报 CORS 错误后端日志里能看到 OPTIONS 请求被拦截器拦下返回 401。原因跨源资源共享机制里浏览器在发送真正的 POST 请求之前会先发一个 OPTIONS 预检请求。这个请求不带业务数据也没有我们自定义的 token 头但拦截器不认识它直接把它当成未登录请求拦掉了。前端看到的所谓跨域报错实际上是浏览器收到了 401 后阻止了后续请求而不是 SpringBoot 没配跨域。解决在拦截器里直接放行 OPTIONS 方法同时给项目加一个跨域配置类public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) { if (OPTIONS.equalsIgnoreCase(request.getMethod())) { return true; } // 其余鉴权逻辑 }跨域配置用 WebMvcConfigurer 里重写 addCorsMappings 即可allowedOriginPatterns 不要写成*因为如果后面用了携带 Cookie 的鉴权方式*会被浏览器拒绝。allowedOriginPatterns 允许你写具体的域名或端口模式星号和带凭据的请求不冲突这是与 allowedOrigins 的一个关键区别。5.5 密码明文入库与弱口令至少做一次 Hash 和复杂度校验现象数据库 user 表里密码字段存了 123456、admin888 这种明文登录接口把用户输入的密码原样拿去和数据库比对。一旦数据库泄露所有账号直接暴露答辩老师问到安全性时也很难给出合理解释。原因图省事觉得课设系统不会有真实用户。但成绩系统里会存学生的学号、姓名、班级、成绩信息它属于典型的个人信息数据明文密码无论如何都说不过去。解决不引入完整的 Spring Security 也能做密码哈希。常见的做法是用 Spring Security Crypto 里的 BCryptPasswordEncoder它不需要 Spring 管理new 一个就可以用。注意引入的是spring-security-crypto不是整个 Spring SecurityBCryptPasswordEncoder encoder new BCryptPasswordEncoder(); String encoded encoder.encode(rawPassword);判断密码时调用encoder.matches(rawPassword, encoded)不要把 encode 的结果拿去和数据库里的 hash 再比对一次matches 内部会把同一盐值逻辑处理好。BCrypt 的特点是同一次明文每次加密结果不一样因为内部自动加了盐数据库里存的是算法标识加盐加哈希的组合串比 MD5 加固定盐的方式抗彩虹表攻击能力强很多。密码复杂度校验在注册接口里写一个正则即可至少要求八位且包含字母和数字这一条在系统演示和论文安全分析里都能成为加分项。6. 有用的进阶加一个成绩分析看板和自动导出让答辩更稳前面几章已经让你具备一个完整可运行的系统但这只是毕设的及格线。如果想让答辩老师眼前一亮我建议在最后一周加上两个小功能成绩分布统计看板和定时导出报表。成绩分布看板用 ECharts 就能实现后端给一个统计接口返回各分数段的人数前端用柱状图渲染。这个功能本身很简单但它在答辩中的价值非常大因为它是整个系统里唯一有“视觉冲击力”的页面。按键分别统计 90-100、80-89、70-79、60-69、60 以下的人数SQL 和第 4 章的挂科率统计几乎一样只是把 CASE WHEN 的区间拆细一点。演示时从录入成绩到图表更新一气呵成比展示十张 CRUD 表格更有说服力。定时导出报表则能体现你对 SpringBoot 定时任务的理解。在启动类或配置类上加EnableScheduling然后在需要定时执行的方法上加Scheduled(cron 0 0 8 * * ?)意思是每天上午 8 点导出前一天提交的成绩数据到服务器指定目录。这类功能不用做得很完整导出文件放在服务器的 reports 文件夹里即可。答辩时老师问“系统如何减轻教务老师工作量”你直接用这个功能作答比说“查询很方便”有力得多。我给学生的做法还有一个习惯在交付前把整个系统按演示脚本走一遍从管理员登录、创建班级、导入学生到教师登录录入成绩、查看统计再到学生登录查询成绩全程录屏保存。录屏不需要剪辑但能保证现场演示时就算网络断了、前端崩了也能用录像兜底。这套系统最大的坑往往不在代码本身而在跨浏览器打开页面时的样式错位、中文乱码这类环境问题提前把 Chrome、Edge 都测一遍导出文件的文件名在两种浏览器下多看一眼。系统做完以后自己要知道哪些地方是答辩时会被追问的自动装配原理、事务失效场景、成绩统计 SQL 的聚合逻辑每一条都在前面几章的细节里提到了能把这些坑讲清楚才是一个合格的“基于 SpringBoot 的学生成绩管理系统设计与实现”。希望帮到你。本文还有配套的精品资源点击获取