先说点题外话。每年到毕业设计季总能看到大量学生在同一个题目上反复挣扎——“高校教务系统”。说实话这个项目真的是Java Web方向最经典的题目之一没有更冷门也没有更热门。经典到什么程度呢企业面试时你拿它出来讲业务逻辑面试官是认的课程设计答辩时你拿出DEMO老师是认可的而且源码、数据库、文档配套齐全的话直接二次开发也非常方便。但我也知道很多人拿到这种项目模板后第一反应是“看着挺全不知道怎么跑起来”第二反应是“跑了之后不知道从哪改起”。这篇文章就把这个事情讲透从业务拆解、技术选型、数据库设计到核心代码逻辑、本地部署流程、常见坑点全部过一遍。如果你正好在做这个题目建议把这篇文章当作一份“带路笔记”来用。1. 从选题到落地这套系统到底覆盖了哪些业务1.1 为什么这个题目十几年了还在做高校教务系统说白了就是学校日常教学管理的数字化。为什么这类题目经久不衰因为它有一副特别好用的骨架三类角色、一条业务主线、若干条支线。三类角色管理员、教师、学生。业务主线开课 → 选课 → 排课 → 上课 → 成绩录入 → 成绩查询 → 统计。支线学生管理、教师管理、院系/专业/班级管理、课程管理、公告通知、数据看板。这个骨架几乎覆盖了一个后端项目该有的全部典型场景CRUD增删改查、复杂查询、事务处理、权限控制、数据统计、文件上传等。做一遍这个项目等于把Web后端开发的主干线走了一遍。SpringBoot Vue的组合在这个题目里尤其合适原因也很简单SpringBoot提供了快速构建RESTful API的能力和教务这种“接口密集、业务规则明确”的系统天然匹配。Vue提供了组件化开发的前端体验能轻松实现后台管理界面的布局和交互。两者通过HTTP JSON通信前后端分离的架构也好讲解、好答辩、好找工作。1.2 先把业务画清楚再谈代码拿到模板之后我建议你先不要急着把代码跑起来而是把下面这张业务关系图在纸上画出来。哪怕你直接使用现成源码也需要靠它来理解代码结构。管理员端院系统计管理、专业管理、班级管理。教师账号维护支持批量导入。学生账号维护支持批量导入。课程库管理课程编码、名称、学分、学时、课程属性。开课管理每学期选择课程安排任课教师、上课时间、上课地点、容量。教师端查看自己名下的开课记录。查看选课学生名单。录入/修改学生的课程成绩。查看课程统计数据选课人数、成绩分布等。学生端查看培养计划中的可选课程。在线选课/退课受时间限制、容量限制。查看个人课表。查询成绩查看GPA/学分汇总。当你把修约关系理通之后再看数据库和代码就不会有一种“代码是代码、业务是业务”的分裂感了。2. 技术选型与项目结构SpringBoot和Vue的分工逻辑2.1 为什么是这个组合而不是别的拿SpringBoot Vue的项目很多同学答辩时经常被问到一个问题“你为什么选这两个东西”我见过太多人只能回答“老师推荐的”或者“资料里用的”这样非常减分。你应该能说清楚它们各自解决了什么。SpringBoot解决的是服务端业务逻辑的处理效率问题。教务系统有大量事务性操作比如选课时的并发控制、成绩录入时的权限校验、数据统计时的聚合查询这些都是后端职责。SpringBoot的自动配置、Starter机制和成熟的生态MyBatis-Plus、Spring Security、JWT等让开发周期压缩到很短。Vue解决的是交互界面开发的组织问题。教务系统的页面数量一般在20到30个左右页面结构高度相似表格 搜索栏 表单弹窗。Vue的组件化思想能让这类管理系统做到“一套通用组件多次复用”开发效率很高。如果有余力在答辩时还可以补一句这个组合也是目前中小型企业内部管理系统的主流技术栈之一这意味着代码经验可以直接迁移到工作场景中。2.2 后端工程结构怎么理解拿到源码之后第一件事是看包结构。一般规范的SpringBoot项目是这样组织的src/main/java/com/xxx/edu ├── common/ // 通用返回结果、常量、异常处理、工具类 │ ├── Result.java │ ├── ResultCode.java │ ├── GlobalExceptionHandler.java │ └── JwtUtil.java ├── config/ // 配置类CORS、拦截器、MyBatis-Plus分页等 ├── controller/ // Controller层接收请求、返回结果 │ ├── AdminController.java │ ├── TeacherController.java │ ├── StudentController.java │ └── AuthController.java ├── service/ // Service层业务逻辑 ├── mapper/ // DAO层数据库操作通常搭配MyBatis-Plus ├── entity/ // 实体类与数据库表对应 └── dto/ // 数据传输对象接收前端参数如果你拿到的是已经分层好的源码建议顺着这样一个请求链路去走一遍Controller接收参数 → 调用Service→Service做业务校验和事务控制 → 调用Mapper→ 返回Result封装的数据。这样做的好处是逻辑边界清晰每个类职责单一答辩时也容易说明白。2.3 前端工程结构的核心文件前端通常是一个标准的Vue工程核心文件位置注意这几个src/ ├── api/ // 所有接口请求封装 ├── assets/ // 静态资源 ├── components/ // 通用组件表格、弹窗、上传 ├── layout/ // 整体布局侧边栏 顶栏 内容区 ├── router/ // 路由定义 ├── store/ // 全局状态管理Vuex/Pinia ├── utils/ // axios请求封装、工具方法 └── views/ // 页面组件 ├── admin/ ├── teacher/ └── student/前端的技术栈记忆点就一条把有复用价值的界面拆成组件把有统一规则的请求放进封装好的axios实例。后面讲到会再展开。3. 数据库设计12张表如何撑起教务核心业务3.1 先从RBAC权限模型说起一个成熟的教务系统账号体系不能是“学生表、教师表、管理员表”各建一套因为登录入口只有一个只是角色权限不同。这里用的是经典的RBAC模型基于角色的访问控制核心是五张表sys_user 用户表 —— 存放登录账号、密码、状态 sys_role 角色表 —— 管理员、教师、学生 sys_user_role 用户角色关联表 —— 用户和角色的多对多关系 sys_menu 菜单表 —— 系统里可访问的页面/按钮 sys_role_menu 角色菜单关联表 —— 角色可以访问哪些菜单这样做的好处一眼就能看出来管理员、教师、学生三个角色不再需要维护三套独立的登录表而是统一存在sys_user里通过角色区分权限。你以后要加一个“辅导员”角色不再需要建表只要加角色数据、配菜单权限即可。3.2 教务业务表设计除了权限相关的表剩下的就是业务表这也是数据建模的关键。下面这个表清单是我见过最典型的方案覆盖了绝大多数教务系统功能表名用途核心字段college院系列表院系编码、院系名称major专业列表专业编码、专业名称、所属院系IDclass_info班级列表班级名称、所属专业ID、年级student学生信息表学号、姓名、性别、班级ID、入学年份teacher教师信息表工号、姓名、职称、所属院系IDcourse课程库表课程编码、课程名称、学分、学时、课程类型semester学期表学期名称、开始时间、结束时间course_open开课表学期ID、课程ID、教师ID、上课地点、时间、容量course_selection选课表开课ID、学生ID、选课时间、状态score成绩表开课ID、学生ID、成绩值、录入时间notice公告表标题、内容、发布时间、发布人一个容易忽略但很重要的字段是开课表course_open。很多初学者建模时会把课程和选课直接关联但实际业务中同一门课在不同学期、由不同老师开设是不同“开课记录”。course_open表相当于是“课程 × 学期 × 教师”的实例绑定选课记录的应该是对开课ID的选择而不是对课程ID的选择。3.3 建表时的几个细节这里分享几个实际开发中踩过才知道的细节所有关联ID字段建议都命名为xxx_id作为外键逻辑关联。做题项目一般不需要真的建立物理外键约束容易在数据操作时折腾用逻辑外键 代码控制即可。成绩表不要单独存一个“总成绩”字段应该存储平时成绩、考试成绩在Service层计算总评成绩。这样建表更规范也能为教师端“按加权公式自动计算总评”的功能留好扩展空间。选课表必须加唯一约束(course_open_id, student_id)这是防止同一学生重复选同一门课的最底层保障。用户表的密码字段别用明文。哪怕只是课程设计也要用MD5或BCrypt加密存储。答辩时老师问起“安全设计”这就能直接答上来。如果你手里的源码带数据库脚本文件导入后建议对照上面这个表模型走一遍看每一张表大概承担什么角色。4. 后端核心实现登录鉴权与选课事务4.1 JWT登录鉴权链路教务系统这种前后端分离项目Session方案已经不太合适了主流方案是用JWTJSON Web Token做无状态鉴权。整个流程如下用户输入账号密码后端校验sys_user表。校验通过后将用户ID 角色封装进JWT生成token返回给前端。前端把token存在localStorage或SessionStorage里之后每次请求的Authorization请求头都带上它。后端用拦截器统一校验token如果没有token或token过期直接返回401。登录接口的典型实现如下PostMapping(/login) public Result login(RequestBody LoginRequest request) { // 1.查询用户 SysUser user userService.getUserByUsername(request.getUsername()); // 2.校验密码BCrypt加密比对 boolean isValid BCrypt.checkpw(request.getPassword(), user.getPassword()); if (!isValid) { return Result.error(ResultCode.USERNAME_OR_PASSWORD_ERROR); } // 3.查询角色 ListString roles userService.getRolesByUserId(user.getId()); // 4.生成JWT String token JwtUtil.createToken(user.getId(), roles); return Result.success(Map.of(token, token, roles, roles)); }拦截器的配置核心是继承HandlerInterceptor在preHandle中校验tokenOverride public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception { // 放行登录接口 if (request.getRequestURI().contains(/auth/login)) { return true; } String token request.getHeader(Authorization); // 解析token并存入ThreadLocal后续Controller直接获取当前用户 UserContext.set(JwtUtil.parseToken(token)); return true; }这段逻辑看着不复杂但它串联起了三个知识点拦截器机制、JWT工作原理、ThreadLocal传值。答辩时能把这三点讲清楚比背一堆概念管用得多。4.2 选课接口一次带事务的完整业务选课是教务系统里最具代表性的业务接口因为它包含了业务校验 事务控制 并发处理三层内容。选课接口要做的事检查当前学期是否在选课时间范围内。检查该学生是否已经选过这门课。检查课程是否已满。插入选课记录。更新课程的已选人数。前三点是防违规操作第四点是核心操作第五点是数据一致性维护。用一句话说这段逻辑很考验“发现问题-处理问题”的细节意识。实现时要注意一个经典坑检查容量和更新容量之间不是原子的。在高并发情况下比如选课系统一开放几百名学生同时抢课可能会有超过容量的人选课成功。这个问题在毕业设计里不一定会被问到但出现了可以加分。两种解决方案方案A悲观锁使用SELECT ... FOR UPDATE锁定开课记录行等插入完成后事务再提交。Transactional public boolean selectCourse(Long openId, Long studentId) { // 1.查询开课信息并加行锁 CourseOpen courseOpen courseOpenMapper.selectLockedById(openId); // 2.容量校验 long selectedCount courseSelectionMapper.countByOpenId(openId); if (selectedCount courseOpen.getCapacity()) { return false; // 已满 } // 3.判断是否重复选课 if (courseSelectionMapper.exists(openId, studentId)) { return false; // 已选过 } // 4.插入选课记录 courseSelectionMapper.insert(...); return true; }方案B乐观锁在course_open表增加version字段或使用“已选人数 容量”的原子更新条件。UPDATE course_open SET selected_count selected_count 1 WHERE id #{openId} AND selected_count capacity返回1表示更新成功说明抢到名额返回0表示更新失败说明容量已满。这种方式不需要锁表性能更好。不想写太复杂的话用方案B的SQL原子更新就够了。但最好在Service层做一层兜底判断双保险避免脏数据。4.3 成绩录入与统计成绩录入的逻辑不复杂但权限控制要细教师只能操作“课程开课表里任课教师 当前登录教师”的记录。这里不能用简单的“查询当前教师所有开课”去带过接口本身要带这层校验。成绩统计则是一道典型的SQL聚合题。比如查看某门课程的成绩分布SELECT CASE WHEN score 90 THEN 90-100 WHEN score 80 THEN 80-89 WHEN score 70 THEN 70-79 WHEN score 60 THEN 60-69 ELSE 0-59 END AS score_range, COUNT(*) AS count FROM score WHERE course_open_id #{courseOpenId} GROUP BY score_range这类SQL在写学历项目时几乎必用。如果前端用了ECharts等图表库把这段SQL查出来的结果直接渲染成柱状图、饼图展示效果会很不错。5. 前端实现要点路由守卫和接口封装5.1 axios拦截器处理token前端每个请求都要带着token如果每个页面都自己写一遍headers: { Authorization: Bearer token }那代码就太冗余了。正确做法是在axios实例的请求拦截器里统一注入import axios from axios; import { ElMessage } from element-plus; import router from /router; const service axios.create({ baseURL: /api, timeout: 10000 }); service.interceptors.request.use(config { const token localStorage.getItem(token); if (token) { config.headers[Authorization] token; } return config; }); service.interceptors.response.use( response { const res response.data; if (res.code ! 200) { ElMessage.error(res.message || 请求失败); return Promise.reject(new Error(res.message)); } return res.data; }, error { if (error.response error.response.status 401) { // token失效跳转登录页 localStorage.removeItem(token); router.push(/login); } return Promise.reject(error); } );这一段核心逻辑就是请求带token响应判断状态码401回到登录页。理解这三行前端请求基础就打牢了。5.2 路由守卫控制页面访问前端只靠后端接口鉴权是不够的。未登录用户在点击某个页面时前端应该直接拦下来不让请求发出去。这是路由守卫的职责。router.beforeEach((to, from, next) { const token localStorage.getItem(token); if (to.path /login) { next(); } else if (!token) { next(/login); } else { next(); } });进阶一点的做法是把菜单和路由绑定后端返回的sys_menu用户在登录后后端返回这个角色能看的菜单列表前端动态生成侧边栏和路由。这样不同角色登录后看到的功能入口天然不同权限控制在前端界面这一层也落地了。5.3 组件复用的典型场景教务系统页面数量虽多但绝大多数页面都长一个样上方搜索栏 中间表格 右上新增按钮 行内编辑删除按钮。所以你会看到一个合格的管理系统前端几乎不会为每一个页面单独写一套表格逻辑而是抽出一个通用组件。核心效果是传一个API接口和配置就能渲染出一套完整功能页面。Vue项目里组件的封装一般是这个思路用tabledialogform组合封装成全局组件配置columnList和apiList即可。这套模式能体现“抽象能力”也是前端开发中很加分的点。6. 把项目跑起来本地部署全流程6.1 环境清单先把环境准备好。推荐版本如下兼容性最好组件版本建议说明JDK1.8 或 11SpringBoot 2.x均可Maven3.6依赖管理MySQL5.7 或 8.0导入SQL脚本Node.js14.x 或 16.x运行Vue前端npm/yarn随Node自带管理前端依赖Redis可选如果项目做了验证码/Token黑名单等才需要6.2 数据库初始化与后端配置拿到源码以后http根目录一般会有一个sql文件夹或者一个.sql文件这就是数据库脚本。操作步骤是打开MySQL新建一个库字符集用utf8mb4注意不是utf8utf8mb4才能存emoji和一些特殊字符。导入SQL脚本source /path/to/edu.sql;或者用Navicat等工具直接导入。修改后端application.yml里的数据库配置。server: port: 8080 spring: datasource: url: jdbc:mysql://localhost:3306/edu_system?useUnicodetruecharacterEncodingutf8mb4serverTimezoneAsia/Shanghai username: root password: your_password driver-class-name: com.mysql.cj.jdbc.Driver servlet: multipart: max-file-size: 10MB mybatis-plus: configuration: map-underscore-to-camel-case: true 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几个关键点补充一下serverTimezoneAsia/Shanghai不能省否则MySQL 8经常会报时区错误。driver-class-name在MySQL 8下必须写成com.mysql.cj.jdbc.Driver中间多了一个cj。如果你的项目配置了logic-delete-field逻辑删除所有查询都要注意MyBatis-Plus会自动追加WHERE deleted 0不需要自己拼。后端启动命令很简单cd backend mvn spring-boot:run或者先用mvn clean package打成jar包然后java -jar target/edu-0.0.1-SNAPSHOT.jar运行。6.3 前端启动与联调前端部分打开终端进入项目目录cd frontend npm install npm run serve这里有一个经常出现的问题npm install慢到怀疑人生。推荐先设置淘宝镜像npm config set registry https://registry.npmmirror.com如果项目装的是老版本依赖并且报错比如node-sass装不上大概率是Node版本过高。最稳妥的办法是让Node保持在14到16之间运行这个项目。启动后浏览器访问http://localhost:8081端口要看vue.config.js或package.json配置。同时还要确认后端跑在8080端口。以前后端分离项目的常见做法是在前端vue.config.js中配置代理将/api开头的请求转发到后端8080端口module.exports { devServer: { port: 8081, proxy: { /api: { target: http://localhost:8080, changeOrigin: true } } } };配置好后前端页面里写/api/...实际会转发到http://localhost:8080/api/...去。这样就不存在跨域问题了。7. 我在开发中踩过的坑附解决方案7.1 跨域问题前后端分离项目几乎必然会遇到跨域。前端页面在8081端口请求发到8080端口浏览器会拦截跨域请求。解决方式有两种方式一后端加全局CORS配置这种方案简单。方式二生产环境使用Nginx反代让前端页面和后端接口处于同源路径下。在源码里通常已经配置了CorsConfig类。如果你改动后仍然报跨域先检查两点一是allowedOriginPatterns是不是用的*二是后端是否不小心引入了多个WebMvcConfigurer实现类互相覆盖了配置。建议用Nginx部署的思路理解生产环境的问题项目答辩时也能多一个话题。思路其实很简单把前端打包后的dist目录交给Nginx托管同时把带/api前缀的请求proxy_pass到后端服务。这样浏览器看到的所有请求都是同源的跨域问题自然消失。7.2 MyBatis-Plus的两个高频坑第一坑是分页失效。很多人写完分页查询后发现返回的是全部数据而不是单页数据。原因是没配置分页插件。MyBatis-Plus的新版本中需要显式配置Configuration public class MybatisPlusConfig { Bean public MybatisPlusInterceptor mybatisPlusInterceptor() { MybatisPlusInterceptor interceptor new MybatisPlusInterceptor(); interceptor.addInnerInterceptor(new PaginationInnerInterceptor(DbType.MYSQL)); return interceptor; } }第二坑是selectPage的用法。它的第一个参数是Page对象第二个参数是QueryWrapper。正确用法是PageSysUser page new Page(current, size); QueryWrapperSysUser wrapper new QueryWrapper(); wrapper.like(StringUtils.isNotBlank(keyword), username, keyword); userMapper.selectPage(page, wrapper);查出来的数据在page.getRecords()里总数在page.getTotal()里封装成数据表格的分页参数返回即可。7.3 刷新404和图片路径问题如果前端用了history模式路由直接访问http://localhost:8081/teacher/course时刷新页面会在Nginx环境里出现404。原因是Nginx没有配置前端路由回退。本地开发不受影响但打包部署到Nginx时要记得location / { try_files $uri $uri/ /index.html; }另外学生头像或教师照片这类图片上传功能在本地开发时可能用的是本地目录存储。你会发现图片一上传页面上能显示但过段时间或者换一台电脑就找不到了。这是因为本地路径是写死的。更稳妥的做法是返回一个相对路径前端通过代理去访问静态资源。这一条在做项目时非常容易被忽略。7.4 时间显示的时区问题这是典型问题数据库里存的create_time正常但前端通过JSON拿到的时间总是比实际少8小时或反向多8小时。原因通常出在Jackson对时间类型的序列化上。在application.yml中配置spring: jackson: date-format: yyyy-MM-dd HH:mm:ss time-zone: Asia/Shanghai如果不生效可以考虑在实体类的日期字段上加JsonFormat(pattern yyyy-MM-dd HH:mm:ss, timezone GMT8)标注。数据库连接串里的serverTimezoneAsia/Shanghai也要一起配好三者一整套时间就不会再闹脾气了。8. 二次开发可以往哪走如果你不满足于“项目跑起来”打算在此基础上做更深入的东西我个人建议从下面几个方向里挑一个做扩展。推荐扩展一导入导出功能现在源码里如果只有单条录入扩展成Excel批量导入很加分。学生信息和教师信息批量导入可以用EasyExcel或Apache POI实现前端用el-upload配上模板下载后端解析后逐行校验、逐行入库。这个功能在学生选课系统里很实用真正学期初管理员一次性导入上千个学生账号单条录入根本不现实。推荐扩展二教学评估模块学生学期结束后对课程和教师进行评分。这涉及一个新的业务实体——评估表数据模型上并不复杂但页面和逻辑会多一层。而且评估结果可以关联到成绩单里形成完整的闭环。推荐扩展三教室查询与冲突检测在你已经建好的course_open表中加一个教室字段然后写一个“检测同一时间同一教室是否有两门开课”的校验逻辑。这个功能并不高大上但很好地结合了业务规则和数据库查询。我自己在实际开发中的体会是这种“课程设计级”的项目技术深度不一定需要多深但业务完整度和细节一致性很重要。老师不一定关心你用了多新的框架但一定会在意“选课人数超了怎么办”“教师成绩录入能不能查到学生名单”“换学期之后数据怎么区分”。这些东西比简单写一个CRUD加分多得多。最后再分享一个小建议你拿到任何一套源码都先别急着改页面和加功能把管理员、教师、学生三个角色的账号分别登录一遍走一遍完整流程——管理员开课学生选课教师录成绩学生查成绩。这个流程跑通了你对系统的理解基本就到位了接下来不管是答辩、二次开发还是自己重构代码都有了底气。