简介这是一套基于SpringBoot的在线学籍系统完整源码面向计算机、电子信息工程等专业的学习者可作为高分毕业设计、课程设计或期末大作业的参考方案。项目采用B/S与MVC架构技术栈涵盖Java、SpringBoot、Mybatis、Ajax、Vue、Mysql与Maven开发环境为IDEA、JDK1.8、Maven3.6及Mysql5.7部署于Tomcat8.0/9.0浏览器兼容谷歌、Edge与火狐。压缩包共422个文件约9.14MB其中107个java文件承载后端业务逻辑44个vue与21个js文件构成前端交互界面另有大量svg、jpg、png等静态资源及xml、yml、properties等配置文件源码均经过严格测试可放心下载使用。目前已有61人学习关注。读者可从中获得完整的学籍管理项目结构、前后端分离实现思路与数据库设计参考便于快速理解SpringBoot项目开发流程遇到问题也可与作者沟通获取解答。1. 从一份能跑起来的 Java 在线学籍系统代码说起如果你正在做课程设计、毕业设计或者公司内部要快速搭一套学籍管理后台大概率绕不开「在线学籍系统」这个题目。它听起来简单——学生、班级、成绩、课程几张表而已但真正动手时你会发现权限怎么分、学籍状态怎么流转、成绩和课程怎么关联全是细节。我手上这份基于 SpringBoot 的 Java 在线学籍系统代码就是把这些细节都落成了可运行的模块学生信息 CRUD、班级院系管理、课程与成绩录入、角色权限控制、分页查询和条件检索都有对应实现。它适合三类人刚学完 Java 基础想找个完整项目练手的同学需要交课程设计但不想从零搭框架的开发者以及想参考一套标准分层写法Controller-Service-Mapper的后端新人。下面我按「能跑起来 → 能改明白 → 不踩坑」的顺序拆一遍。2. 环境与依赖把 SpringBoot 学籍系统在本地跑起来2.1 技术栈选型与版本对齐这套代码的技术栈是典型的 SpringBoot MyBatis-Plus MySQL Thymeleaf或前后端分离时的 Vue视具体分支而定。选它的理由很直接MyBatis-Plus 自带通用 Mapper 和分页插件学籍系统里大量重复的单表增删改查不用手写 SQL省掉一半体力活SpringBoot 的自动装配让数据源、事务、拦截器配置集中在一个application.yml里改数据库连接不用翻 XML。在动手之前先把版本对齐这件事做掉这是最容易翻车的地方。常见做法是组件建议版本说明JDK8 或 11代码里若用了var或新 API 则需 11SpringBoot2.5.x ~ 2.7.x2.7 之后部分配置项改名注意spring.datasource前缀MyBatis-Plus3.5.x与 SpringBoot 2.7 搭配稳定MySQL5.7 或 8.08.0 需注意驱动类名和时区参数Maven3.6用于拉依赖和打包提示不要盲目把 SpringBoot 升到 3.x3.x 要求 JDK 17 且把javax.*换成了jakarta.*这份代码里的实体注解和拦截器大概率要跟着改新手容易卡在启动报错上。2.2 数据库建表与初始化数据学籍系统的核心表通常包括student学生、class班级、department院系、course课程、score成绩、user登录用户。建表时有两个参数必须想清楚主键策略和逻辑删除字段。CREATE TABLE student ( id BIGINT NOT NULL AUTO_INCREMENT COMMENT 主键, student_no VARCHAR(20) NOT NULL COMMENT 学号唯一, name VARCHAR(50) NOT NULL COMMENT 姓名, gender TINYINT DEFAULT 1 COMMENT 1男 2女, class_id BIGINT DEFAULT NULL COMMENT 所属班级, status TINYINT DEFAULT 1 COMMENT 1在读 2休学 3毕业, deleted TINYINT DEFAULT 0 COMMENT 逻辑删除 0未删 1已删, create_time DATETIME DEFAULT CURRENT_TIMESTAMP, PRIMARY KEY (id), UNIQUE KEY uk_student_no (student_no) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT学生表;这段 SQL 里student_no加了唯一索引防止重复录入学号status用 tinyint 而不是字符串查询和统计更快deleted是给 MyBatis-Plus 逻辑删除用的配置后deleteById实际执行的是 update。初始化数据建议至少插一个管理员账号和两个班级否则登录进去后页面全是空的没法验证关联查询。2.3 配置文件与启动验证application.yml里几个关键项server: port: 8080 spring: datasource: url: jdbc:mysql://localhost:3306/school_system?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/Shanghai username: root password: 你的密码 driver-class-name: com.mysql.cj.jdbc.Driver mybatis-plus: global-config: db-config: logic-delete-field: deleted logic-delete-value: 1 logic-not-delete-value: 0 configuration: map-underscore-to-camel-case: trueserverTimezone不写会报时区错误这是 MySQL 8.0 的经典坑map-underscore-to-camel-case打开后数据库的student_no能自动映射到实体类的studentNo省掉一堆Results注解。启动类跑起来后访问http://localhost:8080能看到登录页用初始化数据里的账号登录能进主页并加载出学生列表就说明环境通了。3. 核心模块拆解学籍 CRUD、分页检索与权限拦截3.1 实体与 Mapper 层的通用写法MyBatis-Plus 的实体类用TableName指定表名主键用TableId。学籍系统里学生和班级是一对多成绩和课程是多对多实体设计时不要图省事把关联字段全塞一张表。Data TableName(student) public class Student { TableId(type IdType.AUTO) private Long id; private String studentNo; private String name; private Integer gender; private Long classId; private Integer status; TableLogic private Integer deleted; }TableLogic加在deleted字段上配合 yml 里的全局配置删除操作自动变逻辑删除。Mapper 接口只需继承BaseMapperStudent单表 CRUD 全部白送。这里有个血泪经验如果实体字段名和数据库列名对不上又没开驼峰映射查询结果里那个字段永远是 null排查半天以为是 SQL 写错了其实是映射没配。3.2 分页与条件检索的实现学籍系统最常用的功能就是「按姓名/学号/班级筛选 分页」。MyBatis-Plus 的分页需要先注册拦截器否则Page对象查出来的是全量数据。Configuration public class MybatisPlusConfig { Bean public MybatisPlusInterceptor mybatisPlusInterceptor() { MybatisPlusInterceptor interceptor new MybatisPlusInterceptor(); interceptor.addInnerInterceptor(new PaginationInnerInterceptor(DbType.MYSQL)); return interceptor; } }Service 层构造查询条件public IPageStudent pageQuery(int pageNum, int pageSize, String keyword, Long classId) { LambdaQueryWrapperStudent wrapper new LambdaQueryWrapper(); if (StringUtils.hasText(keyword)) { wrapper.and(w - w.like(Student::getName, keyword) .or().like(Student::getStudentNo, keyword)); } if (classId ! null) { wrapper.eq(Student::getClassId, classId); } wrapper.orderByDesc(Student::getCreateTime); return studentMapper.selectPage(new Page(pageNum, pageSize), wrapper); }LambdaQueryWrapper的好处是字段用方法引用写改字段名时编译期就能发现不会出现字符串写错导致运行时报错。and(w - ...)包一层是为了让 or 条件整体和后面的 eq 用 AND 连接不包的话条件优先级会乱查出来的数据对不上这个坑我在好几个项目里都见过。3.3 登录与角色权限拦截学籍系统一般分管理员、教师、学生三种角色。权限控制用 Spring 拦截器 Session 是最轻量的做法不必上 Spring Security配置复杂新手容易劝退。public class LoginInterceptor implements HandlerInterceptor { Override public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception { Object user request.getSession().getAttribute(loginUser); if (user null) { response.sendRedirect(/login); return false; } return true; } }注册拦截器时用addPathPatterns(/**).excludePathPatterns(/login, /css/**, /js/**)把登录页和静态资源放行。角色级别的控制可以在拦截器里再判断 Session 里存的 role 字段或者用自定义注解 AOP。常见做法是管理员能改所有数据教师只能录成绩学生只能查自己的。这里要注意前端隐藏按钮不等于安全后端每个写操作都要再校验一次角色否则改个 URL 就能越权。4. 避坑与排查学籍系统跑不起来时先看这几条4.1 启动报数据源或驱动错误现象启动时抛Failed to configure a DataSource或No suitable driver found。原因通常是 yml 里 url 拼写错误、驱动依赖没引入或者 MySQL 8.0 用了旧驱动类名com.mysql.jdbc.Driver。解决确认pom.xml里有mysql-connector-java依赖驱动类写成com.mysql.cj.jdbc.Driverurl 带上serverTimezone。4.2 分页查出来是全量数据现象传了 pageNum 和 pageSize但返回的记录数等于表里总数。原因没注册PaginationInnerInterceptor或者注册了但被其他拦截器顺序覆盖。解决检查配置类是否被 Spring 扫描到拦截器添加顺序上分页拦截器要放在最后。4.3 逻辑删除后数据还在现象调用删除接口列表里记录还在。原因TableLogic没加或者 yml 里logic-delete-field配的字段名和实体不一致。解决两处对齐字段名统一用deleted值 0/1 与配置一致。4.4 中文乱码现象录入的学生姓名在数据库里显示为问号。原因数据库字符集不是 utf8mb4或连接 url 没带characterEncodingutf8。解决建库时指定CHARACTER SET utf8mb4url 补上编码参数已建的表用ALTER TABLE ... CONVERT TO CHARACTER SET utf8mb4修正。4.5 登录后静态资源 404现象登录页样式全丢控制台报 css/js 404。原因拦截器把静态资源路径也拦了或者 SpringBoot 静态资源默认目录放错。解决拦截器excludePathPatterns放行/static/**、/css/**、/js/**资源文件放在src/main/resources/static下。5. 二次开发技巧把学籍系统改成你自己的样子代码能跑之后真正的价值在于改。这里说几个我常用的进阶操作。第一导出功能。学籍数据经常要导成 Excel 交给教务用 EasyExcel 最省事实体上加ExcelProperty(学号)注解Controller 里写一个EasyExcel.write(response.getOutputStream(), Student.class).sheet(学生).doWrite(list)浏览器直接下载。注意响应头要设Content-Disposition否则文件名乱码。第二学籍状态流转。在读、休学、毕业之间的切换不要直接 update status 字段建议单独建一张status_log表记录每次变更的时间和操作人将来查「这个学生什么时候休学的」有据可查。第三成绩统计。用 MyBatis-Plus 的selectMaps配合QueryWrapper的groupBy做班级平均分比在 Java 里循环累加快得多。QueryWrapperScore qw new QueryWrapper(); qw.select(class_id, AVG(score) as avg_score, COUNT(*) as cnt) .groupBy(class_id); ListMapString, Object stats scoreMapper.selectMaps(qw);验证改动是否生效我习惯先跑单元测试测 Service 层再用 Postman 打接口最后才开浏览器点页面。三层都过一遍基本不会出现「页面看着对、数据其实错」的玄学问题。从那以后我每次拿到一套新代码都强制先跑通登录和一条完整 CRUD 链路再动任何业务逻辑——这个习惯帮我省掉了大量返工。希望这份拆解能帮到你代码包里的注释和 SQL 脚本照着走一遍基本就能落地成自己的学籍系统了。本文还有配套的精品资源点击获取 SpringBoot在线学籍系统实战：从环境搭建到二次开发全解析
简介这是一套基于SpringBoot的在线学籍系统完整源码面向计算机、电子信息工程等专业的学习者可作为高分毕业设计、课程设计或期末大作业的参考方案。项目采用B/S与MVC架构技术栈涵盖Java、SpringBoot、Mybatis、Ajax、Vue、Mysql与Maven开发环境为IDEA、JDK1.8、Maven3.6及Mysql5.7部署于Tomcat8.0/9.0浏览器兼容谷歌、Edge与火狐。压缩包共422个文件约9.14MB其中107个java文件承载后端业务逻辑44个vue与21个js文件构成前端交互界面另有大量svg、jpg、png等静态资源及xml、yml、properties等配置文件源码均经过严格测试可放心下载使用。目前已有61人学习关注。读者可从中获得完整的学籍管理项目结构、前后端分离实现思路与数据库设计参考便于快速理解SpringBoot项目开发流程遇到问题也可与作者沟通获取解答。1. 从一份能跑起来的 Java 在线学籍系统代码说起如果你正在做课程设计、毕业设计或者公司内部要快速搭一套学籍管理后台大概率绕不开「在线学籍系统」这个题目。它听起来简单——学生、班级、成绩、课程几张表而已但真正动手时你会发现权限怎么分、学籍状态怎么流转、成绩和课程怎么关联全是细节。我手上这份基于 SpringBoot 的 Java 在线学籍系统代码就是把这些细节都落成了可运行的模块学生信息 CRUD、班级院系管理、课程与成绩录入、角色权限控制、分页查询和条件检索都有对应实现。它适合三类人刚学完 Java 基础想找个完整项目练手的同学需要交课程设计但不想从零搭框架的开发者以及想参考一套标准分层写法Controller-Service-Mapper的后端新人。下面我按「能跑起来 → 能改明白 → 不踩坑」的顺序拆一遍。2. 环境与依赖把 SpringBoot 学籍系统在本地跑起来2.1 技术栈选型与版本对齐这套代码的技术栈是典型的 SpringBoot MyBatis-Plus MySQL Thymeleaf或前后端分离时的 Vue视具体分支而定。选它的理由很直接MyBatis-Plus 自带通用 Mapper 和分页插件学籍系统里大量重复的单表增删改查不用手写 SQL省掉一半体力活SpringBoot 的自动装配让数据源、事务、拦截器配置集中在一个application.yml里改数据库连接不用翻 XML。在动手之前先把版本对齐这件事做掉这是最容易翻车的地方。常见做法是组件建议版本说明JDK8 或 11代码里若用了var或新 API 则需 11SpringBoot2.5.x ~ 2.7.x2.7 之后部分配置项改名注意spring.datasource前缀MyBatis-Plus3.5.x与 SpringBoot 2.7 搭配稳定MySQL5.7 或 8.08.0 需注意驱动类名和时区参数Maven3.6用于拉依赖和打包提示不要盲目把 SpringBoot 升到 3.x3.x 要求 JDK 17 且把javax.*换成了jakarta.*这份代码里的实体注解和拦截器大概率要跟着改新手容易卡在启动报错上。2.2 数据库建表与初始化数据学籍系统的核心表通常包括student学生、class班级、department院系、course课程、score成绩、user登录用户。建表时有两个参数必须想清楚主键策略和逻辑删除字段。CREATE TABLE student ( id BIGINT NOT NULL AUTO_INCREMENT COMMENT 主键, student_no VARCHAR(20) NOT NULL COMMENT 学号唯一, name VARCHAR(50) NOT NULL COMMENT 姓名, gender TINYINT DEFAULT 1 COMMENT 1男 2女, class_id BIGINT DEFAULT NULL COMMENT 所属班级, status TINYINT DEFAULT 1 COMMENT 1在读 2休学 3毕业, deleted TINYINT DEFAULT 0 COMMENT 逻辑删除 0未删 1已删, create_time DATETIME DEFAULT CURRENT_TIMESTAMP, PRIMARY KEY (id), UNIQUE KEY uk_student_no (student_no) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT学生表;这段 SQL 里student_no加了唯一索引防止重复录入学号status用 tinyint 而不是字符串查询和统计更快deleted是给 MyBatis-Plus 逻辑删除用的配置后deleteById实际执行的是 update。初始化数据建议至少插一个管理员账号和两个班级否则登录进去后页面全是空的没法验证关联查询。2.3 配置文件与启动验证application.yml里几个关键项server: port: 8080 spring: datasource: url: jdbc:mysql://localhost:3306/school_system?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/Shanghai username: root password: 你的密码 driver-class-name: com.mysql.cj.jdbc.Driver mybatis-plus: global-config: db-config: logic-delete-field: deleted logic-delete-value: 1 logic-not-delete-value: 0 configuration: map-underscore-to-camel-case: trueserverTimezone不写会报时区错误这是 MySQL 8.0 的经典坑map-underscore-to-camel-case打开后数据库的student_no能自动映射到实体类的studentNo省掉一堆Results注解。启动类跑起来后访问http://localhost:8080能看到登录页用初始化数据里的账号登录能进主页并加载出学生列表就说明环境通了。3. 核心模块拆解学籍 CRUD、分页检索与权限拦截3.1 实体与 Mapper 层的通用写法MyBatis-Plus 的实体类用TableName指定表名主键用TableId。学籍系统里学生和班级是一对多成绩和课程是多对多实体设计时不要图省事把关联字段全塞一张表。Data TableName(student) public class Student { TableId(type IdType.AUTO) private Long id; private String studentNo; private String name; private Integer gender; private Long classId; private Integer status; TableLogic private Integer deleted; }TableLogic加在deleted字段上配合 yml 里的全局配置删除操作自动变逻辑删除。Mapper 接口只需继承BaseMapperStudent单表 CRUD 全部白送。这里有个血泪经验如果实体字段名和数据库列名对不上又没开驼峰映射查询结果里那个字段永远是 null排查半天以为是 SQL 写错了其实是映射没配。3.2 分页与条件检索的实现学籍系统最常用的功能就是「按姓名/学号/班级筛选 分页」。MyBatis-Plus 的分页需要先注册拦截器否则Page对象查出来的是全量数据。Configuration public class MybatisPlusConfig { Bean public MybatisPlusInterceptor mybatisPlusInterceptor() { MybatisPlusInterceptor interceptor new MybatisPlusInterceptor(); interceptor.addInnerInterceptor(new PaginationInnerInterceptor(DbType.MYSQL)); return interceptor; } }Service 层构造查询条件public IPageStudent pageQuery(int pageNum, int pageSize, String keyword, Long classId) { LambdaQueryWrapperStudent wrapper new LambdaQueryWrapper(); if (StringUtils.hasText(keyword)) { wrapper.and(w - w.like(Student::getName, keyword) .or().like(Student::getStudentNo, keyword)); } if (classId ! null) { wrapper.eq(Student::getClassId, classId); } wrapper.orderByDesc(Student::getCreateTime); return studentMapper.selectPage(new Page(pageNum, pageSize), wrapper); }LambdaQueryWrapper的好处是字段用方法引用写改字段名时编译期就能发现不会出现字符串写错导致运行时报错。and(w - ...)包一层是为了让 or 条件整体和后面的 eq 用 AND 连接不包的话条件优先级会乱查出来的数据对不上这个坑我在好几个项目里都见过。3.3 登录与角色权限拦截学籍系统一般分管理员、教师、学生三种角色。权限控制用 Spring 拦截器 Session 是最轻量的做法不必上 Spring Security配置复杂新手容易劝退。public class LoginInterceptor implements HandlerInterceptor { Override public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception { Object user request.getSession().getAttribute(loginUser); if (user null) { response.sendRedirect(/login); return false; } return true; } }注册拦截器时用addPathPatterns(/**).excludePathPatterns(/login, /css/**, /js/**)把登录页和静态资源放行。角色级别的控制可以在拦截器里再判断 Session 里存的 role 字段或者用自定义注解 AOP。常见做法是管理员能改所有数据教师只能录成绩学生只能查自己的。这里要注意前端隐藏按钮不等于安全后端每个写操作都要再校验一次角色否则改个 URL 就能越权。4. 避坑与排查学籍系统跑不起来时先看这几条4.1 启动报数据源或驱动错误现象启动时抛Failed to configure a DataSource或No suitable driver found。原因通常是 yml 里 url 拼写错误、驱动依赖没引入或者 MySQL 8.0 用了旧驱动类名com.mysql.jdbc.Driver。解决确认pom.xml里有mysql-connector-java依赖驱动类写成com.mysql.cj.jdbc.Driverurl 带上serverTimezone。4.2 分页查出来是全量数据现象传了 pageNum 和 pageSize但返回的记录数等于表里总数。原因没注册PaginationInnerInterceptor或者注册了但被其他拦截器顺序覆盖。解决检查配置类是否被 Spring 扫描到拦截器添加顺序上分页拦截器要放在最后。4.3 逻辑删除后数据还在现象调用删除接口列表里记录还在。原因TableLogic没加或者 yml 里logic-delete-field配的字段名和实体不一致。解决两处对齐字段名统一用deleted值 0/1 与配置一致。4.4 中文乱码现象录入的学生姓名在数据库里显示为问号。原因数据库字符集不是 utf8mb4或连接 url 没带characterEncodingutf8。解决建库时指定CHARACTER SET utf8mb4url 补上编码参数已建的表用ALTER TABLE ... CONVERT TO CHARACTER SET utf8mb4修正。4.5 登录后静态资源 404现象登录页样式全丢控制台报 css/js 404。原因拦截器把静态资源路径也拦了或者 SpringBoot 静态资源默认目录放错。解决拦截器excludePathPatterns放行/static/**、/css/**、/js/**资源文件放在src/main/resources/static下。5. 二次开发技巧把学籍系统改成你自己的样子代码能跑之后真正的价值在于改。这里说几个我常用的进阶操作。第一导出功能。学籍数据经常要导成 Excel 交给教务用 EasyExcel 最省事实体上加ExcelProperty(学号)注解Controller 里写一个EasyExcel.write(response.getOutputStream(), Student.class).sheet(学生).doWrite(list)浏览器直接下载。注意响应头要设Content-Disposition否则文件名乱码。第二学籍状态流转。在读、休学、毕业之间的切换不要直接 update status 字段建议单独建一张status_log表记录每次变更的时间和操作人将来查「这个学生什么时候休学的」有据可查。第三成绩统计。用 MyBatis-Plus 的selectMaps配合QueryWrapper的groupBy做班级平均分比在 Java 里循环累加快得多。QueryWrapperScore qw new QueryWrapper(); qw.select(class_id, AVG(score) as avg_score, COUNT(*) as cnt) .groupBy(class_id); ListMapString, Object stats scoreMapper.selectMaps(qw);验证改动是否生效我习惯先跑单元测试测 Service 层再用 Postman 打接口最后才开浏览器点页面。三层都过一遍基本不会出现「页面看着对、数据其实错」的玄学问题。从那以后我每次拿到一套新代码都强制先跑通登录和一条完整 CRUD 链路再动任何业务逻辑——这个习惯帮我省掉了大量返工。希望这份拆解能帮到你代码包里的注释和 SQL 脚本照着走一遍基本就能落地成自己的学籍系统了。本文还有配套的精品资源点击获取 RELATED READING
延伸阅读
更多一线实战笔记与深度复盘，助您持续精进
