SpringBoot学生考勤管理系统源码实战：环境搭建、数据库导入与二次开发

简介这份资源是一套基于SpringBoot开发的学生考勤管理系统完整源码包面向计算机专业毕业设计学生及需要Java Web实战项目的开发者可帮助解决选题落地、系统搭建与功能实现等实际问题。压缩包共426个文件约9.31MB以107个Java后端源码、43个Vue前端组件、161个svg图标资源为主另含xml配置、js脚本、sql数据库脚本及少量图片与样式文件前后端分离结构清晰。系统涵盖登录注册、学生与教师管理、班级课程信息维护、签到与考勤记录、请假审批及考勤统计等模块管理员可对各项数据进行详细操作学生可按学号、年级、专业、班级等信息完成注册。目前已有694人学习下载适合作为毕业设计参考或课程项目模板读者可据此快速理解SpringBoot与Vue的整合方式、数据库表结构设计及权限角色控制思路并在此基础上进行二次开发与功能扩展。1. 从一份 SpringBoot 学生考勤管理系统的源码包说起它到底能解决什么如果你手头正好有一份「基于 SpringBoot 开发的学生考勤管理系统源码数据库」的压缩包第一反应大概率是这东西能不能直接跑起来、数据库怎么导入、SpringBoot 配置要改哪几处、能不能改成自己学校的场景。我带过的几个课程设计和二次开发项目里这类系统是最典型的「麻雀虽小五脏俱全」——它同时踩中了 SpringBoot 项目、MySQL 数据库增删改查、权限控制、报表统计这几条主线跑通一遍等于把 Java Web 后端最核心的一条链路走完了。它适合三类人一是做课程设计、需要一份能讲清楚架构的完整项目二是刚学完 SpringBoot 想找一个真实业务练手的人三是想拿它当模板改成公司内部考勤、社团签到、实验室打卡的开发者。核心要解决的问题就一个把「谁、在哪节课、到没到、迟到还是早退」这件事用数据库记录清楚并且能按班级、按课程、按时间段查出来。下面我按实际落地的顺序把这份源码从环境搭建到二次开发讲透。2. 环境搭建与数据库导入让 SpringBoot 项目在本地跑起来拿到源码包后别急着点运行。这类项目 90% 的启动失败都出在环境和数据库上先把地基打牢后面能省掉大量排查时间。2.1 先看清源码包的目录结构和依赖版本解压之后典型结构是src/main/java放后端代码、src/main/resources放配置和静态页面、根目录一个pom.xml。先打开pom.xml看三样东西SpringBoot 父版本、MySQL 驱动版本、JDK 编译版本。这一步很关键因为「springboot 版本太高」是热搜里反复出现的问题——高版本 SpringBoot 对 JDK 和部分依赖有硬性要求盲目升级会连环报错。!-- pom.xml 关键片段先确认这三处 -- parent groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-parent/artifactId version2.7.6/version !-- 版本决定 JDK 下限2.7.x 建议 JDK 8/11 -- /parent properties java.version1.8/java.version !-- 编译版本和本机 JDK 对齐 -- /properties dependency groupIdmysql/groupId artifactIdmysql-connector-java/artifactId version8.0.30/version !-- 8.x 驱动要配时区参数 -- /dependency逻辑说明spring-boot-starter-parent是版本仲裁中心它管着一大堆依赖的默认版本所以父版本不能乱改。参数上java.version必须和你本机装的 JDK 一致本机是 JDK 8 就写 1.8是 17 就写 17否则编译期就报invalid target release。MySQL 驱动 8.x 和 5.x 的差别很大8.x 必须带时区参数这个下面配置里会讲。2.2 用 Navicat 或命令行导入数据库脚本源码包里一般有个sql文件夹里面是.sql建表和数据脚本。导入方式两种图形化用 Navicat命令行用 mysql 客户端。我一般先用命令行确认脚本没问题再上图形工具。# 1. 登录 MySQL假设 root 用户 mysql -u root -p # 2. 创建数据库字符集必须是 utf8mb4否则中文姓名会乱码 CREATE DATABASE attendance_db DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; # 3. 切换到该库 USE attendance_db; # 4. 导入脚本在 mysql 客户端里用 source路径写绝对路径 source /Users/yourname/attendance/sql/attendance.sql; # 5. 验证表是否建好 SHOW TABLES;逻辑说明utf8mb4而不是utf8是因为 MySQL 的utf8实际只支持 3 字节存不下某些生僻字和 emoji学生姓名里偶尔会遇到。source命令后面必须跟绝对路径相对路径在客户端里经常找不到文件。导入完SHOW TABLES应该能看到student、teacher、course、attendance_record这类表如果只有一两张说明脚本中途报错了往上翻看错误行。2.3 改 application.yml 里的数据库连接和端口配置文件通常在src/main/resources/application.yml或application.properties。要改的就四处数据库地址、用户名、密码、时区。spring: datasource: url: jdbc:mysql://localhost:3306/attendance_db?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/ShanghaiuseSSLfalse username: root password: 你的密码 driver-class-name: com.mysql.cj.jdbc.Driver server: port: 8080逻辑说明serverTimezoneAsia/Shanghai是 8.x 驱动的必填项不写会报The server time zone value is unrecognized。useSSLfalse在本地开发关掉避免证书警告。driver-class-name用com.mysql.cj.jdbc.Driver这是 8.x 的新类名老教程里的com.mysql.jdbc.Driver已经废弃。端口 8080 如果被占用改成 8081 即可但前端页面里如果有硬编码的接口地址记得同步改。提示改完配置先别急着跑用mvn clean compile单独编译一次编译能过再启动能把「依赖缺失」和「配置错误」两类问题分开定位。3. 核心业务表设计与考勤逻辑数据库增删改查怎么落地跑起来只是第一步真正决定这套系统好不好用的是表结构和考勤判定逻辑。这部分是二次开发改动最多的地方理解透了才能按自己学校的需求改。3.1 四张核心表的关系与字段设计一份靠谱的考勤系统表设计基本围绕「人、课、关系、记录」展开。下面是我从这类项目里总结出的通用结构字段名可能和你的源码略有出入但关系是一致的。表名作用关键字段关联关系student学生信息id, student_no, name, class_idclass_id 关联班级teacher教师信息id, teacher_no, name独立表course课程信息id, course_name, teacher_idteacher_id 关联教师attendance_record考勤记录id, student_id, course_id, status, record_time双外键关联逻辑说明attendance_record是核心表status字段一般用枚举值存状态比如 0 正常、1 迟到、2 早退、3 缺勤。用数字而不是中文查询和统计时效率更高。record_time存打卡时间戳配合课程表里的上课时间才能算出迟到与否。这里有个常见设计缺陷很多源码把上课时间直接写死在代码里正确做法是放在course表加start_time、end_time字段否则换个课表就得改代码。3.2 用 MyBatis 写考勤记录的增删改查这类项目持久层大多用 MyBatis 或 MyBatis-Plus。以 MyBatis 为例一条「新增考勤记录」的链路是 Controller 收参数、Service 做业务判断、Mapper 落库。// AttendanceMapper.xml 中的插入语句 insert idinsertRecord parameterTypecom.example.entity.AttendanceRecord INSERT INTO attendance_record (student_id, course_id, status, record_time) VALUES (#{studentId}, #{courseId}, #{status}, NOW()) /insert // 查询某学生某课程的全部考勤 select idselectByStudentAndCourse resultTypecom.example.entity.AttendanceRecord SELECT * FROM attendance_record WHERE student_id #{studentId} AND course_id #{courseId} ORDER BY record_time DESC /select逻辑说明#{studentId}是预编译占位符能防 SQL 注入别用${}拼接。NOW()让数据库生成时间比在 Java 里new Date()更可靠避免服务器时区不一致。ORDER BY record_time DESC保证最新记录在前前端列表直接展示即可。参数上parameterType和resultType要写全类名写错会报ClassNotFoundException。3.3 考勤状态判定迟到早退到底怎么算这是业务逻辑的核心也是最容易出玄学 bug 的地方。判定逻辑应该放在 Service 层而不是塞进 SQL。public int judgeStatus(LocalDateTime checkTime, LocalDateTime courseStart) { // 上课前 10 分钟内算正常超过 10 分钟算迟到 if (checkTime.isBefore(courseStart.plusMinutes(10))) { return 0; // 正常 } else if (checkTime.isBefore(courseStart.plusMinutes(30))) { return 1; // 迟到 } else { return 3; // 缺勤 } }逻辑说明用LocalDateTime而不是老的Date因为它的时间加减更直观plusMinutes直接加分钟。参数上10 分钟和 30 分钟这两个阈值应该抽成配置项别硬编码不同学校宽限期不一样。这里有个血泪经验判定用的courseStart必须和打卡时间来自同一时区如果数据库存的是 UTC、Java 取的是本地时间会出现「明明没迟到却判迟到」的翻车现场统一用Asia/Shanghai最省心。4. 权限控制与接口安全别让考勤数据被随便改考勤数据涉及学生切身利益谁能改、能改哪些必须有控制。这类源码包里的权限实现参差不齐有的只做了登录有的连登录都形同虚设二次开发时这块必须补强。4.1 基于角色的登录拦截学生、教师、管理员三权分立常见做法是用 Spring 拦截器或 Spring Security。轻量项目用拦截器 Session 就够了不必上 Security 那么重。public class LoginInterceptor implements HandlerInterceptor { Override public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception { HttpSession session request.getSession(); Object user session.getAttribute(loginUser); if (user null) { response.sendRedirect(/login); // 未登录跳登录页 return false; } return true; } }逻辑说明preHandle在 Controller 执行前拦截session.getAttribute拿登录态。参数上拦截器要注册到WebMvcConfigurer里并配置addPathPatterns和excludePathPatterns把登录页、静态资源排除掉否则会死循环跳转。角色区分可以在拦截器里再判断user.getRole()学生只能查自己的记录教师能改自己课程的记录管理员全放行。4.2 防止越权改考勤接口层再校验一次归属光有登录拦截不够还得防「学生 A 改学生 B 的记录」这种越权。做法是在 Service 层校验数据归属。public void updateRecord(Long recordId, Long currentUserId, String role) { AttendanceRecord record recordMapper.selectById(recordId); if (student.equals(role) !record.getStudentId().equals(currentUserId)) { throw new RuntimeException(无权修改他人考勤); } // 教师只能改自己课程的记录逻辑类似 recordMapper.updateById(record); }逻辑说明先查记录再比对当前用户身份和记录归属不匹配直接抛异常。参数上currentUserId必须从 Session 里取绝不能从前端传参否则前端改个 id 就能越权。这是很多课程设计源码的通病——权限只做在页面上接口裸奔用 Postman 直接调就能改数据。注意热搜里提到的「全局过滤器处理上传文件 XSS 攻击」在这里同样适用。考勤系统如果有备注、请假理由这类文本输入一定要做转义或过滤否则存进去的脚本会在列表页执行。5. 避坑与排查跑这套源码时最容易翻车的五个地方这一章是我带项目时踩过的坑合集每条都按「现象 → 原因 → 解决」写遇到问题直接对号入座。坑一启动报Access denied for user rootlocalhost现象是 SpringBoot 启动时连不上数据库。原因通常是application.yml里的密码写错或者 MySQL 8 的 root 用户默认用了caching_sha2_password认证插件老驱动不认。解决办法先确认密码无误再执行ALTER USER rootlocalhost IDENTIFIED WITH mysql_native_password BY 你的密码;把认证方式改回兼容模式然后刷新权限。坑二页面中文全是乱码现象是学生姓名、课程名显示成问号或方块。原因是数据库、连接串、表三处字符集不统一。解决数据库建库时用utf8mb4连接串加characterEncodingutf8建表语句末尾加DEFAULT CHARSETutf8mb4三处对齐后重启。坑三考勤时间比实际早或晚 8 小时现象是打卡记录时间对不上。原因是时区没统一数据库存 UTC、Java 取本地时间。解决连接串加serverTimezoneAsia/ShanghaiJVM 启动参数加-Duser.timezoneAsia/Shanghai两处都设别只设一处。坑四改了代码重启不生效现象是改了 Mapper 或页面重启后还是老样子。原因是 IDEA 没重新编译或者target目录里有旧 class。解决执行mvn clean清掉 target 再启动IDEA 里开Build Project Automatically改完手动CtrlF9编译一次。坑五分页查询总数不对现象是列表分页显示总条数错误。原因是 MyBatis 分页插件没配或配错。解决如果用 PageHelper确认PageHelper.startPage(pageNum, pageSize)紧挨着查询语句中间不能插别的查询如果用 MyBatis-Plus确认分页拦截器PaginationInnerInterceptor已注册到配置类。6. 二次开发进阶把通用考勤系统改成你自己的场景跑通之后真正有价值的是按自己需求改造。这里给三个我实际做过的改造方向附上验证方法。第一个方向是加「请假审批流」。学生提交请假申请教师审批审批通过后对应时段自动标记为请假而非缺勤。实现上可以引入 Flowable 或 Activiti但轻量场景用一张leave_apply表加状态字段就够了状态流转用status从 0 待审、1 通过、2 驳回。验证方法提交一条请假教师端审批通过再查该时段考勤记录状态应变成「请假」。第二个方向是加「考勤统计报表」。按班级、按课程统计出勤率导出 Excel。用 EasyExcel 或 POI 都行核心 SQL 是分组聚合SELECT c.course_name, COUNT(*) AS total, SUM(CASE WHEN a.status 0 THEN 1 ELSE 0 END) AS normal, ROUND(SUM(CASE WHEN a.status 0 THEN 1 ELSE 0 END) / COUNT(*) * 100, 2) AS rate FROM attendance_record a JOIN course c ON a.course_id c.id GROUP BY c.course_name;逻辑说明CASE WHEN做条件计数ROUND保留两位小数算百分比。参数上如果要按时间段筛选在WHERE里加a.record_time BETWEEN #{start} AND #{end}。验证方法手动造几条不同状态的记录跑一遍 SQL看出勤率是否等于正常数除以总数。第三个方向是「扫码签到」。把课程生成一个带时效的二维码学生扫码后调接口打卡。实现上二维码里放课程 id 和一个时间戳签名后端校验签名和时间窗口。验证方法用手机扫生成的码看是否能在有效期内成功写入记录过期后是否被拒绝。改造方向涉及技术点难度验证方式请假审批流状态机、表设计中走一遍审批全流程统计报表聚合 SQL、EasyExcel低对比手算结果扫码签到二维码、签名校验高有效期内外各测一次我自己的习惯是每改一个功能先在数据库里手动造几条边界数据比如刚好卡在迟到阈值那一分钟的记录跑一遍看结果对不对再上页面点。这套源码最大的价值不是它本身多完善而是它给了你一个能跑、能改、能验证的完整骨架。把上面这些坑趟平你对 SpringBoot 项目落地的理解会比看十篇教程都扎实。希望帮到你。本文还有配套的精品资源点击获取