高校课堂考勤系统Java源码包（SSM架构，含学生签到、请假审批与课程出勤统计）

白露未晞593

199人浏览 · 2026-07-06 04:18:51

白露未晞593 · 2026-07-06 04:18:51 发布

简介：一套可直接部署运行的高校课堂考勤管理Java Web系统，基于Spring+SpringMVC+MyBatis（SSM）框架开发，后端使用JDK1.8，适配Tomcat7及以上版本，数据库采用MySQL 5.7+，前端页面全部用JSP实现。系统划分管理员、教师、学生三类角色：管理员负责维护学生/教师基础信息、课程数据，汇总查看全校考勤与请假记录；学生可登录后修改个人资料、发起在线签到和请假申请；教师能实时审核所带班级学生的请假请求，并查看每节课的签到明细与出勤率统计。功能覆盖用户登录注册、课程增删改查、学生与教师信息管理、签到操作（支持手动录入与状态标记）、请假流程（申请→审批→状态更新）、多维度考勤报表导出等。所有JSP页面命名规范清晰，如xueshengqiandao_add.jsp用于学生签到新增，jiaoshiqingjia_updt.jsp用于教师请假审批操作。配套提供完整Maven构建配置（pom.xml，兼容Maven3.3.9+）、Navicat建库SQL脚本（ssmxskqglxthsg5511zb.sql）、详细说明文档.zip，以及IDEA和Eclipse双环境支持文件（含.classpath、.project等）。开箱即用，适用于本科课程设计、毕业设计开发参考或教学场景演示。
高校课堂考勤系统这类项目，我带过不下二十届学生的课程设计和毕设指导，也帮多个二级学院做过教学信息化轻量级落地——不是那种动辄上百万的教务系统，而是真正能嵌进日常教学节奏、老师愿意点开用、学生不抵触提交的“小而准”工具。今天拆解的这套SSM考勤系统，就是我在2023年秋季学期给某省属高校信息学院《Java Web开发实践》课配套的参考案例，后来被学生自发整理成开源包流传开来。它不炫技、不堆概念，但每个模块都踩在真实教学痛点上：比如学生上课前5分钟抢签到卡顿怎么办？教师同时带3个班，怎么一眼看出哪个班缺勤率异常？请假审批流程里，学生填错课程ID导致审批流卡死怎么兜底？这些都不是文档里写的“功能列表”，而是我在机房巡课时听老师随口吐槽、在学生答辩现场记下的真实反馈。

这套系统最值得细看的，不是它用了Spring还是MyBatis，而是它如何用最朴素的技术组合，把“考勤”这件事从行政动作还原成教学行为。比如签到不是简单打钩，而是绑定具体课程、具体课次、具体教室；请假不是单向提交，而是自动关联课表、校验冲突、推送待办；统计报表不是罗列数字，而是按周/按课/按教师维度交叉下钻，连“连续3次未签到学生名单”这种预警项都预置好了。关键词里提到的“SSM考勤系统”“学生签到Java”“课堂请假审批”，其实对应着三个教学场景断点：签到是入口，解决“人在不在”的即时确认；请假是通道，解决“为什么不在”的合规留痕；统计是出口，解决“好不好管”的决策支撑。整套系统就像一个教学管理的微型神经末梢，不替代教务系统，但让每节课的出勤数据真正活起来、用得上、管得住。如果你正为课程设计发愁，或想拿个扎实的毕设项目，又或者需要一套能快速部署给任课教师试用的轻量工具——别急着改前端样式或加微信登录，先吃透它怎么用JSP+SSM把“一节课的45分钟”管明白。下面我就以一个老带教的身份，带你一层层剥开这个看似普通、实则处处有讲究的考勤系统。

1. 系统整体设计与架构选型逻辑

1.1 为什么坚持用SSM而不是Spring Boot？

现在新手一上来就Spring Boot，觉得自动配置很香，但在这类教学场景里，SSM反而是更优解。我带过的学生里，八成卡在Spring Boot的“约定大于配置”上：pom.xml里加了个starter，结果事务不生效；application.yml配了扫描路径，却漏了Mapper接口的@MapperScan；甚至有人把MyBatis的xml映射文件放错目录，报错提示全是“xxxMapper not found”，查半天才发现是resources目录没标记为Resources Root。而SSM的三层结构（Spring IOC/AOP + SpringMVC控制器 + MyBatis DAO）像一张透明网格，每个环节职责清晰——Controller只管接收参数和返回视图，Service专注业务逻辑（比如签到前校验课表状态），DAO纯粹做SQL映射。学生调试时，能清楚看到请求从DispatcherServlet进来，经HandlerMapping找到Controller方法，再调Service层，最后走SqlSession执行SQL。这种“看得见摸得着”的链路，对理解Web开发本质比写十个@RestController还管用。

更重要的是，SSM对Tomcat和JDK版本的兼容性极强。这套系统明确要求JDK1.8 + Tomcat7+，不是技术保守，而是现实倒逼：很多高校机房服务器还是CentOS6.5 + Tomcat7.0.96的老环境，连JDK11都不支持。Spring Boot 2.7.x最低要求JDK11，硬上等于把项目锁死在个人电脑。而SSM用web.xml手动配置ContextLoaderListener和DispatcherServlet，所有初始化过程明明白白写在XML里，运维老师照着文档改两行就能部署。我亲眼见过某学院用这套系统在旧机房跑了一整个学期，零故障——不是因为它多先进，而是因为它足够“笨拙”地贴合了真实环境。

1.2 JSP作为前端为何不可替代？

看到“JSP实现”可能有人皱眉，觉得过时。但在教学场景里，JSP恰恰是最务实的选择。首先，它和Servlet天然同源，学生学完HTTP协议、Request/Response对象后，直接在JSP里用<%=request.getParameter(“xxx”)%>取参，比学Thymeleaf的${param.xxx}少绕三道弯。其次，JSP的include指令（<%@ include file=”header.jsp”%>）让学生第一次理解“页面复用”概念，而不用先啃Vue的组件化思想。最关键的是，JSP能无缝嵌入Java代码块（<% %>, <%= %>），这对考勤系统的动态逻辑至关重要。比如学生签到页xueshengqiandao_add.jsp里，要根据当前登录学生ID，动态查询他本学期所有课程，并渲染成下拉框：

<select name="kechengId">
<% 
List<Kecheng> kcList = (List<Kecheng>) request.getAttribute("kechengList");
for(Kecheng k : kcList){
%>
    <option value="<%=k.getId()%>"><%=k.getMingcheng()%>（<%=k.getJiaoshiMing()%>）</option>
<% } %>
</select>

这种“数据-视图”紧耦合，在前后端分离架构里得写API、建DTO、配Axios，对学生而言是认知超载。而JSP一行<%=k.getMingcheng()%>就搞定，注意力全在业务逻辑上。当然，它也有代价：页面里混Java代码易混乱。所以这套系统严格遵循“JSP只负责展示，逻辑全在Servlet/Controller”的约定，所有数据准备都在后台完成，JSP只是忠实渲染器——这反而教会学生“关注点分离”的第一课。

1.3 三角色权限模型的设计深意

管理员、教师、学生三角色看似常规，但权限划分直指教学管理核心矛盾。管理员不是“超级用户”，不能代学生签到或批假——因为考勤数据的真实性必须由教学行为主体（教师）确认。教师权限卡在“所授课程”，即jiaoshiqingjia_updt.jsp里，SQL查询条件永远带着AND kecheng.jiaoshi_id = ?，杜绝跨班审批。学生权限更精细：xueshengqiandao_add.jsp提交签到时，后端会校验该学生是否在所选课程的student_kecheng关联表中，防止A班学生误签B班课。这种基于数据关联的权限控制，比Shiro的URL拦截更可靠——URL可以伪造，但数据库外键约束无法绕过。

更关键的是，角色切换不靠前端隐藏菜单，而靠后端拦截器。系统在spring-mvc.xml里配置了HandlerInterceptor：

<mvc:interceptors>
    <mvc:interceptor>
        <mvc:mapping path="/jiaoshi/**"/>
        <bean class="com.ssm.interceptor.TeacherInterceptor"/>
    </mvc:interceptor>
</mvc:interceptors>

TeacherInterceptor里检查session中的user.role，非教师角色直接重定向到403页。这意味着即使学生手敲/jiaoshi/qingjia_list.do，也会被拦住。这种“服务端守门员”思维，比前端disable按钮靠谱得多——毕竟教学系统里，一个误点可能影响整个班的出勤统计。

2. 核心模块解析与实操要点

2.1 学生签到模块：从“打卡”到“教学行为记录”

学生签到表面是点击按钮，背后是一套教学时空坐标系的建立。xueshengqiandao_add.jsp提交的不是简单“已签到”，而是包含四个关键维度的数据：
- 时间维度：签到时间精确到秒（new Date()），且与课表时间强关联。系统在添加课程时，要求填写“上课开始时间”和“上课结束时间”，签到操作触发时，后端会校验当前时间是否在[课表开始时间-15分钟, 课表结束时间+15分钟]窗口内。超出范围则提示“仅限上课前后15分钟签到”，避免学生课前刷屏或课后补签。
- 空间维度：需选择“上课教室”，字段名为jiaoshi，值来自数据库jiaoshi表。这不是可选项，而是必填项——因为后续统计要分析“某教室设备故障导致缺勤率升高”这类问题。
- 课程维度：通过kecheng_id关联课程表，确保签到绑定到具体教学单元。
- 身份维度：自动带入session中的student_id，禁止手动修改。

实操中最大的坑是并发签到。曾有班级80人同时点签到，MySQL出现大量Duplicate entry ‘20231015_101_1001’ for key ‘uk_qiandao_date_kc_stu’错误。原因在于唯一索引uk_qiandao_date_kc_stu（签到日期+课程ID+学生ID）在高并发下冲突。解决方案不是删索引，而是加分布式锁：在QiandaoService.saveQiandao()方法上加@Transactional，并在插入前用SELECT FOR UPDATE锁定课程记录：

// 先锁定该课程当天的签到记录（无则创建空记录）
QiandaoLock lock = qiandaoMapper.selectLockByKcDate(kechengId, date);
if(lock == null){
    lock = new QiandaoLock();
    lock.setKechengId(kechengId);
    lock.setQiandaoDate(date);
    qiandaoMapper.insertLock(lock); // 此处INSERT会触发行锁
}
// 再执行实际签到插入
qiandaoMapper.insert(qiandao);

这样同一课程同一日期的签到请求会被串行化，既保证数据唯一性，又避免锁表影响其他课程。这个细节在说明文档.zip里根本不会提，但却是上线不翻车的关键。

2.2 课堂请假审批模块：流程闭环与状态驱动

请假不是简单的“申请→同意”，而是一个状态机驱动的流程。系统定义了5种状态：
- 0-待提交（学生填表未发送）
- 1-待审核（已提交，教师未处理）
- 2-已通过（教师批准）
- 3-已拒绝（教师驳回）
- 4-已撤销（学生主动撤回）

jiaoshiqingjia_updt.jsp页面根据qingjia.status动态渲染按钮：状态为1时显示“批准”“拒绝”按钮；状态为2/3时显示“查看详情”；状态为0/4时不显示任何操作按钮。这种“状态决定UI”的设计，让学生和教师永远只看到当前该做的动作，杜绝误操作。

更精妙的是状态变更的副作用处理。当教师点击“批准”时，后端不仅更新qingjia.status=2，还会触发两个关键动作：
1. 自动签到补偿：如果请假时段覆盖整节课，则在qiandao表中为该学生插入一条status=2（请假）的记录，确保考勤统计时计入“请假”而非“缺勤”。
2. 课表冲突检测：调用QingjiaService.checkConflict(qingjia)方法，遍历该学生当日所有课程，检查请假时间段是否与其他课冲突。若冲突（如请假上午第1-2节，但第3节还有课），则在审批页面弹出提示：“您请假的时段与今日第3节《数据库原理》冲突，请确认是否需调整”。

这个冲突检测逻辑藏在qingjia_mapper.xml的checkConflict SQL里，用MySQL的TIME类型做区间计算：

SELECT COUNT(*) FROM kecheng k 
WHERE k.xuesheng_id = #{studentId} 
AND DATE(k.kssj) = DATE(#{qingjia.qingjiaDate}) 
AND TIME(k.kssj) < TIME(#{qingjia.jsj}) 
AND TIME(k.jssj) > TIME(#{qingjia.kssj})

没有用复杂算法，就靠数据库原生TIME比较，既高效又准确。这种“用数据库能力代替Java逻辑”的思路，在教学系统里特别实用——毕竟学生写的Java代码，远不如MySQL的TIME函数可靠。

2.3 考勤统计报表：从数字到教学洞察

报表不是简单SELECT COUNT，而是分层聚合的决策支持工具。系统提供三类核心报表：
- 课程维度报表（kecheng_tongji.jsp）：按课程统计应到/实到/请假/缺勤人数，计算出勤率（实到/应到×100%），并标红出勤率<90%的课程。
- 教师维度报表（jiaoshi_tongji.jsp）：汇总教师所授所有课程的平均出勤率，并列出其带班中出勤率最低的3门课。
- 学生维度报表（xuesheng_tongji.jsp）：显示学生本学期各课程出勤明细，底部统计“累计缺勤次数”，并预警“连续3次未签到学生”（用子查询实现）。

最实用的是“连续缺勤预警”SQL，它用MySQL 8.0的窗口函数ROW_NUMBER()实现：

SELECT xuesheng_id, qiandao_date, rn 
FROM (
    SELECT xuesheng_id, qiandao_date,
           ROW_NUMBER() OVER (PARTITION BY xuesheng_id ORDER BY qiandao_date) - 
           ROW_NUMBER() OVER (PARTITION BY xuesheng_id, status ORDER BY qiandao_date) AS rn
    FROM qiandao 
    WHERE status = 0 -- 缺勤状态
) t 
WHERE rn >= 3;

这段SQL的精妙在于用两个ROW_NUMBER()的差值识别连续序列——这是数据库工程师才懂的技巧，但对学生理解“数据分组排序”概念极有帮助。报表导出用POI实现，但做了降级处理：当导出数据超5000行时，自动切换为CSV格式（用BufferedWriter写纯文本），避免OOM。这个细节在pom.xml里体现在poi-ooxml的scope为provided，因为Tomcat自带的poi.jar已够用，不必打包臃肿的xlsx支持。

3. 实操部署与核心环节实现

3.1 数据库初始化：从SQL脚本到Navicat可视化建库

ssmxskqglxthsg5511zb.sql不是简单建表语句，而是包含完整教学数据生态的初始化脚本。它分为四部分：
1. 基础字典表：如xueyuan（学院）、zhuanye（专业）、banji（班级），用INSERT预置常见值，避免学生部署时因为空表导致页面报错。
2. 关联关系表：如student_kecheng（学生-课程关联），含复合主键(student_id, kecheng_id)和外键约束，确保数据一致性。
3. 业务主表：如qiandao（签到表）的唯一索引uk_qiandao_date_kc_stu，正是前文解决并发问题的关键。
4. 测试数据：INSERT 20条学生、10条教师、50条课程、200条签到记录，保证首次启动就有真实数据可看。

用Navicat建库时，务必注意三点：
- 字符集选utf8mb4，排序规则utf8mb4_unicode_ci，避免学生姓名中的生僻字乱码；
- 执行SQL前，在Navicat的“运行SQL文件”选项中勾选“停止执行遇到错误时”，防止某条INSERT失败导致后续表建不全；
- 执行完毕后，手动检查qiandao表的ENGINE是否为InnoDB（MyISAM不支持事务和外键），可在Navicat右键表→“对象信息”中确认。

我见过太多学生卡在这一步：Navicat默认建表用MyISAM，结果请假审批事务失效，签到数据重复。其实只要在SQL脚本开头加上SET default_storage_engine=INNODB;就能根治，但很多学生直接双击运行，忽略了脚本里的注释说明。

3.2 Maven依赖配置：精简到极致的pom.xml

pom.xml共37个依赖，但真正核心的只有7个：
- spring-context（4.3.30.RELEASE）：IOC容器基石
- spring-webmvc（4.3.30.RELEASE）：MVC框架
- mybatis（3.4.6）：ORM核心
- mysql-connector-java（5.1.47）：MySQL驱动（注意不是8.x，因JDK1.8兼容性）
- jstl（1.2）：JSP标签库
- log4j（1.2.17）：日志（教学系统无需SLF4J抽象层）
- junit（4.12）：单元测试

其余30个都是传递依赖（如spring-jdbc、commons-logging）。这种精简不是偷懒，而是教学考量：学生要理解每个jar包的作用。比如去掉spring-jdbc，就得自己写JDBCUtils；去掉log4j，就只能System.out.println()——这些“被迫的手动实现”，恰恰是理解框架价值的前提。pom.xml里所有版本号都锁定，不使用${spring.version}变量，避免学生改错一处导致全盘编译失败。Maven3.3.9+的要求，是因为低版本不支持某些插件的XML语法，但3.3.9已是2015年的老版本，确保高校机房旧环境也能跑。

3.3 IDEA与Eclipse双环境适配：消除IDE焦虑

project目录下的.classpath和.project文件，是Eclipse能直接导入的关键。但学生常犯的错误是：在IDEA里打开项目后，又去Eclipse里Import Existing Projects，结果报错“The project was not built since its build path is incomplete”。根源在于IDEA默认不生成.classpath，而Eclipse依赖它。解决方案是：在IDEA中File→Project Structure→Modules，勾选“Create module-info.java”并点击OK，然后右键项目→”Add Framework Support”→勾选”Java EE”，IDEA会自动生成标准.classpath。反之，Eclipse用户若想用IDEA，需删除.project和.classpath，用IDEA的Maven导入功能重建。

更隐蔽的坑在WebRoot目录。Eclipse默认WebRoot是WebContent，而此项目是WebRoot。在IDEA中，需右键WebRoot→”Mark Directory as”→”Resources Root”，否则JSP里的<%@ taglib prefix=”c” uri=”http://java.sun.com/jsp/jstl/core” %>会报找不到taglib。这个细节在说明文档.zip里往往一笔带过，但足以让学生折腾半天。

4. 常见问题与排查技巧实录

4.1 登录成功但页面跳转404：路径与视图解析器的博弈

现象：输入账号密码，后台打印“Login success”，但浏览器跳转到http://localhost:8080/404.jsp。
根因：spring-mvc.xml中ViewResolver配置的prefix路径与实际JSP存放位置不匹配。此项目JSP全在WebRoot/WEB-INF/jsp/下，但ViewResolver的prefix可能被学生误配为”/WEB-INF/views/”。
排查步骤：
1. 查看tomcat日志，搜索”Could not resolve view with name”，确认尝试查找的路径；
2. 检查spring-mvc.xml中InternalResourceViewResolver的prefix属性；
3. 在IDEA中展开WebRoot目录，确认jsp文件真实路径；
4. 修改prefix为”/WEB-INF/jsp/”，重启Tomcat。

经验：所有JSP页面命名规范（如xueshengqiandao_add.jsp）不是为了好看，而是为了在Controller里return “xueshengqiandao_add”;时，ViewResolver能精准定位。建议学生在写Controller时，先建好JSP文件再写return语句，避免路径拼写错误。

4.2 请假审批后状态不更新：事务传播行为陷阱

现象：教师在jiaoshiqingjia_updt.jsp点击“批准”，页面刷新后状态仍为“待审核”。
根因：QiandaoService.updateStatus()方法未加@Transactional，或传播行为设为SUPPORTS（不新建事务）。MySQL默认autocommit=true，但MyBatis的SqlSession需要显式事务才能提交。
排查步骤：
1. 在updateStatus()方法上加@Transactional注解；
2. 检查spring-context.xml中是否配置了；
3. 确认transactionManager指向DataSourceTransactionManager；
4. 在方法内加log.info(“update status to 2”);，确认日志打印但数据库未更新，则必是事务未生效。

避坑：不要在Service层用try-catch吞掉异常。曾有学生为防报错，在updateStatus()里加了catch(Exception e){}，结果事务回滚但无提示，以为功能正常。

4.3 出勤率计算为NaN：空值与除零的双重陷阱

现象：kecheng_tongji.jsp中出勤率显示“NaN”。
根因：SQL中COUNT()/COUNT()计算时，若分母为0（某课程无学生选修），Java端Double.NaN参与运算导致。
解决方案：在Mapper XML中用CASE WHEN处理：

SELECT 
  kecheng.id,
  kecheng.mingcheng,
  COUNT(qiandao.id) as shidao,
  COUNT(student_kecheng.student_id) as yingdao,
  CASE 
    WHEN COUNT(student_kecheng.student_id) = 0 THEN 0.0
    ELSE ROUND(COUNT(qiandao.id)/COUNT(student_kecheng.student_id)*100, 2)
  END as chuangxilv
FROM kecheng 
LEFT JOIN student_kecheng ON kecheng.id = student_kecheng.kecheng_id
LEFT JOIN qiandao ON kecheng.id = qiandao.kecheng_id AND qiandao.status = 1
GROUP BY kecheng.id;

这个CASE WHEN不仅是防错，更是教学示范：告诉学生“任何除法运算前，先问分母会不会是零”。

4.4 中文乱码终极排查表

现象	可能位置	检查项	解决方案
MySQL中文显示?	数据库	`SHOW VARIABLES LIKE 'character_set%';`	`SET NAMES utf8mb4;` 并在my.cnf中配置[client]/[mysql]/[mysqld]的default-character-set=utf8mb4
JSP中文显示?	WebRoot/WEB-INF/web.xml	`<filter>`中CharacterEncodingFilter的encoding参数	设为`UTF-8`，且filter-mapping顺序在其他filter之前
表单提交中文乱码	Controller	`request.setCharacterEncoding("UTF-8");`	在所有Controller方法开头加此行，或统一用CharacterEncodingFilter
日志中文乱码	log4j.properties	`log4j.appender.file.Encoding=UTF-8`	确保appender的Encoding属性存在

这张表是我从上百次答疑中提炼的，学生只需按表索骥，5分钟内定位问题。记住：乱码从来不是单一环节问题，而是客户端→服务器→数据库的全链路编码对齐。

5. 教学扩展与二次开发指南

5.1 从“能用”到“好用”的轻量升级

这套系统预留了三个平滑升级接口：
- 短信通知：在QingjiaService.approve()方法末尾，调用SMSUtil.send(“您的请假已批准”, qingjia.getStudentPhone())，只需接入任意短信平台SDK；
- Excel模板导入：在课程管理页增加“批量导入”按钮，后端用POI读取Excel，解析后调用KechengService.batchInsert()；
- 微信扫码签到：在xueshengqiandao_add.jsp中，用wx.scanQRCode()获取二维码内容（课程ID+课次），替换原有下拉框选择。

这些扩展都不需重构架构，只需在现有Controller/Service中追加几行代码。我指导的学生团队，用两周时间就完成了微信扫码签到，核心代码不到50行——因为他们吃透了签到流程的底层逻辑。

5.2 毕设答辩高频问题预判

根据五年答辩经验，评委最爱问三类问题：
1. 为什么选SSM？ 回答要点：教学场景强调过程可视、环境兼容、调试直观，SSM的XML配置比Spring Boot的自动装配更利于学生理解IoC/AOP原理；
2. 并发签到怎么保证数据一致？ 必须答出“唯一索引+SELECT FOR UPDATE行锁”，不能只说“加了事务”；
3. 如何证明系统真实可用？ 展示Navicat里200条测试签到数据、Tomcat日志中的登录流水、导出的Excel报表截图——用证据说话，而非口头承诺。

最后分享个小技巧：答辩PPT首页不要写“基于SSM的考勤系统”，而写“让每一节课的出勤数据真正服务于教学改进”。评委听到这句话，就知道你不是在堆砌技术，而是在解决问题。

我个人在实际带教中发现，学生最容易陷入两个误区：一是过度追求前端美观，花一周调CSS却搞不定一个简单的状态判断；二是迷信新技术，非要集成Redis缓存签到数据，结果连MySQL事务都没理清。这套系统的价值，恰恰在于它用最朴素的技术组合，把“考勤”这件事做扎实了——签到不是打卡，是教学过程的数字孪生；请假不是流程，是学情分析的数据入口；统计不是报表，是教学改进的决策依据。当你能把一个看似简单的课堂签到，讲清楚时间、空间、课程、身份四个维度的绑定逻辑，讲明白并发、事务、乱码三个技术坑的填法，你就已经超越了90%的同龄人。教育信息化不需要炫技，需要的是把每一个45分钟，都变成可记录、可分析、可优化的教学资产。

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