Spring+MyBatis课程辅助教学平台后端开发全解析

简介这是一套基于Spring框架的课程辅助教学平台后端系统源码面向后端开发者和课程设计人员覆盖课程、教研活动、论坛等核心业务模块通过RESTful接口与前端交互。压缩包内共有877个文件以Java源文件、Vue组件、JS脚本、HTML页面及SVG图标为主同时包含SQL初始化脚本、运行批处理文件和项目配置整体大小约19.71MB。源码完整实现了课程、课程回答、课程提问、课程问卷、课程作业及教研活动、论坛等模块的增删改查、分页查询以及按日期范围统计提醒数量的接口还集成了文件上传下载和通用功能便于直接导入开发环境进行调试和二次开发。目前已有67人浏览/学习适合用于学习Spring框架实战、RESTful接口设计或作为课程设计、毕业设计的项目基底。目录中的备份文件和配置信息可辅助环境还原与排错整体结构清晰易于上手。1. 这个 Spring 后端系统解决的是课程教学的最后一公里课程辅助教学平台这个名字说穿了就是把“排课表、发通知、收作业”这些线下杂活搬到线上。一个后端系统在这类项目里的任务很明确管好课程数据、用户身份、作业提交和通知发布再把你前端页面要的数据用接口喂出去。这类项目在 Spring 系里非常典型——它不大不小刚好能覆盖 Bean 管理、AOP 事务、拦截器鉴权、MyBatis 持久化这些核心知识点所以很多毕业设计和课程设计都会选它。这篇笔记我会按实际做项目的顺序从选型、搭工程讲到权限和事务最后把源码最容易反车的几个细节单独拿出来说。不管你是要改这份源码去交差还是想照这个方向自己写一个照着这条线走完至少能拿到一个能跑、能演示、能说清楚原理的后端。2. 先定技术选型为什么是 Spring Spring MVC MyBatis 这套组合2.1 需求拆解课程辅助平台的业务模块与数据模型拿到题目先别急着开写第一件事是把业务边界划清楚。课程辅助教学平台按最朴素的场景一定有这几端学生要能看到自己的课程列表、下载课件、提交作业、收到通知老师要能开课、发课件、布置作业、批改打分管理员一般只管用户和课程的基础数据。这个模型落到后端其实就是几个核心实体用户、课程、选课关系、作业、提交记录、通知。数据模型我用过最省事的画法是七张表。user 表存账号、密码、角色role 用字符串区分 student 和 teacher别单独拆角色表教学平台的角色是固定的拆了反而多维护一张表。course 表存课程名、教师、学期、简介。选课关系用选课表 course_selection 单独存为什么因为课程和学生是多对多而且选课表上有退选状态这个字段直接塞在 course 表里没法表达。作业表 assignment 和提交表 submission 也要拆开一次作业对应多个提交记录改成绩时只动 submission 不动 assignment。这七张表的设计直接决定了后面 Service 层写起来顺不顺。我的经验是宁可先多画一张关系表也不要靠 JSON 字段硬塞。教学平台的业务逻辑不复杂关系型建模是完全够用的一旦上了 JSON 字段后面统计选课人数、查未交作业名单时SQL 会写得非常别扭。2.2 框架分工Spring 容器、Spring MVC 控制层、MyBatis 持久层各管什么这个项目用 SSMSpring Spring MVC MyBatis而不是 Spring Boot是这类源码最常见的形态。原因很现实课程设计和技术教学里SSM 能讲清楚 Servlet 容器、DispatcherServlet、事务代理这一整条链路而 Spring Boot 把这些全部自动配置掉了演示起来方便但答辩时很难讲出深度。你自己做选择时如果是在校交作业、要讲原理SSM 更稳妥如果是给企业做内部工具直接用 Spring Boot MyBatis-Plus 省事得多。Spring 在这套架构里的角色是“粘合剂”对象由 Spring 容器创建依赖用注解注入事务交给 AOP 代理你代码里不出现 new Service()。Spring MVC 只管 HTTP 这一层——把 URL 映射到 Controller 方法把前端传来的 JSON 绑定成 Java 对象再把 Service 返回的结果序列化成 JSON 响应。MyBatis 只管 SQL你在 Mapper 接口里声明方法在 XML 里写 SQL参数和结果映射由框架搞定。这三个层次最忌讳的写法是在 Controller 里直接写业务逻辑、在 Service 里拼 SQL。Controller 瘦、Service 厚、Mapper 纯 SQL这条原则比任何框架特性都重要。我评审过不少课程设计源码翻车的大多数都是 Controller 里干了几百行活Service 层形同虚设。这样的代码跑起来没问题但答辩被问“业务逻辑在哪一层”就卡住了。2.3 项目结构按功能分包别按三层硬切项目结构推荐按功能模块分包而不是死板地拆 controller/service/mapper 三个大包。按功能分包的意思是com.xxx.course 下面放 CourseController、CourseService、CourseMappercom.xxx.user 下面放 UserController、UserService、UserMapper。这样改一个功能时所有相关文件就在同一个包下不用在三个平级大包之间来回跳。教学平台这种小项目可能体会不到差别但代码评审时按功能分包的可读性好很多。配置文件的组织也值得说一下。jdbc.properties 放数据库连接spring-mvc.xml 放注解驱动和视图解析器spring-mybatis.xml 放数据源和 SqlSessionFactorymybatis-config.xml 放别名和驼峰映射。分开配是为了排错时能快速定位——连接问题去 jdbc.propertiesMapper 扫描问题去 spring-mybatis.xml。我见过把所有配置堆在一个 applicationContext.xml 里的写法文件三千行改一个数据源要搜半天千万别学。3. 从空目录到可启动搭建一个可运行的后端工程3.1 依赖与配置Maven 依赖清单与 web.xml 的关键配置拿到这份源码的第一步是确认它是个 Maven 工程。判断方法很简单打开项目根目录看有没有 pom.xml。有就用 IDEA 以 Maven 项目方式导入等依赖下载完没有就得手动往 WEB-INF/lib 里塞 jar 包那种工程我建议你直接放弃后续维护成本极高。pom.xml 里核心依赖是这么一组dependencies !-- Spring 核心 -- dependency groupIdorg.springframework/groupId artifactIdspring-context/artifactId version5.3.23/version /dependency !-- Spring MVC -- dependency groupIdorg.springframework/groupId artifactIdspring-webmvc/artifactId version5.3.23/version /dependency !-- Spring 事务配合 jdbc -- dependency groupIdorg.springframework/groupId artifactIdspring-jdbc/artifactId version5.3.23/version /dependency !-- MyBatis 主依赖 -- dependency groupIdorg.mybatis/groupId artifactIdmybatis/artifactId version3.5.13/version /dependency !-- MyBatis 与 Spring 整合的适配器 -- dependency groupIdorg.mybatis/groupId artifactIdmybatis-spring/artifactId version2.1.0/version /dependency !-- MySQL 驱动 -- dependency groupIdmysql/groupId artifactIdmysql-connector-java/artifactId version8.0.31/version /dependency !-- JSON 序列化给 Controller 返回 JSON 用 -- dependency groupIdcom.fasterxml.jackson.core/groupId artifactIdjackson-databind/artifactId version2.13.4/version /dependency /dependencies依赖版本我这里用的是 5.3.x 这条线是 SSM 组合里最稳的组合。Spring 6 开始要求 Jakarta 命名空间和旧版 Tomcat 不兼容源码里如果用的 Tomcat 8.5Spring 5.3 是正确选择。版本挑完之后web.xml 是另一个关键文件它决定了 DispatcherServlet 怎么被加载web-app xmlnshttp://xmlns.jcp.org/xml/ns/javaee xmlns:xsihttp://www.w3.org/2001/XMLSchema-instance xsi:schemaLocationhttp://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-app_3_1.xsd version3.1 !-- Spring 容器监听器启动时加载 Spring 根上下文 -- listener listener-classorg.springframework.web.context.ContextLoaderListener/listener-class /listener context-param param-namecontextConfigLocation/param-name param-valueclasspath:spring-mybatis.xml/param-value /context-param !-- 核心前端控制器拦截所有请求 -- servlet servlet-namedispatcher/servlet-name servlet-classorg.springframework.web.servlet.DispatcherServlet/servlet-class init-param param-namecontextConfigLocation/param-name param-valueclasspath:spring-mvc.xml/param-value /init-param load-on-startup1/load-on-startup /servlet servlet-mapping servlet-namedispatcher/servlet-name url-pattern//url-pattern /servlet-mapping /web-app这段配置里最容易被忽略的是两个上下文的关系ContextLoaderListener 加载的是 spring-mybatis.xml负责 Service、Mapper、数据源这些“后端 Bean”DispatcherServlet 加载的是 spring-mvc.xml负责 Controller 和视图解析。如果只配了一个配置文件就会出现要么 Controller 注入不了 Service要么 Mapper 扫描不到的报错。这个双上下文机制是 SSM 源码里最常被误解的地方。3.2 用 Spring 注解把 Bean 串起来Service、Autowired 与事务的落点工程的骨架配好后代码层的第一个重点是让 Spring 把 Bean 管理起来。Service 实现类上标 Service让它进 Spring 容器依赖的 Mapper 用 Autowired 注入。这里有一个细节Autowired 默认按类型注入如果同一个接口有多个实现类得配合 Qualifier 指定名字否则启动直接报 NoUniqueBeanDefinitionException。教学平台项目里一般不会出现这种场景但你要知道有这件事。事务是这类项目最容易出问题的地方。事务注解 Transactional 推荐标在 Service 实现类上而不是接口上。原因是 Spring 事务基于 AOP 代理标接口上时如果代理模式用的是 CGLIBJDK 动态代理会忽略掉接口上的注解。我见过有同学把 Transactional 写在接口方法上业务代码看起来没问题但数据回滚就是不生效折腾一天最后发现注解位置不对。事务的范围也要控制好。查看类操作比如分页查询课程列表不需要开事务写入操作里单个 update 语句本身是原子的也不需要事务真正需要 Transactional 的是那种“先查后写、多次写”的复合操作比如老师批量布置作业时要先插入作业主记录、再批量插入作业附件记录、还要通知选课学生三步中间任何一步失败前面插的数据都得撤销。事务放在这个粒度上语义最清晰性能影响也最小。3.3 跑通第一个接口课程列表分页查询的完整链路一切配置就绪先跑通一个最简单的接口验证整条链路。以“课程分页列表”为例你要写四层代码。先写实体类 Coursepublic class Course { private Integer id; private String courseName; private String teacherId; private Integer credit; private String semester; // 若查询需要教师姓名可以加一个非表字段 private String teacherName; // 省略 getter/setter工程里建议用 lombok Data 简化 }再写 Mapper 接口和 XML。Mapper 接口只声明方法SQL 写在 XML 里public interface CourseMapper { // 分页查询课程列表 ListCourse selectCoursePage(Param(offset) int offset, Param(limit) int limit); // 统计课程总数用于计算总页数 int countCourse(); }对应 XML 文件在 resources/mapper/CourseMapper.xml?xml version1.0 encodingUTF-8? !DOCTYPE mapper PUBLIC -//mybatis.org//DTD Mapper 3.0//EN http://mybatis.org/dtd/mybatis-3-mapper.dtd mapper namespacecom.example.dao.CourseMapper !-- 分页查询limit 是 MySQL 的方言写法 -- select idselectCoursePage resultTypecom.example.entity.Course SELECT id, course_name, teacher_id, credit, semester FROM course ORDER BY id DESC LIMIT #{offset}, #{limit} /select select idcountCourse resultTypeint SELECT COUNT(*) FROM course /select /mapper这里有个 schema 层面要提醒的坑数据库字段用的是下划线命名course_nameJava 属性用的是驼峰courseName。MyBatis 默认不会自动映射这两者你得在 mybatis-config.xml 里开启驼峰映射否则查询回来的对象全是 nullsettings setting namemapUnderscoreToCamelCase valuetrue/ /settingsService 层负责把分页信息和数据拼装在一起Service public class CourseServiceImpl implements CourseService { Autowired private CourseMapper courseMapper; Override public PageResultCourse getCoursePage(int pageNum, int pageSize) { // 页码从 1 开始计算偏移量转成 offset int offset (pageNum - 1) * pageSize; ListCourse list courseMapper.selectCoursePage(offset, pageSize); int total courseMapper.countCourse(); PageResultCourse result new PageResult(); result.setList(list); result.setTotal(total); result.setPageNum(pageNum); result.setPageSize(pageSize); return result; } }最后是 ControllerController RequestMapping(/course) public class CourseController { Autowired private CourseService courseService; ResponseBody RequestMapping(value /list, method RequestMethod.GET) public ResultData findByPage(RequestParam(defaultValue 1) int pageNum, RequestParam(defaultValue 10) int pageSize) { // 前端传 pageNum1pageSize10后端返回 JSON return ResultData.success(courseService.getCoursePage(pageNum, pageSize)); } }注意 ResponseBody 是关键它的作用是把返回对象用 Jackson 序列化成 JSON 写进响应体。忘了加Spring MVC 会把返回值当成视图名去找 JSP结果就是 404。理清这条链路后你会发现SSM 的请求路径就是一次责任链传递DispatcherServlet 找 HandlerMapping 映射到 ControllerController 调 ServiceService 调 MapperMapper 执行 SQL结果再原路返回序列化成 JSON。任何一个环节报错日志里都会定位到具体层排查思路就很清晰了。4. 业务核心的实现登录鉴权、课程闭环与事务边界4.1 登录与拦截器session 登录态与角色权限的控制课程教学平台一定有角色区分所以登录不能只校验用户名密码还得把角色信息带着走。常见做法是登录成功后把用户对象放进 session同时写一个拦截器拦截需要登录的请求。拦截器是 Spring MVC 里的 HandlerInterceptor它有三个方法——preHandle 在 Controller 执行前调用postHandle 在 Controller 执行后调用afterCompletion 在视图渲染后调用。教学平台只需要用 preHandlepublic class LoginInterceptor implements HandlerInterceptor { Override public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception { // 放行登录接口本身 if (request.getRequestURI().contains(/user/login)) { return true; } // 检查 session 中的登录标记 HttpSession session request.getSession(false); User user (session ! null) ? (User) session.getAttribute(loginUser) : null; if (user null) { // 返回 401 状态码前端拿到后跳转到登录页 response.setStatus(401); response.setContentType(application/json;charsetUTF-8); response.getWriter().write({\code\:401,\msg\:\未登录或登录已过期\}); return false; } return true; } }角色鉴权可以做成注解也可以简单地在 Controller 里判断。课程设计项目推荐注解方式更出彩定义一个 RequireRole(teacher) 注解再在拦截器里用反射读取 handler 上的注解。这样 Controller 写起来干净答辩时还能讲一套“自定义注解 拦截器实现鉴权”的思路。但要注意一个细节拦截器里拿到的 handler 不一定是 HandlerMethod如果是静态资源请求handler 类型是 ResourceHttpRequestHandler直接强转成 HandlerMethod 会抛 ClassCastException所以要加一个 instanceof 判断。这个坑在配了静态资源放行时才会暴露新手经常会忽视。4.2 课程、作业、通知的接口设计与前端约定接口设计上教学平台的前端页面不会复杂到哪里去所以接口约定要简单统一。我惯用的规范是所有接口返回统一结构 { code, msg, data }code 为 200 表示成功401 表示未登录500 表示业务失败data 是真正的业务数据。前端只用判断 code不用每个接口单独处理异常。登录接口返回的 data 里带用户对象和角色字段前端拿到后存进本地控制页面渲染。接口路径按资源命名/course/list、/course/{id}/detail、/assignment/submit、/notice/latest用 REST 风格但不必严格到每个动作都用不同 HTTP 方法——教学平台的前端多半是简单表单提交POST 一把梭不会出大错但 GET 请求一定不能做修改数据的操作这是底线。否则刷新页面会重复提交作业这个事故在实训项目里每年都有。前端交互上有一个高频需求老师布置作业时要上传附件学生提交作业也要传文件。这类接口要再单独处理文件上传Spring MVC 里用 MultipartFile 接收配置 CommonsMultipartResolver 设置最大上传大小。源码里如果没做这个功能你接手后要补的话记得文件不能直接存数据库存到服务器磁盘或对象存储数据库只记录文件路径。存数据库的后果是数据库体积爆炸性增长备份恢复会变成灾难。4.3 事务边界实战批量布置作业时的数据一致性批量布置作业是教学平台里最具代表性的事务场景。老师选中三个班级勾选几道题目点“发布”后端要做的是插入一条 assignment 主记录为每个班级生成独立的作业分配记录更新课程的通知列表。这三步跨了至少三张表中间任何一步发生异常前边的数据就必须回滚。Transactional 默认只回滚 RuntimeException 和 Error不受检异常比如 IOException不会触发回滚。这个很多人不知道如果你的 Service 方法里 try-catch 把异常吃掉了事务代理根本感知不到异常数据照样提交。正确做法是Transactional(rollbackFor Exception.class) public void publishAssignment(AssignmentDTO dto) throws Exception { // 1. 插入作业主记录 assignmentMapper.insert(dto.getAssignment()); // 2. 循环为每个班级生成分配记录 for (Integer classId : dto.getClassIds()) { assignmentMapper.insertClassAssignment(dto.getAssignment().getId(), classId); } // 3. 插入通知 noticeMapper.insertNotice(dto.buildNotice()); }rollbackFor Exception.class 是关键它把所有异常都纳入回滚范围。另外注意事务只在代理对象调用时生效。同类里方法直接 this.xxx() 调用不会走代理Transactional 就失效了。想验证也可以在方法里故意抛个异常看数据有没有残留。这种验证比看日志直观得多。4.4 事务不生效的典型场景自调用与私有方法还有个高频翻车现场是事务方法被类内部调用。比如你在同一个 Service 里一个非事务方法调用了带 Transactional 的另一个方法事务依赖的是 Spring 生成的代理对象而 this.xxx() 调的是原始对象代理根本插不进手。解决办法是把事务方法拆到另一个 Service 里用注入的代理对象去调用或者用 AopContext.currentProxy() 获取当前代理但后者配置要额外开启 exposeProxy不推荐新手用。私有的加 Transactional 也不生效。Spring AOP 默认用的是动态代理代理只能增强 public 和 protected 方法private 方法不走代理链路。你写代码时如果事务方法设成 private数据就是悄悄提交不报错。这种失效方式很难排查因为编译器不会给出警告。我的习惯是凡是涉及多表写入的方法一律声明为 public并保持事务注解可见不依赖 IDE 的警告提示。5. 避坑把源码跑起来时最常见的 5 个问题排查5.1 数据库连接失败时区、驱动和密码加密现象Tomcat 启动时日志刷出一串 Communications link failure或者启动成功但一访问接口就报 Cannot create PoolableConnectionFactory。原因八成是数据库连接串配置和本机 MySQL 环境对不上。常见细节MySQL 8 以上要求驱动类名是 com.mysql.cj.jdbc.Driver以及连接串带 serverTimezoneAsia/Shanghai 时区参数。还有一个低级的坑源码里的数据库密码可能是带特殊字符的比如包含 # 或 直接写在 jdbc.properties 里会被解析截断需要做占位符转义或改成 Spring 的加密属性源。解决路径先在本机命令行用 mysql -u 用户名 -p 密码 试一次确认密码能通再用 Navicat 或 IDEA 的 Database 面板建连接确认连接串和驱动写法最后才去检查工程里的 jdbc.properties。数据库连接这种问题环境和代码一个环节一个环节排除不要上来就怀疑源码有问题。5.2 静态资源或 JSP 404DispatcherServlet 的拦截边界现象访问 HTML、CSS、JS 或 JSP 页面报 404但接口访问正常。原因web.xml 里 DispatcherServlet 的 url-pattern 配成了 /把静态资源请求也拦截了但 Spring MVC 没配置静态资源映射。解决方式二选一要么在 spring-mvc.xml 里加 mvc:resources 映射要么改 url-pattern 为.do 后缀拦截后者治标不治本——.do 会让 URL 风格难看而且前后端分离时代静态资源本来就该由 Nginx 这类服务器处理。教学平台如果走前后端不分离的模式用第一种方案配好静态资源路径才是正确解法。5.3 Jackson 序列化循环引用一对多实体直接转 JSON 报错现象查询课程详情时返回 Course 对象直接抛 StackOverflowError。原因Course 里定义了 List Student 里又回引了 CourseJackson 在序列化时顺着引用链无限递归。解决有三种在实体类字段上标 JsonIgnoreProperties 忽略回引字段用 JsonIgnore 直接忽略一个方向最推荐的是在 Service 层就组装轻量 DTO只返回前端要展示的字段不把 ORM 实体直接暴露给前端。我一般会选第三种——实体倒腾给前端是短平快但后面接口一变实体也跟着面目全非维护成本极高。5.4 时间字段显示异常数据库和 Java 日期类型不一致现象查询出的日期时间比数据库存储的时间早了或晚了 8 小时或者格式是时间戳一串数字。原因一般是 Jackson 序列化时没配置日期格式或者数据库连接串时区参数和容器时区不一致。解决在 spring-mvc.xml 里配置mvc:annotation-driven mvc:message-converters bean classorg.springframework.http.converter.json.Jackson2ObjectMapperFactoryBean property namedateFormat valueyyyy-MM-dd HH:mm:ss/ /bean /mvc:message-converters /mvc:annotation-driven注意这类配置改的只是 JSON 输出的格式不改变数据库存的值。真正的时区偏移问题要看 MySQL 连接串和 MySQL 服务端的时区设置是否一致优先保证两者都是 Asia/Shanghai。5.5 端口被占用重复启动与配置冲突现象Tomcat 启动崩在 Port 8080 was already in use。原因无非是两个上一次关闭操作没杀掉进程或者本地还有其他服务占着 8080。解决在命令行查端口占用Windows 上用 netstat -ano | findstr 8080 拿到 PID再在任务管理器杀掉进程Mac/Linux 上 lsof -i:8080 找到进程再 kill。如果源码自带的 Tomcat 配置里改过端口到 8081也要注意和前后端联调时的跨域冲突端口不一致时页面请求会失败别光顾着启动成功。6. 验证与进阶从跑通到能演示的最后一公里跑通接口只是起点能演示、能交差才是真正目标。我给你几个具体的验证方法照着做一遍基本能过滤掉 80% 的弱点和缝合痕迹用 HTTP 工具自测启动工程后把登录、课程列表、作业提交这几个接口按顺序请求一遍分别是登录拿 session、带 session 访问课程列表、带 session 提交作业核心观察响应码和 JSON 结构是否统一如果出现某个接口响应结构和其他接口不一样访问前先确认 Controller 返回的是 ResultData 包装对象。日志是快速定位问题的助手建议在 Service 层打印关键参数和耗时。用 Slf4j 输出到控制台和文件错误日志单独区分。排错三件套是必学的看启动日志无异常、看请求日志有 URL、看 SQL 日志有执行语句。MyBatis 的 SQL 输出可以在 mybatis-config.xml 里配置 logImpl 为 StdOutImpl这样每条 SQL 和参数都会亮在控制台调试 SQL 时非常直观。我见过不少同学卡在“接口 500 但不知道哪行 SQL 出错”开了 SQL 日志后十秒就能定位。参数校验也别省。课程设计答辩时老师会挑刺“如果前端传个负数 pageSize 怎么办”你可以在 Service 层做兜底校验非法参数直接抛业务异常返回 code 500。不需要引入 Bean Validation 那套大而全的框架手动判断几行代码就够。import javax.validation 注解挂在实体类和 Controller 参数上虽然代码少但至少要会用能让答辩的“亮点”多一个。最后说一个我自己的教训吧。课程设计类源码与其急着去读每一个类的实现不如先把配置启动通、把主业务流程走一遍再逐个模块读代码。我当年刚接触这类项目时一上来就去读 Mapper XML结果被几十条 SQL 绕晕后来换了个策略从拦截器和事务配置入手理解整体架构效率提升非常明显。照这条路径来即使源码里有小问题你也能有底气地说“这行代码为什么要改、改成什么”而不只是会按启动按钮。希望这篇笔记能帮你在 Spring 课程辅助教学平台这个方向上少走点弯路。本文还有配套的精品资源点击获取