SpringBoot+Vue+MyBatis企业级网络教学系统源码全解析

1. 这到底是一套什么系统：先读懂业务模型再谈技术

拿到这套标题里写着“企业级大学生计算机基础网络教学系统管理系统源码｜SpringBoot+Vue+MyBatis架构+MySQL数据库【完整版】”的项目时，我建议你不要急着点运行，先坐下来把业务模型盘清楚。市面上叫“网络教学系统”的项目很多，但大多数只是一个课程列表加一个视频播放页面，严格来说根本不算教学管理。这套系统真正值钱的地方，在于它把“教”和“学”的过程拆成了完整的管理闭环：管理员管全局、教师管课程与班级、学生上课和交作业，三者的数据全部沉淀在同一个库里。

1.1 三角色闭环：管理员、教师、学生各管一段

先从用户视角看流程。学生登录系统后，能看到自己已选的课程、要提交的作业、待完成的考试，以及教师发布的教学资源。教师在后台创建课程、维护班级、发布课件、布置作业、批改评分、创建考试并导出成绩。管理员负责基础数据维护，比如用户账号、院系信息、课程学期状态，还有全系统的公告发布。

这个三角色模型比普通的“教师发资料、学生看资料”复杂在哪儿？在于每一份数据都有归属边界。教师只能看到自己教的数据，学生只能访问自己选课的数据。这就逼着你在设计表结构和接口查询时，始终带着“当前用户是谁、他有没有权限看这条记录”的判断。很多新手项目能做到功能齐全，但权限边界稀烂，一个学生能通过直接改URL参数看见别人的成绩，就是因为当初业务模型没想明白。

1.2 它和网盘类系统、考试系统不是一回事

有人会把网络教学系统理解为“百度网盘 + 问卷星”的组合，这个理解不能说错，但太粗糙。网盘的核心是文件管理，它不关心文件属于哪个课程、哪个教师、被哪些学生下载。而教学系统里的资源必须挂在课程节点下，还要记录是谁上传的、适合哪个章节、学生是否已阅读。

考试模块更不是简单的一张问卷。一场考试需要题库支撑，题目可能分为单选、多选、判断、填空，还要支持手动组卷或随机抽题；考试过程中有倒计时，到点如果学生还没交卷，系统要自动提交；考试结束后客观题自动判分，主观题由教师手动评分。这套链路如果拆成普通表单，代码会乱成一团。所以我在拆解这套源码时，首先看的就是考试模块的数据关系和状态流转，它最能体现项目作者的工程能力。

1.3 “企业级”不是包装词，而是工程规范

标题里“企业级”三个字经常被滥用，但放在教学管理系统里，至少有几件事是硬性的：统一的登录认证、基于角色的权限控制（RBAC）、统一返回格式、异常处理、日志记录、数据库设计规范化。你把这几点对照源码检查，就能快速判断这个项目是“能跑的demo”还是“可以做课程设计底子”的完整系统。

我在实际参考这类项目时，会优先看书包外的几个目录：config、interceptor、handler。如果源码里出现自定义拦截器、全局异常处理器、统一的Result返回类，说明作者有工程意识；如果业务代码里到处是System.out.println，那就要降低预期。这套系统既然敢标注完整版，这几个工程化要素基本是齐的，后面我会逐一讲它们怎么落地。

2. 技术选型复盘：为什么是SpringBoot+Vue+MyBatis+MySQL

选型既是审美问题，也是现实问题。这套组合放在今天依然不算过时，核心原因是它处在“学习成本”和“生产可用性”的平衡点上。下面我把每个组件为什么出现在这里讲透。

2.1 SpringBoot：把SSM的繁琐配置收进自动装配

早期做Java Web开发，Spring MVC + MyBatis 要写大量 XML 配置，数据源、事务管理器、SqlSessionFactory、视图解析器，每条都要手动声明，项目还没开写先被配置折腾半天。SpringBoot 用自动装配把这些沉淀为约定，一个启动类加几个注解，内嵌Tomcat直接跑起来。

对于教学管理系统这种典型CRUD加业务流程的系统，SpringBoot 最合适的点在于：依赖管理清晰、启动部署简单、生态成熟。你不需要深入了解底层原理也能把项目跑通，但跑通后又能沿着spring-boot-autoconfigure的源码往深挖。同时，市面上绝大多数公司的Java技术栈都接受SpringBoot，用它写的项目对求职和课程设计答辩都很友好。

2.2 MyBatis：为什么不直接上MyBatis-Plus

现在很多人一上来就MyBatis-Plus，因为它有BaseMapper，单表CRUD完全不用写SQL。但标题写的是MyBatis，我反而觉得这是项目的一个优点。教学管理系统涉及大量联表查询、条件统计、动态SQL，比如“查询某教师某门课程下所有学生某次作业的平均分”，这种需求用MyBatis的XML写动态SQL非常直白，优化空间也大。

MyBatis-Plus 在简单单表操作上确实省事，但也容易让人忽略SQL执行细节。当你做成绩汇总、试卷组题这类复杂查询时，最终还是得手写SQL。这就像学车先学手动挡，虽然自动挡好开，但理解了离合器怎么配合之后，你开任何车都不慌。MyBatis 让你对每条SQL都有掌控感，这是我觉得这个选型很务实的原因。

2.3 Vue：前后端分离的核心是协作界面

Vue 能在前端框架里胜出的理由很多，但站在教学系统这类项目角度，最直接的好处是模板语法平缓、组件化清晰、中文资料多。一个后台管理系统基本由表格、表单、弹窗、树形菜单组成，Vue + Element UI 能把这些东西拼装得很快。

我见过很多人纠结Vue 2还是Vue 3。这套系统如果是Vue 2 + Element UI，也能理解，毕竟生态成熟资料多；如果是Vue 3 + Element Plus，那说明作者跟上了新版本。无论哪种，核心思想都是一样的：把页面拆成组件，用Vue Router管理路由，用Vuex/Pinia管理全局状态，用Axios做接口请求。你拿到源码后，先别陷入CSS细节，应该先把路由表和接口封装看懂。

2.4 MySQL：业务数据的唯一真相源

MySQL 是这个组合里最不性感、但最不能出错的组件。教学系统的数据量通常不大，单库单表完全够用，真正要看的是设计规范：字符集是否统一为utf8mb4、是否设置逻辑删除字段、时间字段是否用datetime统一存储、关联表是否有唯一索引防止重复提交。

MySQL 5.7 和 8.0 都能跑这套系统，但如果你从别处拿到SQL文件，第一件事就要检查它的版本兼容性。8.0 对utf8mb4默认排序集是utf8mb4_0900_ai_ci，5.7 是utf8mb4_general_ci，导入可能出现排序集冲突。这个坑我在后面部署部分会专门讲。

2.5 这套组合的现实价值

无论你是学生准备毕业设计，还是刚进公司想找一套全栈代码学习，SpringBoot + Vue + MyBatis + MySQL 都是很好的训练场地。它覆盖了后端接口开发、权限认证、文件上传、定时任务、SQL优化、前端组件化、前后端联调，几乎把企业开发日常会碰到的主要模块都演练了一遍。学会了这套组合，再切换到Spring Cloud或Redis缓存体系，思路是连续的不是跳跃的。

3. 核心业务模块逐个拆解：功能点、接口路径与页面角色

我给你按模块过一遍系统到底包含什么。别把它当成菜单抄一遍，重点看我标记出来的角色和权限逻辑。

3.1 登录认证与权限控制模块

登录流程通常是：前端提交账号密码，后端校验通过后生成Token（或写入会话），前端把Token存到本地，之后每个请求在Header里带Token，后端拦截器校验身份。权限控制是RBAC模型：用户属于角色，角色绑定菜单和按钮权限。学生登录后看不到教师后台的“创建作业”按钮，这是写死在权限树里的。

接口上一般会有：

• POST /api/auth/login登录
• POST /api/auth/logout退出
• GET /api/auth/info获取当前用户信息、角色、权限标识

我看代码时会重点看auth/info返回的数据结构，因为它直接决定前端动态渲染菜单的粒度。

3.2 用户管理与课程班级管理

用户管理负责教师、学生账号的创建、检索、重置密码、启用禁用。课程管理维护课程基础信息，比如课程名称、课程编码、学期、学分、授课教师。班级管理通常和课程关联，形成“课程-班级-学生”的多对多结构。

典型接口：

• GET /api/user/list用户分页查询
• POST /api/user/save新增用户
• POST /api/user/resetPwd重置密码
• GET /api/course/page课程分页
• POST /api/course/assignTeacher给课程安排教师

这里最容易出错的表关系是选课记录表。学生选了哪门课、在哪个班级，必须有一张独立的中间表，否则教师统计学生名单时SQL会写得非常痛苦。

3.3 教学资源与课程内容管理

教学资源是学生访问最频繁的模块。资源类型应该包含：课件、实验指导书、示例代码、视频链接。资源实体需要挂在课程章节或目录节点下，可以拆成“章节表”和“资源表”，章节表组织结构，资源表挂文件。

典型接口：

• GET /api/resource/list?courseId=xx&chapterId=xx获取资源列表
• POST /api/resource/upload上传资源文件
• POST /api/resource/saveInfo保存资源信息
• DELETE /api/resource/{id}删除资源

文件上传这块，如果系统把文件保存到本地服务器目录，则需要处理好跨域访问、磁盘路径、文件名重命名三个问题。很多系统的资源列表能查，但图片打不开，八成是静态资源映射没配置。

3.4 作业模块：全流程设计

作业从发布到归档，至少要经过以下环节：

1. 教师创建作业，设置课程、班级、标题、内容、附件、截止时间、是否允许迟交。
2. 学生列表页看到待提交作业，提交文字或上传附件。
3. 系统记录提交时间，对比截止时间判断是否迟到。
4. 教师在批改页查看已交、未交名单，给分并写评语。
5. 学生查看成绩与反馈。

这里的关键点是“逾期判断”和“重复提交控制”。逾期不能只靠前端隐藏按钮，后端必须在提交接口里重新读取截止时间并校验。重复提交则需要用账户加作业维度的唯一约束，或提交前先查询是否已有记录。

典型接口：

• POST /api/homework/save教师新建作业
• GET /api/homework/studentList学生端作业列表
• POST /api/homework/submit学生提交作业
• GET /api/homework/submittedList教师查看已交名单
• POST /api/homework/score作业评分

3.5 在线考试与题库模块

这是整套系统里业务最重的一环。题库表存题目，字段包括题型、题干、选项（可用JSON存储）、答案、难度、所属课程。组卷时可以选择按题目类型和难度随机抽题，生成一张“试卷表”，再把试卷分配给班级，形成“考试记录”。

考试状态机一般是：未开始、进行中、已交卷、已过期、已批改。

客观题自动判分的逻辑是后端逐题比对标准答案，累加得分；主观题则是教师看到学生答卷后给出分数。考试期间前端会做倒计时，后端用定时任务处理超时自动交卷，这是一处非常容易踩坑的逻辑。

典型接口：

• POST /api/question/save维护题目
• POST /api/exam/create创建考试
• POST /api/exam/assignClass分配考试到班级
• GET /api/exam/start学生开始考试，生成答卷
• POST /api/exam/submit学生提交答卷
• GET /api/exam/autoScore自动判分

3.6 成绩统计、公告与答疑

成绩模块会把作业分、考试分按权重聚合成综合成绩，并提供导出Excel或CSV的能力。公告模块面向全部用户发布通知。答疑模块一般以讨论区或私信形式存在，简单一点的实现就是发表主题加回复。

如果源码里没有答疑模块也不用失望，很多“管理版”系统会把答疑拆出去，保留课程、作业、考试、成绩就算核心完整。我的建议是你拿到源码后，把成绩统计的表结构先看明白，再考虑要不要扩展答疑。

4. 数据库设计思路：从业务对象到表结构映射

数据库设计得好不好，直接决定代码里SQL是清爽还是丑陋。这套系统的表数量大概在20张左右，我按业务域给你拆一下。

4.1 权限域表：RBAC五张表

权限域最少需要五张表：

• sys_user用户表：用户ID、用户名、密码（加密存储）、姓名、角色ID、状态
• sys_role角色表：角色ID、角色编码、角色名称
• sys_menu菜单表：菜单ID、父菜单ID、菜单名称、路由地址、权限标识、排序
• sys_user_role用户角色关系表
• sys_role_menu角色菜单关系表

有了这五张表，任何一个用户登录后，可以通过用户ID查到所属角色，再通过角色查到可见菜单和按钮权限。这么设计的好处是以后新增角色不用改代码，只要在菜单表里配置权限标识即可。

4.2 教学域表：课程、班级与选课关系

教学域最少有：

• edu_course课程表：课程ID、名称、编码、学期、学分、教师ID、状态
• edu_class班级表：班级ID、班级名称、所属课程ID、学年学期
• edu_student_class选课表：ID、学生ID、班级ID、选课时间

设计这块时最容易犯的错，是把班级理解成组织架构里的行政班。教学系统里的班级必须和课程关联，因为同一个学生可能同时修“计算机基础A班”和“软件工程B班”，课程结束之后记录就要归档，不能永远挂在行政班节点下。

edu_student_class这张中间表必须加唯一索引，例如uk_student_class(student_id, class_id)，否则同一个学生重复选课，会导致成绩统计翻倍。

4.3 资源与作业表：文件信息要留冗余

资源表：

• teaching_resource资源ID、课程ID、章节ID、资源名称、资源类型、文件路径、文件大小、上传教师ID、创建时间

作业相关表：

• homework：作业ID、课程ID、班级ID、标题、内容、截止时间、是否允许迟交、创建教师ID
• homework_submit：提交ID、作业ID、学生ID、提交内容、附件路径、提交时间、是否迟交、得分、教师评语

homework_submit里我建议保存一个is_late字段，而不是在查询时每次拿submit_time和deadline现场比较。保存冗余字段的代价是写入时多算一次，收益是查询和统计非常快。成绩导出时你总不希望每行都做一次时间比较计算。

4.4 考试表：题目与试卷的关联

考试域核心表：

• exam_question题目表：题目ID、课程ID、题型、题干、选项JSON、标准答案、分数、难度
• exam_paper试卷表：试卷ID、课程ID、试卷名称、总分、时长
• exam_paper_question试卷题目表：ID、试卷ID、题目ID、分数
• exam考试表：考试ID、试卷ID、班级ID、开始时间、结束时间、状态
• exam_record考试记录表：记录ID、考试ID、学生ID、开始时间、交卷时间、得分、状态

这里最难搞的是exam_record下的答题明细。简单做法是直接在记录表里存一个JSON字段，保存学生每题的答案；复杂做法是单建一张明细表。前者省表，后者便于统计单题正确率。对于课程设计级别的系统，JSON字段完全可以接受，但如果你后续想给题库做学情分析，那还是拆明细表更合理。

4.5 一张好表该有的标配字段

我翻项目源码时会先看建表语句，重点检查以下字段是否齐全：

• id主键，一般用自增，长整型更稳妥
• create_time创建时间
• update_time更新时间
• deleted逻辑删除标记，避免物理删除导致历史数据丢失
• status状态字段，便于软启用禁用

另外，外键我倾向于不物理创建，只在业务层维护逻辑关系。教学系统数据量不大，物理外键带来的独立性损失大于它带来的完整性保障；靠应用层事务和索引约束就够用。

4.6 高频SQL写法示例

“教师查看某课程下所有学生的作业成绩”是统计类模块最常见的一条SQL，我写出来给你参考：

SELECT su.real_name AS student_name, h.homework_title, hs.score, hs.is_late FROM homework h LEFT JOIN homework_submit hs ON hs.homework_id = h.id LEFT JOIN sys_user su ON su.id = hs.student_id WHERE h.course_id = #{courseId} AND h.deleted = 0 ORDER BY h.create_time DESC;

这里刻意用LEFT JOIN而不是INNER JOIN，是因为教师需要看到哪些学生没交作业。如果只用INNER JOIN，没交作业的学生直接消失，名单就不完整。

成绩总分汇总时再用一个子查询：

SELECT su.real_name AS student_name, SUM(hs.score) AS total_score, COUNT(hs.id) AS submit_count FROM homework_submit hs JOIN homework h ON h.id = hs.homework_id JOIN sys_user su ON su.id = hs.student_id WHERE h.course_id = #{courseId} AND h.deleted = 0 GROUP BY su.id ORDER BY total_score DESC;

像这类语句，在MyBatis的XML里写比写在Java代码里拼接字符串要清晰得多，也能复用<sql>片段，这是MyBatis的一大优势。

5. 后端关键链路实现：SpringBoot集成MyBatis的工程细节

模块设计得再好，最终要落到代码工程上。我重点讲几个项目里一定会被问到的后端实现点。

5.1 工程目录分层：从Controller到Mapper一条线

一个合格的工程目录大概长这样：

com.xxx.edusystem ├── config // 配置类：跨域、拦截器注册、文件上传配置 ├── controller // 接口层：接收参数、返回结果 ├── service // 业务层：核心逻辑 │ └── impl ├── mapper // MyBatis接口 ├── entity // 实体类 ├── dto // 前端入参对象 ├── vo // 视图返回对象 ├── interceptor // 登录拦截器、权限拦截器 ├── handler // 全局异常处理 ├── utils // 工具类 └── common // 通用返回结果、常量、枚举

我判断一个项目要不要得，先看它是否区分dto和vo。很多人把前端传的参数直接用entity接收，数据库字段一旦调整，接口参数全乱。正确做法是：前端参数用DTO接收，传给前端的数据用VO返回，Entity只在持久层使用。这套系统能叫“完整版”，这类分层细节是站得住的。

5.2 统一响应体：让前端少写一半判断

后端每个接口都应该返回统一结构，例如：

@Data public class Result<T> { private Integer code; private String message; private T data; public static <T> Result<T> ok(T data) { Result<T> r = new Result<>(); r.setCode(200); r.setMessage("操作成功"); r.setData(data); return r; } public static <T> Result<T> fail(String message) { Result<T> r = new Result<>(); r.setCode(500); r.setMessage(message); return r; } }

前端Axios拦截器拿到响应后，只看code就能决定走成功还是失败逻辑，不用每个接口自己try catch。我在实际用这套模式时体会很深，它能把大量重复的错误提示从业务代码里剥离出去。

5.3 登录态与拦截器：别把身份验证塞进每个接口

推荐的做法是写一个AuthInterceptor拦截器，实现HandlerInterceptor接口，在preHandle里校验Token。校验逻辑是：从请求头拿Token，解析出用户ID，查出用户最新信息，再把用户对象放ThreadLocal。

伪代码：

public class AuthInterceptor implements HandlerInterceptor { @Override public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception { String token = request.getHeader("Authorization"); if (token == null || !jwtUtil.validate(token)) { response.setStatus(401); return false; } LoginUser loginUser = jwtUtil.parseToken(token); UserContext.set(loginUser); return true; } }

有了UserContext，Service层直接用UserContext.get().getId()拿到当前用户ID，再配合权限标识校验接口是否放行。好处是所有需要当前用户的接口都不需要重复写参数传递和Token解析，代码清爽得多。

权限校验可以用拦截器，也可以配合注解@RequirePermission("homework:submit")实现。注解方式更灵活，代码侵入性也更低。

5.4 文件上传的本地存储方案

教学系统要传课件和作业附件。小项目最好用的是本地磁盘存储，不起OSS也能跑通。关键步骤有三步：

1. 在配置文件中设置上传路径：

file: upload-path: /data/edu/files/ access-path: /files/**

2. 实现静态资源映射：

@Configuration public class WebConfig implements WebMvcConfigurer { @Value("${file.upload-path}") private String uploadPath; @Override public void addResourceHandlers(ResourceHandlerRegistry registry) { registry.addResourceHandler("/files/**") .addResourceHandler(uploadPath); } }

3. 保存文件时用UUID重命名，避免中文文件名和路径编码问题。

这个方案的问题在公网服务器上暴露得很明显：如果部署环境有反向代理，需要把/files/前缀一起代理过去，否则图片和课件无法访问。如果你准备部署上线，建议直接换成对象存储，把上传接口改成上传到OSS后返回URL，业务表的“文件路径”字段存完整URL即可。

5.5 事务、重复提交与考试防作弊

作业提交接口必须加事务注解@Transactional，否则可能出现“提交记录写入了，附件信息没写入”的脏数据。同时为了防止学生连点两次按钮造成两条提交记录，有两种常见方案：数据库唯一索引兜底，或者接口入口做分布式锁。这个项目级别用数据库唯一索引就够了。

考试自动交卷，除了前端倒计时到0调一次提交接口，后端还应该有定时任务兜底。用Spring的@Scheduled可以这样实现：

@Component public class ExamAutoSubmitTask { @Scheduled(cron = "0 * * * * ?") public void autoSubmitTimeoutExams() { List<Exam> exams = examMapper.findByStatusRunning(); for (Exam exam : exams) { if (exam.getEndTime().isBefore(LocalDateTime.now())) { examService.forceSubmit(exam.getId()); } } } }

考试防作弊这块，完整系统一般会记录进入考试、切出页面的日志，甚至比对答题时间。如果源码里没有太重的实现，也不要奇怪，这属于可扩展模块。课程设计答辩时能说清楚“如果我要做防作弊，我会在哪个表记录什么数据”，已经是加分项了。

5.6 定时任务：作业截止提醒

另一个可以深挖的点是作业截止提醒。最朴素的实现是每分钟扫描一次即将到截止时间的作业，给未提交学生生成站内通知。这里面要注意的是，提醒只需要发一次，所以作业表要有一个reminded字段标记已提醒，防止重复通知把学生烦死。

6. 前端Vue实现思路：页面编排与接口对接

后端只是底盘，前端决定用户体验。

6.1 路由设计：按角色分框架

前端路由建议分成两层：外层框架页Layout，内层业务页面。配合Vue Router的路由守卫，登录后动态加载当前角色的菜单。

示例伪代码：

router.beforeEach((to, from, next) => { const token = localStorage.getItem('token'); if (!token && to.path !== '/login') { next('/login'); } else { next(); } });

动态菜单的做法是从后端/api/auth/info拿菜单列表，再router.addRoutes添加路由。这套系统的页面数量在学校场景下不算多，即使静态写死路由也能接受，但“动态菜单”更像企业级。

6.2 Axios封装：拦截器里做统一处理

在Vue里每个页面都写this.$axios.get()是可以跑的，但不能复用，也不利于统一处理401。我推荐的封装思路是：

const service = axios.create({ baseURL: '/api', timeout: 15000 }); 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) { return res.data; } else { Message.error(res.message); return Promise.reject(new Error(res.message)); } }, error => { if (error.response && error.response.status === 401) { router.push('/login'); } return Promise.reject(error); } );

前端每个接口只需关心业务数据，登录过期、网络错误、业务错误提示全部收口到封装层。这套模式能在多个项目复用，非常值得记下来。

6.3 页面组件拆分：表格、上传、富文本、倒计时

后台管理系统的高频组件就那么几个：

• 表格页：条件搜索栏 + 表格 + 分页组件
• 上传组件：Element UI的el-upload，提交前先调上传接口拿到文件路径
• 富文本：教师发布作业和公告时用
• 倒计时：考试页必须，注意切后台也要能持续计数

拆组件时最怕一个SFC文件写3000行。我的经验是每个页面控制在500行以内，超过就把表格列、弹窗表单拆成子组件。组件传参多用props和事件，少用全局Vuex，避免状态流混乱。

6.4 动态菜单与按钮级权限

动态菜单决定了角色能看到哪些入口，但按钮级权限更进一步。学生角色不显示“发布作业”按钮，不是把按钮写死隐藏，而是要有一个全局权限指令，例如：

Vue.directive('perm', { inserted(el, binding) { const userPerms = store.state.user.permissions; if (!userPerms.includes(binding.value)) { el.parentNode.removeChild(el); } } });

模板里这样使用：

<el-button v-perm="'homework:save'">发布作业</el-button>

这样新增功能时，只要后端定义了权限标识，前端不用改逻辑，权限系统自动控制显隐。真正的企业级管理系统就是靠这一套标识体系做扩展的。

6.5 前后端联调时的常见问题

联调阶段最常见的三个问题，我直接列出来：

1. 跨域配置没做。建议后端开启CORS，并允许Authorization请求头。
2. 时间字段格式不一致。Java的LocalDateTime序列化出来是yyyy-MM-ddTHH:mm:ss，前端如果不解析，表格显示会很奇怪。建议统一配置Jackson的日期格式。
3. 文件上传路径不一致。前端传的是/files/20240501/xxx.pdf，后端配置的映射没覆盖，导致图片404。

这些都是小问题，但卡住新人的时候能卡一个下午。我建议在联调前先把前后端环境变量和日期格式对齐，能省很多无用功。

7. 从源码到跑通：本地部署完整步骤与常见问题

源码拿到手跑不起来，很大概率不是代码问题，而是环境差异。我按步骤给你过一遍。

7.1 环境准备清单

如果你电脑上装了多个JDK，最好在项目里用Maven指定编译版本，别让系统环境变量里的JDK版本干扰编译。

7.2 初始化数据库

拿到源码后，数据库脚本一般放在sql目录下。我的建议是新建数据库edu_system，然后导入脚本：

mysql -uroot -p -e "CREATE DATABASE edu_system DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;" mysql -uroot -p edu_system < edu_system.sql

如果导入报错，打开SQL文件核对表名字段大小写，Windows环境MySQL的表名大小写敏感度跟Linux不一样，很可能在这里踩坑。

7.3 启动后端

修改application.yml里的数据库连接配置：

spring: datasource: url: jdbc:mysql://localhost:3306/edu_system?useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai username: root password: 你的密码 driver-class-name: com.mysql.cj.jdbc.Driver mybatis: mapper-locations: classpath:mapper/*.xml type-aliases-package: com.xxx.edusystem.entity

然后执行：

mvn clean package -DskipTests java -jar target/edu-system-1.0.0.jar

如果启动日志出现Tomcat started on port(s): 8080，后端基本没问题。如果报找不到application.yml，多半是IDEA工作目录不对，去Run Configuration里把Working directory改成模块目录。

7.4 启动前端

进入前端目录：

npm install npm run dev

如果npm install报错，建议换成yarn install或使用国内镜像源。启动后浏览器打开http://localhost:8081，如果页面能出，但登录提示接口地址不对，去vue.config.js里改代理：

module.exports = { devServer: { proxy: { '/api': { target: 'http://localhost:8080', changeOrigin: true } } } };

7.5 用一条完整流程验收系统

我跑通项目后从不只看登录页，会走一条完整业务流验证系统可用性：

1. 用管理员账号登录，创建一个教师账号和一个学生账号。
2. 用教师账号登录，创建课程，添加班级，导入学生，发布一份作业。
3. 用学生账号登录，看到作业，提交一份附件。
4. 再用教师账号进入批改，给学生打分。
5. 回到学生账号确认成绩可见。

这条链路如果能走通，核心模块基本就通了。哪里断了，日志和数据库记录同时看，定位效率最高。

7.6 常见启动失败排查清单

8. 踩坑记录与优化方向

最后这部分是通用的经验之谈，也是真正让项目从“能跑”升级为“好用”的地方。

8.1 数据库连接时的SSL时区报错

我第一次跑这种SpringBoot 2.x + MySQL 8.0组合时，数据库连接报过SSL connection警告，其实不是致命错误，但看着很烦。在URL里加上useSSL=false&allowPublicKeyRetrieval=true可以解决。时区问题我之前讲过了，建议容器和数据库环境都统一采用Asia/Shanghai，避免动态查询“今天还有哪些作业截止”之类的接口出现时差偏差。

8.2 MyBatis驼峰映射与XML路径

一个很常见的坑是：数据库字段用下划线命名如create_time，Java实体用驼峰如createTime，但配置文件没开驼峰映射，导致对象属性为null。解决办法是在application.yml里加：

mybatis: configuration: map-underscore-to-camel-case: true

如果还是查不出数据，检查mapper接口的方法名和XML里的id是否完全匹配，以及mapper-locations是否扫描到了XML文件。这是MyBatis初学者踩得最多的坑。

8.3 跨域与Token预检

前后端分离后，如果前端在Header里放自定义Token，浏览器会自动发起一次OPTIONS预检请求。如果后端没有正确处理OPTIONS，登录后所有接口都会跨域失败。后端CORS配置里一定要放行OPTIONS：

registry.addMapping("/**") .allowedOrigins("*") .allowedMethods("GET", "POST", "PUT", "DELETE", "OPTIONS") .allowedHeaders("*");

如果你还有权限拦截器，记得对OPTIONS请求放行，否则预检直接被拦成401。

8.4 性能优化方向：缓存、索引、异步

教学系统并发不会特别夸张，但几个地方值得做优化：

• 首页统计接口如果每次实时查全表，数据量大了会变慢，可以加Redis缓存，缓存有效期60秒即可。
• 字典类型数据，比如课程状态、考试状态，可以在系统启动时加载到内存，避免频繁查表。
• 成绩汇总SQL要确认索引是否命中。大面积性能问题往往不是代码慢，而是WHERE条件没走索引。

8.5 二次开发建议：从哪里入手改

如果你打算用这套系统做毕业设计或课程设计，我建议从以下三个方向里挑一个，改动量小、展示效果好：

1. 增加数据可视化大屏：把课程数量、作业提交率、成绩分布用图表展示，前端用ECharts，后端只要提供统计接口。
2. 增加Redis验证码登录：登录页加图形验证码或短信验证码，不复杂但很显眼。
3. 增加在线讨论区：给每个课程挂一个讨论板块，加深师生互动场景。

这三个方向都不需要推翻核心表结构，只是扩表扩接口，课程设计答辩时能讲清楚设计思路就很加分。

最后分享一个我调试这类全栈项目时一直保留的习惯：不要从中间开始验证，永远先跑通“管理员登录 → 查看一条已有数据”的最小链路，再往外扩展。这条链路通了，说明数据库、后端服务、前端的网络通路和权限体系都是好的，剩下的问题大概率发生在具体业务逻辑里。数据库连接、跨域、Token、日期格式这些问题，都能在最小链路里暴露出来，越早解决，后面越顺畅。