简介：这是一份「学生成绩信息管理系统的设计与实现」毕业设计型资源，包含完整论文与可运行源码，适合计算机相关专业学生参考课题设计、数据库建模与Web开发实践。系统覆盖学生信息、课程信息、成绩录入与查询、统计分析及报表生成等核心功能，并涉及需求分析、数据模型设计、系统架构及接口设计全过程。压缩包共311个文件，大小约3.48MB，以aspx、cs、dll等C#/ASP.NET源码文件为主，辅以MDF数据库文件、CSS样式、JS脚本、XLS报表及DOC论文文档，结构上按功能模块区分清晰，便于直接对照学习与二次开发。已有59人学习下载。资料内包含系统搭建所需的数据库脚本、页面源码及设计文档，可帮助读者理解从数据表结构到业务逻辑、从前端交互到服务接口的完整实现路径，尤其适合需要快速完成课程设计或毕业设计的开发者参考复用。

1. 学生成绩信息管理系统：论文与源码拿到手之后，先搞清哪三件事

学生成绩信息管理系统的设计与实现，是高校软件工程、计算机科学与技术专业里出现频率最高的毕业设计选题之一。它看起来就是学生、课程、成绩三张表加上增删改查，但真正动手做的时候，你会发现这套系统把权限控制、数据关联、统计报表、异常处理全都串起来了，正好覆盖一门毕设课设该有的技术点。我见过不少同学从网上拿到“论文+源码”的压缩包，打开之后第一反应是“代码能跑”，第二反应是“论文跟代码长得不一样”，最后卡在答辩环节被评委追问得下不来台。这篇文章的目的很简单：把这个题目的技术选型、数据库设计、核心代码实现、论文撰写顺序和常见翻车点一次性讲透，让你拿到任何一份同题目的源码，都能在两三天内改造成自己能讲清楚的作品。这套思路对智慧校园、图书借阅管理系统、基于Spring Boot的商品管理系统这类同构选题也完全适用。

2. 先设计再写码：成绩管理系统的角色权限与五张核心表

2.1 三种角色怎么划分：管理员、教师、学生的用例边界

做这个系统的第一步不是写代码，是把“谁用什么功能”这件事定死。常见的角色划分是三种：管理员负责基础数据维护，包括班级、学生账号、教师账号、课程信息的增删改；教师负责成绩录入、成绩修改和成绩导出；学生只拥有查询权限，能看自己的成绩、算自己的加权平均分。这个边界听起来简单，但我看过太多源码把管理员和教师的权限写成一个按钮组，学生登录后也能调出“录入成绩”的页面，只是前端把按钮藏掉了——这种实现拿到答辩现场，老师用浏览器的开发者工具改一下页面元素就能把入口调出来，直接翻车。

正确的做法是后端拦截器或 Spring AOP 统一做角色校验。前端隐藏按钮只是用户体验，不是安全边界。

在用例层面，教师和学生都依赖“登录”这个公共用例。教师端要细分出“批量导入成绩”“单个修改成绩”“查看班级成绩单”三个子用例；学生端要细分出“查看个人成绩”“按学期筛选”“计算学分绩点”三个子用例。管理员的学生账号管理里有一个容易被忽略的点——初始密码。一般做法是管理员创建账号时设置一个默认密码，比如身份证后六位或统一为 123456，学生第一次登录后强制修改。如果你拿到的源码里没有“强制改密”的功能，那就得在论文的“系统改进”部分提一句，或者自己补上，否则后续评审会认为系统存在明显安全漏洞。

2.2 数据库设计：建好五张表，后面能少写一半重复代码

成绩管理系统的数据模型并不复杂，但表与表之间的外键关系决定了后面所有功能的开发效率。最少需要五张表：用户表、学生表、教师表、课程表、成绩表。用户表存登录凭证，学生表和教师表都通过 user_id 与用户表关联，成绩表则同时引用学生、课程和教师。这里有一个常见的偷懒写法：学生表和教师表各写一套增删改查，代码大量重复；更合理的做法是用户表承担账号信息，学生表和教师表只存业务扩展字段。我一般会在用户表里加一个 role 字段（0 管理员 / 1 教师 / 2 学生），再在学生表和教师表里冗余存一份 user_id，这样查询成绩时直接用学生主键，不需要回表用户表，SQL 写起来更直白。

下面是这五张表的建表脚本，MySQL 8.0 环境可以直接执行：

CREATE TABLE sys_user ( id INT PRIMARY KEY AUTO_INCREMENT, username VARCHAR(50) NOT NULL UNIQUE COMMENT '登录账号', password VARCHAR(100) NOT NULL COMMENT '加密后的密码', role TINYINT NOT NULL DEFAULT 2 COMMENT '0-管理员 1-教师 2-学生', real_name VARCHAR(50) NOT NULL COMMENT '真实姓名', status TINYINT DEFAULT 1 COMMENT '1-正常 0-禁用', created_at DATETIME DEFAULT CURRENT_TIMESTAMP ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4; CREATE TABLE student ( id INT PRIMARY KEY AUTO_INCREMENT, user_id INT NOT NULL UNIQUE, student_no VARCHAR(20) NOT NULL UNIQUE COMMENT '学号', class_name VARCHAR(50) COMMENT '班级名', gender TINYINT DEFAULT 0, phone VARCHAR(20), CONSTRAINT fk_student_user FOREIGN KEY (user_id) REFERENCES sys_user(id) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4; CREATE TABLE teacher ( id INT PRIMARY KEY AUTO_INCREMENT, user_id INT NOT NULL UNIQUE, teacher_no VARCHAR(20) NOT NULL UNIQUE COMMENT '工号', title VARCHAR(30) COMMENT '职称', CONSTRAINT fk_teacher_user FOREIGN KEY (user_id) REFERENCES sys_user(id) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4; CREATE TABLE course ( id INT PRIMARY KEY AUTO_INCREMENT, course_name VARCHAR(100) NOT NULL, credit DECIMAL(3,1) NOT NULL DEFAULT 0 COMMENT '学分', teacher_id INT NOT NULL, semester VARCHAR(20) NOT NULL COMMENT '开课学期，如2024-2025-1', CONSTRAINT fk_course_teacher FOREIGN KEY (teacher_id) REFERENCES teacher(id) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4; CREATE TABLE score ( id INT PRIMARY KEY AUTO_INCREMENT, student_id INT NOT NULL, course_id INT NOT NULL, score DECIMAL(5,2) COMMENT '百分制成绩', remark VARCHAR(255), created_at DATETIME DEFAULT CURRENT_TIMESTAMP, updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP, UNIQUE KEY uk_student_course (student_id, course_id), CONSTRAINT fk_score_student FOREIGN KEY (student_id) REFERENCES student(id), CONSTRAINT fk_score_course FOREIGN KEY (course_id) REFERENCES course(id) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

这段建表脚本有四个细节值得注意。第一，成绩表上加了uk_student_course唯一索引，它的作用是防止同一个学生同一门课程被录入两次，这是很多课设源码里没有做的一步；没有这个索引，重复录入会让统计报表的平均分和排名直接失真。第二，密码字段长度给了 100，不是为了存明文，而是为了存 BCrypt 哈希后的 60 位字符串，后面避坑章节我会展开讲。第三，score DECIMAL(5,2)而不是FLOAT，因为浮点数在计算平均分和按分数段统计时会出现 0.1 累加误差。第四，updated_at字段对“查谁改了成绩”这个答辩必问题至关重要，没有它你没法回答“系统如何审计数据变更”。

2.3 表关系怎么连：一条完整SQL串起学生、课程、成绩

很多初学者写成绩查询时会在 Service 层手动循环查三次数据库，性能差还容易查错。合理做法是直接用多表连接。比如学生端“查看我的所有成绩”这个功能，最核心的 SQL 如下：

SELECT c.course_name, c.credit, c.semester, s.score, s.remark FROM score s JOIN course c ON s.course_id = c.id WHERE s.student_id = #{studentId} ORDER BY c.semester DESC;

这段 SQL 的关键点是JOIN course c ON s.course_id = c.id，学生姓名不需要连 student 表，因为当前登录人就是学生本人，姓名从 session 里拿即可；但课程名称和学分必须连 course 表，否则页面只能显示一个 course_id 数字，没有任何可读性。ORDER BY semester DESC 能保证前端拿到数据后不需要额外排序。

教师端“打印班级成绩单”则是另一个连接方向：

SELECT stu.student_no, stu.class_name, us.real_name, c.course_name, s.score FROM score s JOIN student stu ON s.student_id = stu.id JOIN sys_user us ON stu.user_id = us.id JOIN course c ON s.course_id = c.id WHERE c.teacher_id = #{teacherId} AND c.semester = #{semester} ORDER BY stu.class_name, stu.student_no;

这个查询把教师、课程、学生、成绩四张表串成了一条链。教师通过teacher_id限定自己教的课程，再通过 course 表拿到选课学生名单，最后关联成绩。注意teacher_id不能直接从 score 表取，因为成绩表只关联了课程，课程才归属教师，这是第三范式的常规要求。

这里我建议你做一个数据量的边界测试：导入 200 个学生、5 门课、1000 条成绩后，跑一下班级成绩单查询，确认耗时在 200 毫秒以内。如果超过了，检查是不是 score 表没建索引，或者前端一次性渲染了太多 DOM 节点导致浏览器卡顿。数据量不大时性能问题通常不在数据库中。

3. 核心链路代码实现：登录鉴权、成绩录入、成绩查询与统计

3.1 基于拦截器的登录鉴权：Session与Token选哪个

成绩管理系统的登录态管理有两条路线：传统 JSP/Servlet 项目用 Session，前后端分离项目用 JWT Token。课设源码里两类都很常见，但我的建议是尽量选择 Spring Boot + JWT 的方案，因为答辩时老师更认可这种无状态设计。下面是一个轻量级拦截器实现：

public class AuthInterceptor implements HandlerInterceptor { @Override public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception { // 放行登录接口和静态资源 String uri = request.getRequestURI(); if (uri.startsWith("/api/auth/") || uri.startsWith("/static/")) { return true; } String token = request.getHeader("Authorization"); if (token == null || !token.startsWith("Bearer ")) { response.setStatus(401); return false; } try { Claims claims = Jwts.parser() .setSigningKey(SECRET_KEY) .parseClaimsJws(token.substring(7)) .getBody(); request.setAttribute("userId", claims.get("userId")); request.setAttribute("role", claims.get("role")); return true; } catch (Exception e) { response.setStatus(401); return false; } } }

preHandle方法中先放行登录接口，然后从请求头中取出 Token，解析出 userId 和 role 放到 request 属性中，Controller 里直接request.getAttribute("userId")就能拿到当前操作人。这种实现的优势在于：所有需要登录的接口自动获得用户身份，不需要每个 Controller 重复写解析逻辑。

参数层面，SECRET_KEY不能硬编码在类里，要放到 application.yml 配置文件中，不同环境用不同密钥。Token 有效期建议设置 120 分钟，太短会导致教师录完成绩正要保存时被踢出登录，太长又存在安全隐患。

3.2 教师录入成绩：事务与唯一键缺一不可

录入成绩是系统里最核心的写操作。教师选择一个课程后，页面会列出选课学生名单，教师逐个输入分数，点击保存。这个功能如果实现得粗糙，就会出现“保存一半失败”的尴尬情况——前 20 条插入成功，第 21 条因为分数格式非法而报错，前面已存的数据没法回滚。解决方式是用 Spring 的事务注解，把整个批量保存包在一个事务里。

@Transactional(rollbackFor = Exception.class) public int saveScoreBatch(List<ScoreSaveDTO> list) { for (ScoreSaveDTO dto : list) { if (dto.getScore() == null || dto.getScore() < 0 || dto.getScore() > 100) { throw new BusinessException("成绩必须在0到100之间"); } Score score = new Score(); score.setStudentId(dto.getStudentId()); score.setCourseId(dto.getCourseId()); score.setScore(dto.getScore()); score.setRemark(dto.getRemark()); // 新增则执行insert，已有记录则执行update int count = scoreMapper.countByStudentAndCourse(dto.getStudentId(), dto.getCourseId()); if (count > 0) { scoreMapper.update(score); } else { scoreMapper.insert(score); } } return list.size(); }

@Transactional(rollbackFor = Exception.class)表示任何 RuntimeException 都会触发回滚，Spring 默认只回滚运行时异常，如果这里不写rollbackFor，自定义的业务异常就不会触发回滚，数据就会处于半保存状态——这是我踩过的坑。先countByStudentAndCourse判断记录是否存在，决定 insert 还是 update，这比“先 delete 再 insert”更安全，也正好和 score 表上唯一索引的语义呼应。同一批数据里如果有学生缺考，score 会传 null，此时直接跳过该学生而不抛异常，否则教师会因为一个缺考生无法保存整张成绩单。

3.3 学生查询成绩：只能看自己的数据

学生查询模块要防一个最常见也最容易被老师们挑出来的漏洞——水平越权。学生 A 如果通过修改请求参数里 studentId 来查别人成绩，系统必须挡得住。正确写法是从 Token 里拿当前登录人的身份，而不是从前端参数里读：

@GetMapping("/api/student/scores") public Result getMyScores(HttpServletRequest request) { Integer userId = (Integer) request.getAttribute("userId"); Student student = studentMapper.findByUserId(userId); if (student == null) { return Result.error("找不到学生信息"); } List<ScoreVO> list = scoreMapper.selectByStudentId(student.getId()); return Result.success(list); }

代码的关键在第二行：studentId 来自request.getAttribute("userId")，这个值由拦截器从 Token 中解析出来，前端无法篡改。如果换成从前端传 studentId，就是典型的越权漏洞，答辩时老师用 Postman 改一个参数就能复现。这里我一般会额外加一个学期参数，?semester=2024-2025-1，便于学生按学期查看，汇总全年成绩时前端再逐页请求或者后端提供汇总接口。

3.4 按班级统计平均分：从SQL到前端图表的完整链路

统计功能是论文里必须写的一个模块，因为答辩时老师总会问“你的系统除了增删改查还有什么”——统计报表就是最好的回答。最简单的统计需求是按班级算每门课的平均分、最高分、最低分和不及格人数：

SELECT stu.class_name, c.course_name, ROUND(AVG(s.score), 2) AS avg_score, MAX(s.score) AS max_score, MIN(s.score) AS min_score, SUM(CASE WHEN s.score < 60 THEN 1 ELSE 0 END) AS fail_count, COUNT(*) AS total_count FROM score s JOIN student stu ON s.student_id = stu.id JOIN course c ON s.course_id = c.id WHERE c.semester = #{semester} GROUP BY stu.class_name, c.course_name ORDER BY stu.class_name, c.course_name;

这里有一个容易踩坑的细节：GROUP BY后面不能只写stu.class_name而漏掉c.course_name，因为一个班级会有多门课，只按班级分组会把成绩混在一起算出一个无意义的总平均分。ROUND(AVG(s.score), 2)是为了避免前端拿到的平均分是一长串小数。SUM(CASE WHEN ...)是标准 SQL 写法，不支持 MySQL 的IF()函数以外的数据库语法时用 CASE 更保险。

拿到统计结果后，前端可以用 ECharts 的柱状图展示班级平均分对比，饼图展示成绩分布（优秀、良好、及格、不及格）。论文里需要展示这张图表的截图，并配上“系统支持可视化成绩分析”的描述。实现时注意：图表数据接口要和表格数据接口分开，避免教师切换班级时整个页面卡顿。

3.5 成绩批量导入：Excel上传的完整链路

批量化设计是成绩系统从“玩具”走向“能用”的分水岭。常见做法是提供一个 Excel 模板，教师按模板填写学号和成绩，上传后由后端解析并写入数据库。核心代码如下：

@PostMapping("/api/teacher/score/import") public Result importScore(@RequestParam("file") MultipartFile file, @RequestParam("courseId") Integer courseId) { if (file.isEmpty()) { return Result.error("文件不能为空"); } String originalFilename = file.getOriginalFilename(); if (!originalFilename.endsWith(".xlsx") && !originalFilename.endsWith(".xls")) { return Result.error("仅支持xlsx或xls格式"); } try { Workbook workbook = WorkbookFactory.create(file.getInputStream()); Sheet sheet = workbook.getSheetAt(0); List<ScoreSaveDTO> list = new ArrayList<>(); for (int i = 1; i <= sheet.getLastRowNum(); i++) { Row row = sheet.getRow(i); if (row == null || row.getCell(0) == null) { continue; } String studentNo = row.getCell(0).getStringCellValue().trim(); double scoreVal = row.getCell(1).getNumericCellValue(); Student student = studentMapper.findByStudentNo(studentNo); if (student == null) { throw new BusinessException("第" + (i + 1) + "行学号不存在: " + studentNo); } ScoreSaveDTO dto = new ScoreSaveDTO(); dto.setStudentId(student.getId()); dto.setCourseId(courseId); dto.setScore(scoreVal); list.add(dto); } workbook.close(); return Result.success(saveScoreBatch(list)); } catch (Exception e) { return Result.error("导入失败: " + e.getMessage()); } }

从第 1 行开始遍历（第 0 行是表头），跳过空行，学号列的单元格格式需要设置为文本，否则长学号会被 Excel 转成科学计数法。这个接口有两点要注意：第一，文件格式校验不能只检查文件名后缀，因为改后缀名后内容是错误的格式，WorkbookFactory.create()对错误格式会直接抛异常，所以 try-catch 不能少；第二，批量插入最好在 Service 层统一调用，不要在 Controller 里边遍历边写库，那样一个请求会占用数据库连接很长时间。文件解析耗时与数据量相关，200 行数据大约 1-2 秒，前端要给出 loading 状态防止用户重复提交。

4. 论文怎么写才能跟源码对得上：章节结构、图表引用与答辩防线

4.1 论文目录和源码模块的对应关系

从源码工程反推论文结构，是最高效的写作方式。拿到一个 Spring Boot 项目后，看它的 controller、service、dao 包名，基本就能对应出论文的功能模块图。标准论文目录一般分为六章：绪论、相关技术介绍、需求分析、系统设计、系统实现、系统测试。

相关的表可以这样做：把源码里每个 Controller 的路由映射整理出来，形成“功能模块与接口对照表”，放在论文第 4 章。这个表能让答辩老师快速看到系统的功能覆盖范围，也为软件测试章节提供了测试用例的来源。

论文第 3 章的用例图不需要用绘图工具画得多精美，PlantUML 或 StarUML 生成的图即可，关键是标注出角色、用例和包含关系。第 5 章的系统实现要从“运行效果截图展示”过渡到“核心代码片段 + 逻辑说明”，贴代码时不要贴一整页，选择 10-15 行的关键函数，比如事务注解的批量保存、拦截器的 Token 解析、统计 SQL，每段代码下面配 3-5 句白话说明。这段说明要写成“通过 xxx，实现 xxx，解决了 xxx 问题”的口吻。

4.2 测试用例表怎么写更像真实项目

测试章节是论文里最容易被敷衍但也是最好补的部分。不要只写“系统运行正常”，而要给出具体的测试用例表，每条用例包含五列：用例编号、测试步骤、预期结果、实际结果、是否通过。下面是三个经典用例：

TC-03 特别推荐写进论文，因为它体现了事务设计的价值。很多同学在开发时没有关心过这个场景——批量导入遇到一条坏数据时数据一致性如何保障——论文中写明“事务回滚机制保证了失败时不会产生脏数据”，会给答辩老师留下加分印象。

4.3 答辩环节预设问题清单

答辩环节的提问有固定套路，集中在需求来源、技术项目选型、安全性、扩展性几个方向。提前准备以下问题的回答：

• 为什么选择 MySQL 而不是 Oracle？——从学习成本、部署成本、本系统数据规模角度回答。
• 密码为什么是加密存储的？——说明 BCrypt 加盐哈希，而不是 MD5。
• 如果学生人数扩展到一万人，系统哪里会先成为瓶颈？——单表查询性能、数据库连接池配置、前端页面渲染。
• 你和别人做同样的选题，你的系统有什么不同？——强调批量导入、事务回滚、权限细粒度控制、成绩统计分析。

这些问题在源码或论文中没有现成答案，但大部分都能从代码里找到线索。比如数据库连接池的配置在 application.yml 里，spring.datasource.hikari.maximum-pool-size=10这个参数，就可以作为“扩展到一万人”问题的切入点：数据库连接数上限、并发量估算、Redis 缓存的引入时机。

5. 避坑与排查：这套系统最常见的五个翻车点

5.1 Excel 导入成绩时中文乱码

现象：使用模板导入学生成绩时，数据库里的姓名或备注字段变成了“???”，查询结果无法正常显示。

原因：Excel 文件在读取后编码转换出现不一致。常见的场景是模板另存为了 CSV 格式，CSV 的编码是 GBK 或 ANSI，而 Spring Boot 服务端的读取配置是 UTF-8；另一个原因是 JDBC 连接字符串里没有配置characterEncoding=utf8。这两个问题叠加时，乱码几乎不可避免。

解决：先说 JDBC 层面的处理，在 application.yml 中确认连接串带参。

spring: datasource: url: jdbc:mysql://localhost:3306/grade_db?useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai

注意characterEncoding=utf8不能漏，serverTimezone=Asia/Shanghai也要加上，否则 JDBC 连接 MySQL 8.0 时会因为时区问题报错。Excel 模板文件只提供 xlsx 格式，不让用户另存为 CSV；读取端统一使用WorkbookFactory.create()解析 xlsx 的逻辑，避免处理 CSV 编码问题。导入接口做好这两层处理，基本不会再有乱码出现。

5.2 学生通过修改前端参数看到别人的成绩

现象：登录学生账号后，用 Postman 直接发送GET /api/student/scores?studentId=2的请求，能正常返回另一个学生的成绩。

原因：控制器的查询逻辑直接从前端参数读取 studentId，没有从登录凭证中取当前用户身份，这是水平越权漏洞。很多源码因为前端页面没有暴露修改入口而忽略了后端校验。

解决：严格从 session / Token 中获取当前登录人。参考本文 3.3 节的做法，Controller 内只从request.getAttribute("userId")取身份信息，随后根据用户 ID 到 student 表反查学生主键，再以该主键作为查询条件。前端传任何 studentId 参数都一律忽略。修复后可用 Postman 做一个自测：携带学生 Token 去访问查看其他班级成绩的接口，预期返回 403 或错误提示。论文测试章节里可以把这个测试用例写进去，作为“权限控制有效性验证”有力的支撑。

5.3 数据库密码明文存储，答辩时被当场指出来

现象：打开数据库的 sys_user 表，password 字段直接看到 123456。

原因：开发时图省事，没做任何加密处理。这不仅影响评分，更是真实的安全隐患。

解决：统一用 BCrypt 加密。Spring Security 的BCryptPasswordEncoder可以直接引入，如果项目没有引入 Spring Security，使用spring-security-crypto单个依赖即可。

public class PasswordUtil { private static final BCryptPasswordEncoder ENCODER = new BCryptPasswordEncoder(); public static String encode(String rawPassword) { return ENCODER.encode(rawPassword); } public static boolean match(String rawPassword, String encodedPassword) { return ENCODER.matches(rawPassword, encodedPassword); } }

几点补充说明。BCrypt 每次加密会生成随机盐，所以同一个密码两次加密后字符串不同，这是正常的。第一版系统如果已经存了明文密码，需要写一个一次性迁移脚本，在用户首次登录时用明文校验成功后立即升级为哈希存储。管理员重置密码的功能也要走encode()方法，不能直接 update 明文。

5.4 教务数据中同时存在多个学期，界面却没有学期筛选

现象：成绩数据跨了多个学期，教师想查上一学期的成绩，列表里混在一起，只能一页页翻，查询效率很低。

原因：数据表 design 时遗漏了 semester 维度的查询需求，或者前端没有把学期作为筛选条件传给后端。

解决：在成绩查询接口中增加 semester 参数，后端用动态 SQL 处理。MyBatis 中写法如下：

<select id="selectByCondition" resultType="ScoreVO"> SELECT * FROM score <where> <if test="studentId != null"> AND student_id = #{studentId} </if> <if test="courseId != null"> AND course_id = #{courseId} </if> <if test="semester != null and semester != ''"> AND c.semester = #{semester} </if> </where> </select>

这条 SQL 的 标签会自动处理前导 AND 的问题。前端页面上学期下拉框的数据来源于 course 表中的 distinct 值，而不是后端硬编码写死的学期列表，这样系统新增加学期时界面不需要改代码。

5.5 部署到服务器后接口地址全部变成 404

现象：本地 IDE 运行一切正常，打包成 jar 部署到服务器后，所有接口都无法访问，页面直接 404。

原因：前端构建后的静态文件放到了后端项目的src/main/resources/static目录下，但 SPA 前端路由是 history 模式，刷新页面时请求的路径映射不到后端 Controller。另一种常见原因是数据库配置用了本地 localhost，部署时没有改生产环境地址。

解决：两种方案选择其一。第一种是把前后端分开部署，前端 nginx 转发 API 请求到后端端口。第二种是后端托管前端静态文件并配置一个兜底转发：在 Spring Boot 项目中添加一个 Controller 把所有非/api路径的请求转发到index.html。我一般推荐分开部署，因为上课提交的课设项目在答辩时可能需要在不同电脑上切换运行环境，部署前检查 application.yml 中的数据源地址和端口号。如果连接的不是本地 MySQL，需要把 url 改成服务器的内网或公网 IP，同时确认服务器的防火墙端口已开放。

6. 答辩现场演示的三个技巧：数据要像真的，节奏要控得住

第一个技巧是准备一套“看起来真实”的演示数据。不要用姓名1、姓名2 这样的测试数据，造 30 个学生、6 门课、每个人 8 门课左右的成绩，分数分布要自然——平均分在 70 到 85 之间浮动，有少量不及格，有少数 90 分以上。这样的数据在做成绩统计图表时，柱状图高矮错落，饼图比例正常，评委不会因为数据太假而质疑系统是拼凑出来的。造数可以用 Navicat 的导入功能直接用 Excel 灌进去，也可以在系统里用管理员账号手动批量创建。

第二个技巧是演示路径要固定：先管理员登录建账号，再教师登录录入成绩，最后学生登录查成绩。这条链路完整展示了三种角色的权限差异，也对应了论文里的用例图和测试用例表。演示时不需要每个功能都点一遍，重点展示 Excel 批量导入和成绩统计图表，这两个功能是大多数同题系统没有做好的点，你的系统只要跑通了就天然形成差异化优势。

第三个技巧关乎部署现场。答辩教室的网络环境不可控，数据库连接字符串里的 IP 如果写死了开发机器地址，换一台电脑就崩。最稳妥的做法是在 application.yml 里把数据源参数做成环境变量占位：

spring: datasource: url: jdbc:mysql://${DB_HOST:localhost}:${DB_PORT:3306}/grade_db?useUnicode=true&characterEncoding=utf8 username: ${DB_USER:root} password: ${DB_PASSWORD:123456}

${DB_HOST:localhost}的意思是优先取环境变量 DB_HOST，没有配置时用默认值localhost。这样同一份打包产物既能跑在开发机，也能跑在答辩机器上，不需要改代码重新打包。

我自己的习惯是交付前做一次“冷启动测试”：把项目从 GitHub 或 U 盘重新 clone 到一台干净的电脑上，按 README 的步骤从零配置环境、导入数据库、启动项目、跑通主流程。只要这个流程能在 15 分钟内完成，我的答辩演示就不会因为环境问题翻车。成绩管理系统这类课设题目的技术难度并不高，真正拉开分差的通常就是数据完整性设计、越权防护、事务回滚这些“看不见的细节”——你把这些点做好了，论文和代码也就自然对得上了。希望帮到你。

本文还有配套的精品资源，点击获取