基于SpringBoot+Vue的成绩管理系统：毕设项目实战全解析

简介：这是一套面向计算机专业本科生的高质量Java毕业设计实战资源，聚焦高校教务场景中的成绩管理核心业务，采用主流前后端分离架构（SpringBoot + Vue）实现，兼顾工程规范性与教学适用性。资源包共385个文件，包含97个Java后端业务与控制层代码、36个Vue组件及页面逻辑、26个JPG/PNG界面截图、3个MP4演示视频、1个SQL数据库脚本及完整部署用BAT脚本，整体30.44MB，结构清晰、模块分明，开箱即用。已有192人学习下载，适合作为毕业设计参考、课程设计范例或期末综合实训项目。用户可直接获取高分答辩级全套材料：含可运行源码、MySQL建库建表语句、详细部署文档、功能演示视频、以及开题报告等配套文档，所有代码已在Windows 10/11环境实测通过，附带常见启动异常排错说明与目录结构注释，显著降低复现门槛。 毕设选题年年都在变，但有一条主线基本没动过：SpringBoot + Vue + 数据库。这套组合在Java后端领域已经成为事实标准，尤其在毕业设计、课程设计这类中小型系统开发中，几乎是最稳妥、最能出效果的选择。我这次要聊的“基于SpringBoot+Vue的成绩管理系统”，就是沿着这条主线做出来的一个完整项目，包含源码、数据库脚本、使用文档和演示视频。接下来我会把整个系统的设计思路、核心实现、踩坑点和交付资源的使用方式全部拆开讲一遍，希望能给你一个可以直接参考、甚至照抄的模板。

先说说这个系统到底解决什么问题。很多高校还停留在Excel表格管理成绩的阶段，老师每学期要收集、核对、汇总大量成绩数据，学生想查成绩要么等老师统一发布，要么通过邮件、群文件等方式获取，既不实时也不规范。成绩管理系统要做的就是把这套流程搬到线上：管理员维护学生和课程信息，老师录入和修改成绩，学生在线查看自己的成绩，同时系统能自动计算平均分、绩点、排名等统计信息。功能听起来不复杂，但涉及三个角色、多种权限控制、还有一整套数据库设计，做到完整、好用、可演示，工作量是实打实的。

个人判断是，这个选题非常适合拿来做毕设，原因有三个。一是需求明确，成绩管理是所有人都熟悉的高频场景，评审老师不需要额外了解业务背景就能理解你在做什么。二是技术栈主流，SpringBoot + Vue + MySQL是目前Java方向岗位匹配度最高的组合，写进简历说服力强。三是可扩展性强，想加分就加数据可视化、导出Excel、邮件通知等功能，想稳妥就保证基础功能不出错，弹性很大。

接下来我会从整体设计、功能拆解、数据库设计、核心代码实现、问题排查、资源包使用指引这几个维度，把这个项目的里里外外讲透。

1. 整体设计与技术选型：为什么是SpringBoot + Vue + MySQL

1.1 前后端分离的思路

过去做学生管理系统，常见的做法是JSP + Servlet + JdbcTemplate，所有页面和逻辑耦合在一个工程里。现在再这么做，技术上不是不行，但答辩时竞争力就弱了。前后端分离是目前企业级开发的主流：后端只负责提供接口，返回JSON数据，前端独立部署，通过HTTP调用接口完成交互。

这个项目选择SpringBoot作为后端框架，核心原因是它极大简化了Spring的配置过程。以前用SSM（Spring + SpringMVC + MyBatis）需要写大量的XML配置，Bean的扫描、事务管理、拦截器都要手工配置，对新手很不友好。SpringBoot通过自动配置和约定优于配置的方式，把大部分工作变成了开箱即用。你只要在pom.xml里引入依赖，写好application.yml配置，就能快速起一个可运行的Web服务。

前端选Vue的原因也很直接。Vue是国内使用率最高的前端框架之一，学习曲线比React平缓，模板语法直观，特别适合中小型后台管理系统的开发。配合Element UI组件库，表格、表单、弹窗、菜单这些后台系统的高频组件都能直接复用，开发效率很高。

MySQL作为数据库存储核心数据，是Java生态最常用的搭配。它开源、免费、稳定，支持事务、索引、视图等完整功能，在毕业设计这个量级的数据规模下性能绰绰有余。如果你在Windows上开发，安装配置都比PostgreSQL更省心，遇到问题搜索到的解决方案也更多。

1.2 系统角色与核心业务流程

一个成绩管理系统，角色划分要清晰，这是评审时最容易看出你有没有完整思考业务的地方。我一般把用户分成三类：

• 管理员：拥有最高权限，负责维护基础数据，包括学生信息管理、教师信息管理、课程信息管理、班级信息管理，以及分配课程授课关系（哪个老师教哪门课）。
• 教师：可以查看自己负责的课程，录入学生成绩，修改成绩，并对成绩进行统计分析，比如查看班级平均分、最高分、最低分、及格率等。
• 学生：可以查看自己的成绩列表和汇总信息（总分、平均分、绩点、排名），这是系统里权限最低的角色。

三个角色之间通过权限拦截器做访问控制。后端会在处理请求之前校验当前登录用户的角色，确保普通学生无法访问管理接口，教师只能操作自己管理的课程，管理员拥有全功能访问权。

业务流程中最关键的是成绩录入这环。老师不能随便给任何学生打分，只能给选了这门课的学生打分。这一点在数据库设计时要通过选课表的关联关系来约束，而不是让老师手工选择学生。评分维度也可以做得稍微细一点，平时成绩、实验成绩、期末成绩、总评成绩，这样显得系统更专业，也方便后续统计。

1.3 为什么适合做成毕设项目

回到标题里的“高分项目”三个字，我想多说几句。毕业设计的评分标准通常包括功能完整性、技术难度、代码规范性、文档质量和答辩表现。成绩管理系统在功能完整性上天然占优势，因为它有清晰的多角色、多流程、多状态转换；技术难度虽然不算顶尖，但通过引入JWT认证、拦截器、自定义异常处理、异步导出等细节，可以明显拉开和普通CRUD项目的差距；代码规范性只要你平时注意分层、命名、注释，就是加分项。

更重要的是，这个题目做完之后你可以直接包装成“企业级管理系统”的简历项目，面试Java开发岗时可以和面试官聊权限设计、数据一致性问题、接口性能优化，都是很有话题度的方向。

2. 数据库设计：一张图看懂表结构和关系

2.1 核心数据表一览

我用的是八张表的设计方案，保证功能完整性和扩展性之间的平衡。

起初也有人把学生、教师拆开存？也有人问为什么不统一用一张user表加角色字段就行。这里我解释一下设计权衡：登录认证统一走user表，用role字段区分角色，方便统一登录和认证；但学生和教师各自有独立的业务属性（学号、专业、班级 vs 工号、职称、院系），如果不分开存，要么产生大量空字段，要么就得用冗余的关联表。拆开以后，扩展学生加一个“籍贯”字段不会影响教师表，这种垂直拆分的思路在企业级系统中很常见。

2.2 成绩表的设计细节

成绩表是这个系统的核心，很多人会直接设计成score(student_id, course_id, score)三字段结构，这样设计有两个问题：一是如果两个学期选了同一门课怎么办，二是无法区分补考和正常考试。我的方案是引入student_course选课表作为中间实体，成绩挂在选课记录下，这样每个选课记录都有唯一ID，成绩表只需要一个外键student_course_id就能唯一定位一个学生在某门课某次修读的成绩。

成绩字段我拆成了四个部分：平时成绩（30%）、实验成绩（20%）、期末成绩（50%）、总评成绩。总评成绩由后端按权重自动计算，不依赖前端传值，避免老师前端调试时可以随意篡改总评。四个维度也符合很多高校的实际评分标准，答辩时解释起来很有说服力。

另外还有个实用小设计：在student_course中加一个status字段，用于区分选课状态，1正常，2缓考，3缺考。缺考和缓考的学生在成绩录入时要做区分处理，缓考保留本次选课记录，缺考则总评直接标记为0或不合格，这个逻辑虽然小，但能看出你对业务细节的思考。

2.3 索引和约束设计

数据库设计不能只建表加字段就完事，索引和约束是保证系统稳定和数据一致性的关键。

• 唯一索引：student.student_no唯一，teacher.teacher_no唯一，course.course_no唯一。这些数据在真实世界里本身就具有唯一性，数据库层面也必须有约束兜底，防止重复数据。
• 联合唯一索引：student_course(student_id, course_id, semester)加联合唯一索引，防止同一个学生在同一学期重复选同一门课。
• 外键关系：score.student_course_id引用student_course.id，class_course.course_id引用course.id，保证数据引用的完整性。

建索引时要注意，不是越多越好。索引占用磁盘空间，并且插入、更新数据时要额外维护索引结构，对写性能有损耗。只要针对高频查询条件和唯一性约束来建就足够了，毕设数据量小，不要过度设计。

3. 后端核心实现：从架构分层到关键逻辑

3.1 分层架构与包结构

后端代码组织我采用了经典的三层架构：Controller（接口层）、Service（业务层）、Mapper（数据访问层），再加一个实体层（entity/dto/vo）和配置层（config）。具体包结构如下：

com.example.scoremanagement ├── controller # 接收请求，参数校验，返回结果 ├── service # 业务逻辑处理 │ └── impl # 业务实现类 ├── mapper # MyBatis-Plus数据访问接口 ├── entity # 数据库实体类 ├── dto # 数据传输对象（接收前端参数） ├── vo # 视图对象（返回前端数据） ├── config # 配置类（CORS、拦截器、Knife4j） ├── common # 公共类（统一返回结果、异常处理、常量） └── utils # 工具类（JWT、Excel导出）

这里我用了MyBatis-Plus而不是原生MyBatis，理由很简单：它提供了通用Mapper和LambdaQueryWrapper，单表查询几乎不需要手写SQL，几个常用的CRUD方法直接继承BaseMapper就能用，开发效率提升非常明显。如果你担心MyBatis-Plus会让人觉得技术含量不够，我可以明确告诉你不会。现在很多企业项目都在用MyBatis-Plus，它在MyBatis基础上做了大量增强，只是简单查询不需要写XML而已，复杂查询你依然可以手写SQL。

Controller层只做三件事：接收参数、调用Service、返回统一结果。统一返回对象我定义为Result<T>，包含code（状态码）、message（提示信息）、data（数据体）三个字段。这样前端可以统一处理成功失败逻辑，不需要每个接口单独约定返回结构。我见过不少项目返回格式不统一，有时候直接返回Map，有时候直接返回实体类，前端处理时苦不堪言，这种细节很影响项目质量评分。

Service层是业务逻辑的核心，像成绩总评计算、权限校验、统计汇总都在这一层实现。事务注解@Transactional也是加在Service层方法上的，比如成绩批量录入时，如果某一条数据插入失败，整个批次都要回滚，不能出现部分成功的情况。

3.2 登录认证与权限设计

登录认证用的是JWT（JSON Web Token）方案。流程是这样的：用户提交用户名密码，后端校验通过后生成一个Token返回给前端。前端把Token存到localStorage，之后每次请求都在请求头加上Authorization: Bearer <token>。后端通过拦截器解析Token，获取用户ID和角色，放入ThreadLocal中供后续业务使用。

为什么选JWT而不是传统的Session？因为前后端分离后，后端接口要同时服务于Web端和可能的移动端，Session在跨域、分布式环境下处理比较麻烦。JWT本身是无状态的，Token里携带用户信息，后端无需存储会话数据，非常适合这种场景。

关键代码里的拦截器是这样的：定义一个LoginInterceptor实现HandlerInterceptor，在preHandle方法里校验Token，没有Token或Token过期直接返回401，同时放行登录接口和静态资源路径。addInterceptors配置时也要指定excludePathPatterns，不拦截/api/auth/login、/api/auth/register这些。

角色权限控制这块，我会定义一个自定义注解@RequireRole("admin")，在Controller方法上标注所需的角色，然后通过AOP或拦截器在方法执行前校验。这样做的好处是权限逻辑从业务代码中解耦，新增一个接口时只要加一行注解就能完成权限管理。当然，如果系统的角色特别多、权限粒度特别细，就要引入Spring Security加动态权限体系了，但对这个毕设场景，这种轻量方案已经足够。

3.3 成绩录入与统计模块的实现

成绩录入我设计成按课程聚合的页面：教师进入课程列表，点击某个课程的“成绩录入”按钮，后端返回该课程下所有选课学生的学习成绩进行编辑。学生中途退课或缓考的学生不显示在正常录入列表中，而是单独标记。

批量保存时，前端会提交一个成绩数组，每一行包含student_course_id和四个成绩字段。后端Service里先遍历校验每个项的有效性，考试得分必须在0到100之间，总评成绩按权重加权算出，最后循环更新。这个过程要加@Transactional，保证一个批次要么全部成功要么全部回滚。数据量小的时候可以逐条UPDATE，如果批量插入数据量很大，可以用MyBatis-Plus提供的saveBatch方法，它会自动拼接多值INSERT语句，显著减少数据库连接次数。

统计模块是加分项。教师在成绩详情页可以看到这门课的班级平均分、最高分、最低分、及格率、各分数段分布（优秀、良好、中等、及格、不及格）。这些统计如果每次都从数据库实时汇总，可以用一条GROUP BY加条件计数SQL完成，建议建一个视图或者直接用Mapper写汇总SQL，不要把所有成绩数据查出来用Java内存计算。我踩过内存计算的坑，几千行数据感觉还没什么，但演示时如果搞了一两万条数据，前端页面明显卡顿，这个体验就很不好。

另外，数据可视化也可以做。在统计页面引入一个前端图表库（推荐ECharts），把分数段分布用饼图展示，把最近几个学期的平均分趋势用折线图展示。图表几乎不需要后端专门写接口，复用统计接口返回的数据就能完成。这个功能视觉冲击力强，答辩时效果很好，强烈建议加。

3.4 统一异常处理与日志记录

不要在每个Controller方法里都用try-catch包裹业务代码。正确做法是用SpringBoot的@RestControllerAdvice注解定义全局异常处理器，把异常按类型分类处理：

• BusinessException：业务逻辑异常，例如“课程不存在”“成绩已满分”，返回code为500，message为具体提示。
• MethodArgumentNotValidException：参数校验异常，返回第一个错误字段的提示信息。
• Exception：兜底异常，捕获未预料的异常，返回“服务器内部错误”，并记录详细堆栈到日志文件。

这样做的核心价值是，Controller层的代码会非常干净，只需要关心正常流程。所有的错误响应格式统一为Result.fail(code, message)，前端拿到后统一弹出错误提示，体验一致。

日志记录我用@Log自定义注解加AOP的方式实现，在关键操作（登录、添加学生、录入成绩、修改成绩、删除课程）上加上这个注解，AOP切面会自动把操作人、操作类型、操作参数、操作时间写入system_log表。系统出了数据问题可以回溯，答辩时也是很好的亮点。

4. 前端Vue实现：从脚手架到页面开发

4.1 项目初始化与基础配置

前端我用Vue CLI创建的项目，整体是Vue 2 + Element UI的组合。虽然Vue 3已经很成熟，但Element UI（Vue 2版）在后台管理系统的稳定性和资料丰富程度上依然很强，对毕设场景更友好。

项目结构如下：

src ├── api # 接口请求封装 │ ├── auth.js # 登录相关接口 │ ├── student.js # 学生管理接口 │ ├── course.js # 课程管理接口 │ ├── score.js # 成绩管理接口 │ └── ... ├── assets # 静态资源 ├── components # 公共组件（分页、弹窗、上传等） ├── router # 路由配置 ├── store # Vuex状态管理 ├── utils │ ├── request.js # Axios封装 │ └── auth.js # Token存取工具 └── views ├── login.vue ├── admin # 管理员角色页面 ├── teacher # 教师角色页面 └── student # 学生角色页面

请求封装是前端基础设施的关键。我用Axios实例统一设置baseURL、请求超时时间（设为10s），请求拦截器里从localStorage取Token并加到请求头，响应拦截器里根据后端返回的code做全局处理：401跳转登录页、403提示无权限、其他错误弹出Message提示。这样一来，每个业务页面里就只需要关心数据本身，公共逻辑都在拦截器里搞定，页面代码会干净非常多。

4.2 路由与动态权限菜单

路由分为固定路由和动态路由。固定路由包括登录页、404页；动态路由是根据用户角色生成的可访问页面列表。这种做法在前后端分离项目中几乎是标配。

实现思路是：用户登录成功后，前端根据角色标识拿到对应的菜单配置，动态添加路由并生成侧边栏菜单。管理员看到的是全部菜单（学生管理、教师管理、课程管理、系统日志），教师看到的是我的课程、成绩录入、成绩统计，学生看到的是我的成绩、我的课表。

路由守卫是必加的逻辑：在router.beforeEach中判断用户是否已登录、当前访问的页面是否在他的权限列表里，如果未登录直接重定向到登录页。这个功能叫“路由级权限控制”，后期如果引入了角色按钮级权限，只需要在自定义指令v-permission里判断按钮权限码即可。

权限码方式：给每个按钮定义一个权限字符串（比如student:add），后端登录时返回当前用户的所有权限码列表，前端自定义指令判断列表是否包含目标权限码，不包含就直接移除或禁用按钮。这个思路在大型后台管理系统中很常见，毕设里能讲出来会让面试官眼前一亮。

4.3 成绩管理页面开发要点

成绩录入页面用两个组件配合：左侧课程列表（tab切换或表格行点击），右侧成绩录入表格。Element UI的el-table组件支持对单元格进行编辑，通过给列加type="expand"或直接在表格行内嵌入el-input-number实现。

教师录入时的交互细节：平时成绩、实验成绩、期末成绩输入后，实时计算总评并展示在“总评成绩”列，用@input事件触发前端计算，但最终以后端保存时的计算结果为准。前端实时计算是为了让老师录入时有即时反馈，不会等到保存才发现总评不对。整行编辑完成后点击“保存”按钮，触发批量保存接口。

学生端成绩查询页面就比较简单了，一个el-table展示成绩列表，顶部放几个筛选条件（学期、课程名称），下方展示平均分和绩点卡片。绩点计算规则一般是90分以上4.0，85-89分3.7，82-84分3.3，78-81分3.0，75-77分2.7，72-74分2.3，68-71分2.0，64-67分1.5，60-63分1.0，60分以下0。这个计算逻辑写在后端工具类里，按照学校标准实现即可。

对了，后端接口返回的学生成绩列表，除了成绩字段，还需要返回学生姓名、学号、班级、课程名称、学分、学期等信息。直接从score表查出来是不够的，需要用多表联查。MyBatis-Plus里可以先查成绩列表，再用学生、课程信息批量填充，也可以直接用XML写一个多表联查SQL，一次把需要的信息都查出来。我推荐后者，性能更好、SQL直观。

5. 核心功能实操：从0到1跑起来

5.1 环境准备与项目导入

环境准备是很多初学者卡壳的地方，我按清单来列。

• JDK版本：推荐JDK 8或JDK 11，SpringBoot 2.x对这两个版本兼容性最好。如果你用的是SpringBoot 3.x，那必须JDK 17及以上，这一点经常有人踩坑，版本对不上根本启动不了。
• Maven版本：3.6+，建议用IDEA自带的Bundled Maven，减少配置麻烦。
• Node.js：14版本对Vue CLI 4是安全的，Vue CLI 5要求Node 12以上，反正装一个16.20 LTS基本不会出问题。
• MySQL：5.7或8.0，两者都可以。8.0要注意驱动依赖用com.mysql:mysql-connector-j而不是旧的com.mysql:mysql-connector-java。
• IDE：后端IntelliJ IDEA，前端VSCode或IDEA都行，装好Vue插件。

前端依赖安装用npm install，如果你网络不好，先把镜像源换成淘宝镜像（npm config set registry https://registry.npmmirror.com），不然卡在node-sass安装上会疯掉。node-sass这个包是很多人的噩梦，如果项目使用的是sass包而不是node-sass（Dart Sass实现），则无需为本机编译器配置而烦恼，更推荐。

5.2 后端配置与启动

后端配置文件application.yml是关键。数据源配置、MyBatis-Plus配置、JWT密钥三个部分都要正确。

server: port: 8080 spring: datasource: driver-class-name: com.mysql.cj.jdbc.Driver url: jdbc:mysql://localhost:3306/score_management?useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai username: root password: 你的密码 jackson: date-format: yyyy-MM-dd HH:mm:ss time-zone: GMT+8 mybatis-plus: configuration: log-impl: org.apache.ibatis.logging.stdout.StdOutImpl global-config: db-config: logic-delete-field: deleted logic-delete-value: 1 logic-not-delete-value: 0 jwt: secret: 你的至少32位密钥 expire: 86400

第一次启动时，建议在application.yml里加上spring.sql.init.mode=always让后端自动执行数据库脚本，之后再改成never。如果数据库脚本里有插入管理员初始账号的语句，用完记得改密码。

MyBatis-Plus的逻辑删除配置我特意列出来了：给表加一个deleted字段，然后通过@TableLogic注解标记，MyBatis-Plus执行删除操作时会自动改成UPDATE语句设置该字段为1，查询时自动加上deleted=0条件。这个机制在毕业设计里虽然用不上（删除都可以直接物理删除），但属于企业级项目的常用设计，写进论文或面试讲出来都是加分项。

启动后端时，观察控制台日志是排错的第一手段。常见的启动失败原因：端口被占用（改port）、数据库连不上（查连接串或账号密码）、Maven依赖下载失败（clean+重新import）、JDK版本不兼容（换版本或换SpringBoot版本）。这些问题80%都能从启动日志里找到线索。

5.3 前端启动与联调

前端启动分两种情况：开发调试用npm run serve，构建部署用npm run build。

npm run serve启动后，默认端口是8080，和后端冲突。需要在vue.config.js里设置devServer: { port: 3000, proxy: '/api': { target: 'http://localhost:8080' } }，这样前端请求/api/xxx时，Dev Server会把请求代理到后端8080端口，同时绕过了跨域问题。这也是开发环境最推荐的方案，不需要在后端单独配置CORS。

如果你想把前后端分开部署，就必须在后端配置CORS。加一个WebMvcConfigurer的配置类，重写addCorsMappings方法：

registry.addMapping("/**") .allowedOriginPatterns("*") .allowedMethods("GET", "POST", "PUT", "DELETE") .allowedHeaders("*") .allowCredentials(true) .maxAge(3600);

需要说明的是，allowCredentials设置为true时，allowedOrigins不能使用*，要用allowedOriginPatterns("*")，这是SpringBoot 2.4之后的一个API变化，很多人卡在这里。

5.4 演示环境的准备策略

答辩的时候最怕的就是现场网不好、环境出问题。我的建议是提前做好三手准备：

• 本地环境：确保笔记本电脑上后端、前端、MySQL都能一键启动，关闭不必要的服务释放端口。
• 演示数据：准备一份“漂亮”的演示数据，比如某个班级的成绩分布正好覆盖优秀到不及格的所有分数段，统计图表看起来丰富，不要空荡荡的几条数据。我遇到过有的同学数据库里只有三五条记录，饼图上一眼就能数过来，场面很尴尬。
• 截图和录屏备份：如果现场电脑突然蓝屏，至少还有之前录好的演示视频兜底，这也是项目压缩包里包含演示视频的实际意义。

6. 开发过程中的常见问题与排查技巧

这个项目从零到一跑通，中间踩了不少坑，我挑几个典型的问题详细讲讲，给你当“避坑指南”。

6.1 跨域请求被拦截

前端请求后端时，浏览器控制台报No 'Access-Control-Allow-Origin' header is present，这是最经典的前后端分离问题。原因是一个页面里同时调用了不同端口（前端3000、后端8080）的接口，浏览器的同源策略阻止了跨域请求。解法就是后端配置CORS，或者用前端代理。我给的建议是开发环境用代理，生产部署用Nginx反向代理，后端CORS配置作为兜底。三种方案记住原理，随便现场改一种都能解决。

6.2 MyBatis-Plus分页不生效

selectPage方法分页不生效，查出来的结果还是全量数据。原因是MyBatis-Plus的分页插件需要手动配置PaginationInnerInterceptor才行，不是引入依赖就能自动分页。

如果没有配置，MyBatis-Plus会退化成内存分页模式（查全量数据后内存截断），数据量小看不出问题，实测到上万条才有明显性能下降。

@Configuration public class MybatisPlusConfig { @Bean public MybatisPlusInterceptor mybatisPlusInterceptor() { MybatisPlusInterceptor interceptor = new MybatisPlusInterceptor(); interceptor.addInnerInterceptor(new PaginationInnerInterceptor(DbType.MYSQL)); return interceptor; } }

6.3 实体类字段映射不上

数据库表字段是student_no，实体类属性是studentNo，MyBatis-Plus默认开启驼峰映射（map-underscore-to-camel-case），理论上能自动对应。但如果你写了自定义SQL，比如手写XML里的SELECT student_no FROM student返回给实体，这个映射规则在XML里同样生效，只要配置没关。最容易出问题的是查询别名的场景，比如SELECT s.student_no AS studentNo FROM student s，这里AS别名的驼峰映射看的是列名（别名）而不是字段名，你写student_no反而映射不上。解决方式就一个原则：要么数据库字段全部用下划线，要么Java属性全部用驼峰，XML查询里的别名要和实体属性保持一致。

我一直建议项目创建时就把MyBatis-Plus的驼峰映射保持开启，因为这是数据库字段命名的大趋势，比各种花式命名规范都清晰。如果你因为这个问题查了半天，八成是某个XML文件的别名写错了。

6.4 Vue路由刷新404

前端构建部署到Nginx后，访问首页正常，但刷新某个子路由（比如/student/course/list）直接404。这是因为Nginx默认的try_files没有配置index.html回退。当前端用的是history路由模式（去掉URL中的#号），需要Nginx配置：

location / { try_files $uri $uri/ /index.html; }

这个问题在本地开发时不会出现，因为Dev Server内部已经处理了，但生产部署时一定会碰到。如果你用Nginx部署前端项目，记得加这一行。如果不加，刷新就报404，被导师或评审老师看到会留下一句“这个项目部署有问题”的评价。

6.5 端口占用

启动时报Port 8080 was already in use，直接在命令行执行：

# Windows netstat -ano | findstr 8080 taskkill /pid 对应PID /f # macOS / Linux lsof -i:8080 kill -9 对应PID

端口被占用的原因五花八门，我之前遇到过是同事启动的某项本地服务占了8080，后来习惯性就把后端端口改成8081，但前端代理也要同步改，不然又出现跨域问题。所以端口统一管理很重要，不要随便改一处忘记另一处。

6.6 数据库连接中文乱码

数据库连接串里不加characterEncoding=utf8，插入的中文数据在MySQL里显示为乱码。这个问题的根源是字符集不一致：连接层没有指定utf8，MySQL表结构默认可能是latin1。解决办法是连接串加上characterEncoding=utf8，同时建表时指定DEFAULT CHARSET=utf8mb4。前缀utf8mb4是utf8的超集，建议直接用utf8mb4，能支持emoji等特殊字符，统一现代项目都用这个。

另一个容易被忽视的是serverTimezone参数，MySQL 8.0默认使用UTC时区，会导致时间字段差8小时。连接串里加serverTimezone=Asia/Shanghai，后端Jackson配置的time-zone: GMT+8也要保持一致，前后统一才不会出现时间对不上。

7. 交付资源的使用指引：源码、数据库、文档、演示视频

拿到一个完整项目资源包时，正确使用顺序很重要。打包的文件虽然不同，但使用思路万变不离其宗。

7.1 数据库脚本导入

压缩包里通常会有一个.sql文件，可能是score_management.sql这类名字。导入方式有两种：一种是用命令行mysql -u root -p < score_management.sql，另一种是打开Navicat或DBeaver等数据库工具，执行SQL文件。我推荐后者，可视化界面操作更直观，还能看到执行后是否报错。

导入完之后一定要检查三件事：一是数据库名是不是和后端application.yml里配置的一致，不一致就要改配置文件或导入时重命名库名；二是初始用户名密码有没有写在后端文档里（比如admin/admin123），这是你进入系统的第一把钥匙；三是数据表数量是否完整，如果有些表没建上，仔细看SQL文件的开头有没有CREATE DATABASE语句（有些工具导出时会把建库语句写在开头）。

我用过一个很诡异的场景：SQL文件里有几十条插入语句，其中某条数据里有个特殊字符导致整体导入中断，后面的表又没建全。做演示前我习惯重新执行一遍以便确认环境是干净的。

7.2 源码目录结构解析

拿到源码后，第一件事不是打开IDE狂跑，而是先看目录结构。常见结构是前端和后端分开两个文件夹，简称frontend和backend。先把README.md或使用文档.docx完整看一遍，里面一般记录了启动步骤、默认账号密码、关键配置，甚至常见问题的说明。很多人不管文档直接跑，结果卡在配置上浪费很多时间，其实文档已经把坑填好了。

如果要改项目做二次开发，建议从前端页面入手，结合页面找到对应的API调用，再定位到后端的Controller和Service。Vue项目里可以通过搜索中文文案快速定位页面文件，比如搜索“成绩录入”四个字，马上找到对应页面，然后从页面里的api方法找到后端接口地址，一步步层层深入，这个“从界面反查代码”的定位效率比盲目浏览整个工程高很多。

7.3 演示视频的用法

演示视频一般起到两个作用：一是作为项目功能的真实展示，二是作为答辩前的“彩排”。拿到视频后，不要只是看个热闹，我会做两件事：

第一，跟着视频流程走一遍手动操作。视频录的是最好的演示路径（通常包括登录、不同角色切换、核心业务流程、加分功能展示），你照着这个路径手动操作一遍，确保在自己电脑上能复现。

第二，提炼视频里的讲解逻辑。答辩时你可以按照视频的顺序来讲解，先讲整体框架，再演示登录和角色权限，接着展示核心业务功能，最后展示统计分析等亮点功能。这个顺序本身就体现了项目设计的完整性。

8. 经验总结与扩展思路

最后从个人经验出发说点实在的。

做毕业设计，很多人容易犯一个错误：一头扎进代码里，从头开始一个一个功能地写。正确的做法是先规划好整体架构、数据库设计、页面清单，然后再动手。如果你觉得时间紧，最好的策略是拿一个完整项目做底子，先做到能跑通、能看懂、能讲明白，然后再根据自己的思路做定制化修改。完全从零写一个项目，代码量和调试成本对大部分本科生来说是很大的负担；但完全不改直接用别人的项目，答辩时一问三不知的风险又太大。最稳妥的路线是“理解基础框架 + 充分熟悉的个性化改造”。

具体到这个成绩管理系统，如果想在答辩中增加亮点，我从容易到复杂给你列几个扩展方向：

• 导出Excel功能：使用EasyExcel或POI，把成绩列表导出成Excel。老师确实有把成绩导出发给学生的需求，这个功能实用性强。
• 邮件成绩通知：成绩录入完成后，通过JavaMail自动发邮件通知学生查看成绩。涉及异步任务、模板渲染，可以讲讲消息队列或线程池的知识。
• 数据大屏：管理员首页做一个数据大屏，显示学生总数、课程总数、平均成绩、最近登录活跃度等数据，用ECharts图表铺满一屏，视觉效果满分。
• 成绩申诉流程：学生对成绩有异议时提交申诉申请，教师复核后决定是否修改。这个功能引入了“流程状态”概念（待处理、已通过、已驳回），可以展示你对业务流程的深入理解。
• 缓存优化：对于学生的成绩查询接口，引入Redis缓存，设置固定过期时间，有效降低数据库压力。可以聊缓存穿透、缓存雪崩，及缓存与数据库一致性之应对方法。

不管怎么扩展，有一个不变的原则：项目里出现的每个功能，你都要能用一句话说清楚它的业务价值和实现方式。这不只是为了答辩，更是工程实践中最基本的思维方式。做项目本质上是锻炼“把需求落地为系统”的能力，能力到位了，分数只是水到渠成的事。

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