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> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-parent</artifactId> <version>2.7.6</version> <!-- 版本决定 JDK 下限，2.7.x 建议 JDK 8/11 --> </parent> <properties> <java.version>1.8</java.version> <!-- 编译版本，和本机 JDK 对齐 --> </properties> <dependency> <groupId>mysql</groupId> <artifactId>mysql-connector-java</artifactId> <version>8.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?useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai&useSSL=false username: root password: 你的密码 driver-class-name: com.mysql.cj.jdbc.Driver server: port: 8080

逻辑说明：serverTimezone=Asia/Shanghai是 8.x 驱动的必填项，不写会报The server time zone value is unrecognized。useSSL=false在本地开发关掉，避免证书警告。driver-class-name用com.mysql.cj.jdbc.Driver，这是 8.x 的新类名，老教程里的com.mysql.jdbc.Driver已经废弃。端口 8080 如果被占用，改成 8081 即可，但前端页面里如果有硬编码的接口地址，记得同步改。

提示：改完配置先别急着跑，用mvn clean compile单独编译一次，编译能过再启动，能把「依赖缺失」和「配置错误」两类问题分开定位。

3. 核心业务表设计与考勤逻辑：数据库增删改查怎么落地

跑起来只是第一步，真正决定这套系统好不好用的是表结构和考勤判定逻辑。这部分是二次开发改动最多的地方，理解透了才能按自己学校的需求改。

3.1 四张核心表的关系与字段设计

一份靠谱的考勤系统，表设计基本围绕「人、课、关系、记录」展开。下面是我从这类项目里总结出的通用结构，字段名可能和你的源码略有出入，但关系是一致的。

逻辑说明：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 id="insertRecord" parameterType="com.example.entity.AttendanceRecord"> INSERT INTO attendance_record (student_id, course_id, status, record_time) VALUES (#{studentId}, #{courseId}, #{status}, NOW()) </insert> // 查询某学生某课程的全部考勤 <select id="selectByStudentAndCourse" resultType="com.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 'root'@'localhost'现象是 SpringBoot 启动时连不上数据库。原因通常是application.yml里的密码写错，或者 MySQL 8 的 root 用户默认用了caching_sha2_password认证插件，老驱动不认。解决办法：先确认密码无误，再执行ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY '你的密码';把认证方式改回兼容模式，然后刷新权限。

坑二：页面中文全是乱码现象是学生姓名、课程名显示成问号或方块。原因是数据库、连接串、表三处字符集不统一。解决：数据库建库时用utf8mb4，连接串加characterEncoding=utf8，建表语句末尾加DEFAULT CHARSET=utf8mb4，三处对齐后重启。

坑三：考勤时间比实际早或晚 8 小时现象是打卡记录时间对不上。原因是时区没统一，数据库存 UTC、Java 取本地时间。解决：连接串加serverTimezone=Asia/Shanghai，JVM 启动参数加-Duser.timezone=Asia/Shanghai，两处都设，别只设一处。

坑四：改了代码重启不生效现象是改了 Mapper 或页面，重启后还是老样子。原因是 IDEA 没重新编译，或者target目录里有旧 class。解决：执行mvn clean清掉 target 再启动，IDEA 里开Build Project Automatically，改完手动Ctrl+F9编译一次。

坑五：分页查询总数不对现象是列表分页显示总条数错误。原因是 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 和一个时间戳签名，后端校验签名和时间窗口。验证方法：用手机扫生成的码，看是否能在有效期内成功写入记录，过期后是否被拒绝。

我自己的习惯是：每改一个功能，先在数据库里手动造几条边界数据（比如刚好卡在迟到阈值那一分钟的记录），跑一遍看结果对不对，再上页面点。这套源码最大的价值不是它本身多完善，而是它给了你一个能跑、能改、能验证的完整骨架。把上面这些坑趟平，你对 SpringBoot 项目落地的理解会比看十篇教程都扎实。希望帮到你。

本文还有配套的精品资源，点击获取