Java Web考勤系统开发实战：SSM+JSP+layui+MySQL详解

简介：这是一套基于SSM+JSP+layui+Mysql的学生课堂考勤管理系统完整源码包，面向JavaWeb初学者及毕业设计者，覆盖辅导员、管理员、教师、学生四种角色，包含辅导员的学生管理、请假审批、签到列表，管理员的班级/辅导员/教师管理，教师的签到与请假处理，以及学生的签到、请假、密码修改等完整业务闭环，能帮助理解SSM整合流程、权限角色设计与Mysql表关系。压缩包共1802个文件，大小33.32MB，文件类型以gif、png等图片素材，js、css等前端静态资源，jsp页面，java源码与xml配置文件为主，同时包含jar依赖包、数据库db文件与sql脚本等，项目结构清晰，可导入IDEA/Eclipse配合Tomcat 8及Mysql 5.7直接运行调试。已有767人学习下载，适合用来快速搭建考勤管理场景，作为SSM项目实战参考或毕业设计基础，也可基于现有模块二次扩展。

1. 学生课堂考勤管理系统虽然不新，但仍是Java Web练手与毕设的好样板

临近上课还有五分钟，班长拿着纸质名单挨个喊名字，老师低头画勾。这套流程在大学课堂里延续了很多年，直到有人把「学生课堂考勤管理系统」做成了Java Web项目，课堂考勤才从纸质表单变成手机上一键完成。标题里的这套组合——Java + SSM + JSP + layui + MySQL，是Java Web开发里非常经典的一条技术链路：SSM负责后端业务逻辑，JSP负责页面展示，layui负责表格和弹窗交互，MySQL负责落库。它不新，但胜在成熟、资料多、跑通成本低，特别适合做毕业设计选题、课程设计项目，或者给刚入行的人做第一个完整的Java Web实战。

如果你正打算做一个这类系统，或者拿到一个别人写好的考勤项目不知道怎么改，这篇文章要把一套可复现的落地路径讲清楚：选型依据、数据库设计、核心签到逻辑、layui表格对接方式，以及五个最容易踩的坑。文章里的代码都是我在类似项目里用过的写法，你照着搭能跑，改改也能用，适合新手跟步骤走，也适合熟手快速核对配置参数。

2. 技术选型：SSM+JSP+layui+MySQL各自负责什么，环境怎么搭

2.1 为什么这套老组合至今还是高频选择

SSM是Spring、SpringMVC、MyBatis三个框架的缩写。Spring管理对象和事务，SpringMVC处理请求转发和参数绑定，MyBatis负责SQL与Java对象之间的映射。这套组合的分层非常清晰：Controller层接请求，Service层写业务，Mapper层操作数据库。很多教学项目和中小企业内部工具都是用SSM搭起来的，代码结构一眼能看懂，出了问题也容易定位在哪一层。

JSP经常被拿来和Thymeleaf、FreeMarker对比。说实话，JSP在性能上和前后端分离方案有差距，但在「学生课堂考勤管理系统」这类场景里，它的优势反而明显：无需额外引入模板引擎，Tomcat原生支持，改一个页面直接刷新就能看到效果。尤其是毕设项目，老师打开项目源码就能看懂页面写在哪，不用费劲解释前端工程结构。JSP里可以写Java代码片段，也能用JSTL标签，对新手来说上手门槛低很多。

layui是一个经典的前端UI框架，特色是「后端友好」。它不像Vue、React那样要求你掌握组件化思维，只需要在页面上引入CSS和JS文件，然后写一段table.render的初始化代码，就能得到带分页、排序、工具栏的完整表格。考勤管理系统里最核心的界面就是「某节课谁到了、谁没到」的名单，layui的表格组件几乎是为这种后台管理场景定制的。配合它的弹层组件layer做签到弹窗、请假审批框，开发效率比手写HTML高不少。

MySQL作为存储层没什么争议，体积小、部署简单、SQL语法标准。选这个组合还有一个现实原因：网上现成的源码和学习笔记最多的就是这套技术栈，遇到问题搜索时命中率比其他组合高很多。对做毕设和课程设计的人来说，这意味着更低的试错成本。

2.2 运行环境清单与版本组合建议

版本选择是这类项目第一个容易翻车的地方。不是版本越新越好，而是要考虑框架兼容性。SSM的主流版本是基于JDK 8设计的，如果你安装了JDK 17还开了模块化限制，老版本CGLIB代理很容易报module访问错误。我一般在本地环境固定用下表这套组合。

这里有个值得说的点：为什么MySQL不推荐8.0？MySQL 8.0默认的认证插件是caching_sha2_password，老版本JDBC驱动连接时会直接报认证失败，需要额外改驱动版本或者改用户认证插件。SSM项目的jdbc驱动一般用的是mysql-connector-java 5.1.x，和MySQL 8.0配合总会出现意料之外的问题。如果你的电脑已经装了MySQL 8.0，也不是不能用，需要在连接串里增加allowPublicKeyRetrieval=true，但我更建议直接装5.7版本省心。

Tomcat和JDK的搭配也要注意：Tomcat 9.0支持Servlet 4.0，对JDK 8完全兼容；Tomcat 10及以上把javax.servlet包名改成了jakarta.servlet，SSM框架里大量使用javax.servlet.http.*的代码会直接编译失败。所以别装最新的Tomcat 10或11，除非你愿意花时间改依赖坐标。

2.3 从零搭一个能跑的Maven工程

新建Maven工程时选webapp骨架，或者干脆创建一个普通Maven工程后手动补上webapp目录，两种方式都可以。我更习惯用后者，因为骨架生成的pom.xml常带一些用不上的依赖，手动添加反而干净。下面这份pom.xml是这个考勤项目最精简的依赖集合。

<properties> <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding> <maven.compiler.source>1.8</maven.compiler.source> <maven.compiler.target>1.8</maven.compiler.target> <spring.version>5.2.15.RELEASE</spring.version> </properties> <dependencies> <!-- Spring核心 --> <dependency> <groupId>org.springframework</groupId> <artifactId>spring-context</artifactId> <version>${spring.version}</version> </dependency> <dependency> <groupId>org.springframework</groupId> <artifactId>spring-webmvc</artifactId> <version>${spring.version}</version> </dependency> <dependency> <groupId>org.springframework</groupId> <artifactId>spring-jdbc</artifactId> <version>${spring.version}</version> </dependency> <!-- MyBatis整合 --> <dependency> <groupId>org.mybatis</groupId> <artifactId>mybatis</artifactId> <version>3.5.6</version> </dependency> <dependency> <groupId>org.mybatis</groupId> <artifactId>mybatis-spring</artifactId> <version>2.0.6</version> </dependency> <!-- MySQL驱动 --> <dependency> <groupId>mysql</groupId> <artifactId>mysql-connector-java</artifactId> <version>5.1.49</version> </dependency> <!-- JSP相关 --> <dependency> <groupId>javax.servlet</groupId> <artifactId>javax.servlet-api</artifactId> <version>3.1.0</version> <scope>provided</scope> </dependency> <dependency> <groupId>javax.servlet</groupId> <artifactId>jstl</artifactId> <version>1.2</version> </dependency> </dependencies>

这段pom.xml把SSM三件套、MySQL驱动和JSP需要的Servlet API都列出来了。spring-webmvc里已经传递依赖了spring-web、spring-core等模块，不需要逐个重复添加。javax.servlet-api的scope设置为provided是关键，因为Tomcat本身就带有Servlet实现，如果你打war包时把这份依赖打进去，部署后会和Tomcat自带的类冲突。

依赖配好后，对应的源码目录结构需要分成四块：controller包放SpringMVC的控制器，service包放业务接口和实现类，mapper包放MyBatis的Mapper接口和XML文件，entity包放数据库表对应的实体类。resources目录下放spring配置文件、mybatis配置文件和jdbc.properties。如果你是照着教程搭的话，加深印象的一句话是：SSM项目里的目录结构约等于代码分层，包名乱套是后期排查问题时最痛苦的体验。

3. 考勤数据库设计：核心表结构、状态判定字段与检索索引

3.1 学生、课程、考勤记录三张核心表怎么建

考勤系统涉及的角色一般有四种：管理员、教师、学生、课程。实际项目里不建议设计太多张表，那会让毕设代码显得庞大但交互逻辑薄弱。常规做法是只建六个核心实体：学生表、教师表、课程表、授课关联表、考勤记录表、用户登录表。授课关联表用于处理多对多关系，因为一位教师可以带多门课，一门课也可能有多个教师协作。

下面以MySQL 5.7为例，给出最常用的三张建表语句。

-- 学生表 CREATE TABLE `student` ( `id` int(11) NOT NULL AUTO_INCREMENT, `student_no` varchar(32) NOT NULL COMMENT '学号', `student_name` varchar(50) NOT NULL COMMENT '姓名', `class_name` varchar(50) DEFAULT NULL COMMENT '班级', `phone` varchar(20) DEFAULT NULL COMMENT '手机号', `create_time` datetime DEFAULT CURRENT_TIMESTAMP, PRIMARY KEY (`id`), UNIQUE KEY `uk_student_no` (`student_no`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4; -- 课程表 CREATE TABLE `course` ( `id` int(11) NOT NULL AUTO_INCREMENT, `course_name` varchar(100) NOT NULL COMMENT '课程名', `teacher_id` int(11) DEFAULT NULL COMMENT '授课教师ID', `start_time` time NOT NULL COMMENT '上课时间', `end_time` time DEFAULT NULL COMMENT '下课时间', `classroom` varchar(50) DEFAULT NULL COMMENT '教室', `course_day` tinyint(4) DEFAULT NULL COMMENT '星期几，1-7', PRIMARY KEY (`id`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4; -- 考勤记录表 CREATE TABLE `attendance` ( `id` int(11) NOT NULL AUTO_INCREMENT, `student_id` int(11) NOT NULL COMMENT '学生ID', `course_id` int(11) NOT NULL COMMENT '课程ID', `attendance_date` date NOT NULL COMMENT '考勤日期', `status` tinyint(4) NOT NULL DEFAULT '1' COMMENT '1正常 2迟到 3缺勤 4请假', `sign_time` datetime DEFAULT NULL COMMENT '实际签到时间', `remark` varchar(255) DEFAULT NULL COMMENT '备注', PRIMARY KEY (`id`), UNIQUE KEY `uk_student_course_date` (`student_id`, `course_id`, `attendance_date`), KEY `idx_course_date` (`course_id`, `attendance_date`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

上面三个表中，值得说明的是唯一索引uk_student_course_date。这个索引保证了同一个学生在同一门课的同一个日期下只能有一条考勤记录，这是防止重复签到的最后防线。哪怕业务代码在写入前忘了查重，数据库层面也能兜底。很多项目里考勤数据统计翻倍，原因就是没建这层唯一索引。

课程表里使用了time类型存上下课时间，用tinyint存星期几。这种设计的优点是查询逻辑直观：页面下拉选择星期，根据course_day匹配当天课程；页面显示上课时间，直接从start_time字段格式化输出。如果你用varchar存时间，排序和比较都会有问题，查「当前时间是否在课堂时间窗口内」这类SQL会写得很别扭。

3.2 考勤状态的码表设计与边界情况

考勤状态在数据库里怎么存，不同项目有不同习惯。有的用varchar直接存「正常」「迟到」「缺勤」，好处是查询结果可读性强，坏处是冗余存储、统计时需要兼容不同写法。我一般建议用tinyint存数字状态码，在Java层定义一个常量类做映射。

public class AttendanceStatus { /** 正常 */ public static final int NORMAL = 1; /** 迟到 */ public static final int LATE = 2; /** 缺勤 */ public static final int ABSENT = 3; /** 请假 */ public static final int LEAVE = 4; }

为什么早期项目偏爱用数字枚举而不是字符串？核心原因是统计SQL好写。要算某门课的出勤率，直接按status分组计数，数字区间一划就出来；如果用字符串，一个字段可能漏掉「正常」「出勤」两种说法导致的NULL统计。页面显示时再通过Java代码把状态码翻译成中文，或者在SQL里用CASE WHEN处理，都不复杂。

另一个要注意的边界是「请假」状态。课堂考勤的判定通常只关注三种：正常、迟到、缺勤。请假属于人工录入数据，需要老师在后台手动把某位同学的考勤状态改成4。代码里处理时，请假状态不能参与缺勤率的统计，否则会误伤学生。这部分逻辑在Service层判空时最容易被忽略，很多新手写统计SQL时直接COUNT所有状态非1的记录，结果请假也算成了缺勤。

还有一节课跨多个时段的情况需要提前考虑。比如上午三四节课连着上，课间休息十分钟，这节课算两节课还是一节课？我做过的一个项目里，课程表按小节划分，每小节都有独立的course_id，考勤记录跟着小节走，这样统计每个老师的课时量时数据才对得上。如果按半天一节课设计，后期的课时统计报表会没法做。

3.3 联合索引与查询热点

考勤系统查询频率最高的两个场景是：学生查自己的出勤记录，老师查某节课的到课名单。前者的查询条件是student_id + 时间范围，后者的查询条件是course_id + attendance_date。在两个字段的组合上建索引，能让查询走覆盖索引，避免全表扫描。

attendance表里建的两条索引就是为此设计的：一条唯一索引处理防重，一条普通联合索引加速老师视角的查询。这里不推荐给status单独建索引，因为status字段的区分度不高，总共就四个值，MySQL优化器大概率不会走这条索引。索引不是越多越好，写操作会因此变慢，存储空间也会增加。

学生端的出勤统计页面通常以日期为第一筛选条件。如果你把attendance_date放在联合索引的第一位，查询某天所有课程的到课情况时效率更好。但考勤管理系统的查询场景里，「查某节课的名单」远比「查某天的全部记录」频率高，所以我习惯把course_id放在联合索引的第一位。实际项目可以根据你的报表需求调整字段顺序，原则只有一个：最常出现在WHERE条件里的字段排最前。

4. 后端代码：签到接口、迟到判定与layui表格数据接口实现

4.1 SSM配置落地：JDBC、Spring与MyBatis关键参数

SSM配置最花时间的地方在XML文件，因为三个框架的衔接点都要在这里声明。下面给出两个核心配置文件的核心片段，一个是连接数据库的参数，一个是Spring管理Mapper的扫描配置。

# jdbc.properties jdbc.driver=com.mysql.jdbc.Driver jdbc.url=jdbc:mysql://localhost:3306/attendance_db?useUnicode=true&characterEncoding=utf8&useSSL=false&serverTimezone=Asia/Shanghai jdbc.username=root jdbc.password=123456

<!-- applicationContext.xml 关键片段 --> <context:property-placeholder location="classpath:jdbc.properties"/> <bean id="dataSource" class="org.springframework.jdbc.datasource.DriverManagerDataSource"> <property name="driverClassName" value="${jdbc.driver}"/> <property name="url" value="${jdbc.url}"/> <property name="username" value="${jdbc.username}"/> <property name="password" value="${jdbc.password}"/> </bean> <bean id="sqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean"> <property name="dataSource" ref="dataSource"/> <property name="mapperLocations" value="classpath:mapper/*.xml"/> <property name="configLocation" value="classpath:mybatis-config.xml"/> </bean> <bean class="org.mybatis.spring.mapper.MapperScannerConfigurer"> <property name="basePackage" value="com.attendance.mapper"/> </bean>

jdbc.properties里有两个参数容易忽略。characterEncoding=utf8保证中文写入不乱码，serverTimezone=Asia/Shanghai避免日期时间在JDBC层被转换时出现8小时偏差。MySQL 5.7即使不乱码，如果没有时区参数，查询出的时间戳仍可能按JVM默认时区重新解析，导致页面显示的时间和数据库存储的时间差8个小时。

applicationContext.xml用DriverManagerDataSource作为数据源，适合学习项目和低并发内部系统。生产环境下一般会用Druid或者HikariCP连接池，避免频繁创建连接带来的性能损耗。把这段XML当作最小可用的起点没问题，后期需要优化时再替换数据源即可，其他配置结构不用动。

mybatis-config.xml里还有一个必须开启的开关，那就是驼峰映射，配置方式如下。

<configuration> <settings> <setting name="mapUnderscoreToCamelCase" value="true"/> </settings> </configuration>

这个配置将会在后面避坑章节专门展开说明。这里先记住一个结论：数据库列名是student_name，Java属性是studentName，如果不开驼峰映射，查询结果里studentName永远为null。

4.2 签到与迟到判定逻辑的实现

考勤签到接口是整个系统的核心业务。它的处理流程是：接收学生ID和课程ID，判断当前时间距离上课时间有多远，然后决定写入哪种状态。这个判断不可能放在Controller里，应该下沉到Service层，因为将来如果增加预约签到或补签功能，业务逻辑还要复用。

下面给出签到接口和Service实现的简化代码。

@Controller @RequestMapping("/attendance") public class AttendanceController { @Autowired private AttendanceService attendanceService; /** * 学生签到接口 * 参数 studentId：学生ID，courseId：课程ID */ @RequestMapping("/checkIn") @ResponseBody public Result checkIn(Integer studentId, Integer courseId) { if (studentId == null || courseId == null) { return Result.error("参数不能为空"); } return attendanceService.checkIn(studentId, courseId); } }

@Service public class AttendanceServiceImpl implements AttendanceService { /** 上课前N分钟允许签到 */ private static final int ALLOW_MINUTES_BEFORE = 10; /** 上课后N分钟内算迟到 */ private static final int LATE_MINUTES_AFTER = 15; @Autowired private CourseMapper courseMapper; @Autowired private AttendanceMapper attendanceMapper; @Override public Result checkIn(Integer studentId, Integer courseId) { Course course = courseMapper.selectByPrimaryKey(courseId); if (course == null) { return Result.error("课程不存在"); } // 校验当前时间是否在允许签到的时间窗口内 LocalDate today = LocalDate.now(); LocalTime now = LocalTime.now(); LocalTime startTime = course.getStartTime().toLocalTime(); LocalTime endTime = course.getEndTime().toLocalTime(); // 超过下课时间不允许再签到 if (now.isAfter(endTime)) { return Result.error("本节课已下课，无法签到"); } // 计算出勤状态 int status; // 上课前10分钟内签到，记为正常 if (now.isBefore(startTime) && now.isAfter(startTime.minusMinutes(ALLOW_MINUTES_BEFORE))) { status = AttendanceStatus.NORMAL; } // 上课迟到15分钟内，记为迟到 else if (now.isAfter(startTime) && now.isBefore(startTime.plusMinutes(LATE_MINUTES_AFTER))) { status = AttendanceStatus.LATE; } // 超出时间窗口，记为缺勤 else { status = AttendanceStatus.ABSENT; } // 写入考勤记录，唯一索引兜底防重 Attendance record = new Attendance(); record.setStudentId(studentId); record.setCourseId(courseId); record.setAttendanceDate(today); record.setStatus(status); record.setSignTime(LocalDateTime.now()); try { attendanceMapper.insert(record); } catch (DuplicateKeyException e) { return Result.error("今日已签到，请勿重复提交"); } return Result.success("签到成功"); } }

这段代码在签到逻辑上做了三层时间判断：上课前10分钟到上课这一刻算正常，上课后0到15分钟算迟到，其他时间要么下课不能签、要么直接缺勤。时间窗口的值都提取成了常量，你在自己的项目里可以根据学院规定调整，比如把提前量改成5分钟，把迟到宽限期改成10分钟。

有一个细节值得注意：LocalTime和数据库time类型的映射。MyBatis 3.5版本对JSR-310时间类型的支持还不算完美，有时会报TypeHandler异常。一个稳妥的写法是让实体里的startTime直接使用java.sql.Time类型，Service里再用toLocalTime()转换。课程实体怎么定义会直接影响这段逻辑能不能编译通过。

4.3 返回给layui表格的考勤查询接口

考勤管理界面最常见的效果是「下拉选一门课，表格展示全班学生的签到状态」。这个表格的数据不能直接用JSP渲染，因为layui表格模块要求后端返回JSON，且结构要符合它的约定。下面给出查询接口代码和返回对象的定义。

@RequestMapping("/listByCourse") @ResponseBody public Map<String, Object> listByCourse(Integer courseId, Integer page, Integer limit) { List<AttendanceVO> list = attendanceService.listByCourse(courseId, page, limit); long total = attendanceService.countByCourse(courseId); Map<String, Object> result = new HashMap<>(); // layui 约定 code=0 表示成功 result.put("code", 0); result.put("msg", ""); result.put("count", total); result.put("data", list); return result; }

layui的table模块从1.0版本开始就默认要求这个四件套结构。code为0代表请求成功，非0会被当成业务失败；count字段是总记录数，用于分页组件计算总页数；data是当前页的数据数组。如果你返回一个直接的List，表格会显示空白，这个问题在避坑章节会详细说。

Mapper层对应的查询SQL也是这套项目里比较有复用价值的部分。

<select id="listByCourse" resultType="com.attendance.vo.AttendanceVO"> SELECT s.student_no AS studentNo, s.student_name AS studentName, s.class_name AS className, a.status, a.sign_time AS signTime, a.remark FROM attendance a INNER JOIN student s ON a.student_id = s.id WHERE a.course_id = #{courseId} ORDER BY a.attendance_date DESC, a.sign_time ASC LIMIT #{offset}, #{limit} </select>

这张查询联了两张表，展示学生信息的同时显示考勤状态。LIMIT的分页参数由Controller从page和limit计算得出，比如page=1、limit=10时，offset就是0。如果有一天你想把考勤系统改成前后端分离，这个SQL基本不用动，只需要把返回方式换成JSON即可。

5. 常见问题排查：从数据为null到表格空白，五个高频故障

5.1 数据库字段能查到但实体属性为null：MyBatis驼峰映射没打开

现象：查询学生列表时，控制台打印SQL发现数据库里student_name有值，但页面上学生姓名为空。调试时在Mapper方法上打断点，发现返回的对象里studentName是null。

原因：MyBatis默认情况下不会自动把数据库列名student_name映射成Java属性studentName，它只认完全一致的字段名。如果你的实体类没有给查询结果取别名，就不匹配，属性保持默认值null。

解决：在mybatis-config.xml里开启驼峰映射。开了这个配置后，MyBatis会自动把带下划线的列名转换为驼峰形式的属性名，student_name自动对应studentName，不需要在每一条SQL里写AS别名。打开这个开关是我接手任何SSM项目的第一个动作，原因很简单：数据库规范里下划线命名是通用习惯，而Java属性用驼峰，两者之间的桥不搭好，后面每个查询都会出问题。

5.2 Tomcat启动即冲突：jar包被同时放进lib与Maven依赖

现象：项目在IDEA里运行正常，打成war包放到Tomcat的webapps目录后启动，报ClassNotFoundException或者NoSuchMethodError，而且报错堆栈指向的类不是自己的代码，而是Spring或MyBatis的类。

原因：有些开发者习惯把下载好的jar包手动复制到WEB-INF/lib目录下，同时又引入了Maven依赖。同一个框架出现两个不同版本，Tomcat的类加载器优先加载WEB-INF/lib下的类，导致与Maven依赖里的类不一致，运行时就出现版本冲突。

解决：统一由Maven管理依赖，把WEB-INF/lib目录下的手动拷贝文件全部清空。如果必须使用本地jar，也要通过Maven的system scope方式引入，而不是直接丢进lib。判断项目里有没有重复jar的方法是检查WEB-INF/lib目录下的文件名，如果某个框架出现两个版本号，基本就是冲突源头。

5.3 layui表格不渲染：返回JSON缺少必须的code字段

现象：浏览器Network面板能看到后端返回了JSON数据，数据内容也正确，但页面上的layui表格一直在「加载中」转圈，没有任何行显示。打开控制台也没有报JS错误。

原因：layui的table模块对响应数据有强约定，默认要求JSON对象里包含code字段且值为0，count字段为数据总数，data字段才是当前页列表。如果你直接返回一个数组，或者返回的对象里字段名是dataList之类，layui找不到约定字段，就既不渲染也不报错。

解决：让后端接口返回固定格式的Map或者统一Result对象。如果你拿到项目后不想改动Controller的返回结构，可以在前端table.render里配置parseData回调，把非标准字段转为layui需要的结构。两种方法都可行，我建议后端改标准格式，因为这样前端代码可以大量复用。

// layui 表格初始化 table.render({ elem: '#attendance-table', url: '/attendance/listByCourse', method: 'GET', page: true, cols: [[ { field: 'studentNo', title: '学号', width: 120 }, { field: 'studentName', title: '姓名', width: 120 }, { field: 'className', title: '班级', width: 140 }, { field: 'status', title: '状态', width: 90 } ]] });

5.4 考勤时间比本地时间慢8小时：MySQL连接串时区参数

现象：学生签到后，页面上显示的签到时间是14:05，但数据库里存的却是06:05，不是早就是晚8小时。更新数据库记录里的时间字段后，显示又恢复正常。

原因：MySQL驱动在连接数据库时，默认使用了服务器时区。当驱动版本与MySQL时区设置不一致，且连接串里没有显式指定serverTimezone时，JDBC层会把DATETIME类型按照默认时区解析，跟本地的UTC+8存在8小时偏移。

解决：在jdbc.url里加上serverTimezone=Asia/Shanghai，同时数据库连接参数增加useSSL=false避免SSL握手带来的额外告警。这个问题在只部署在一台机器上时几乎不会暴露，一旦你把war包部署到云服务器而数据库在本地，或者两者时区不一致，问题就会浮现出来。代码里取系统时间时，要统一使用LocalDateTime.now()而不是new Date().getTime()，前者默认取JVM所在时区，后者在跨时区部署时更容易产生混乱。

5.5 重复签到数据没有被挡住：唯一索引没建或接口逻辑不严谨

现象：统计某节课的出勤人数，该班有45人，考勤表里却能查到46条记录。再看数据，发现某一行的student_id和course_id与另一行完全相同，只是sign_time差了十几秒。

原因：签到接口在写入前没有查重，后端的防重只依赖代码里if (record != null)这样的判断。两个请求几乎同时到达服务器时，两个线程都通过了判空，然后各自执行了insert，最终插入两条记录。数据库层面如果没有唯一索引，这只是时间问题。

解决：在attendance表上建立(student_id, course_id, attendance_date)的唯一索引，然后在Java代码里捕获DuplicateKeyException，转换成友好的提示信息。数据库约束是硬兜底，代码判断是软校验，两层都用才能真正防住。我在实际项目里还遇到过另一个相似场景：学生换了浏览器多标签页同时提交，软校验全过了，唯一索引挡住了数据写入，日志里能看到异常，但页面因为没捕获而返回500。所以捕获这个异常并返回「请勿重复签到」的提示很重要。

6. 进阶技巧：统一返回格式与用Postman做接口回归验证

6.1 统一Result对象的设计思路

签到接口和查询接口建议使用同一个Result对象返回，避免有的接口直接返回Map、有的返回String、有的返回List，前端对接时无所适从。Result对象一般包含三个字段：code表示状态码，msg表示提示信息，data表示业务数据。再加两个静态工厂方法success和error，Controller里一行代码就能完成返回。

public class Result { private Integer code; private String msg; private Object data; public static Result success(Object data) { Result r = new Result(); r.code = 200; r.msg = "操作成功"; r.data = data; return r; } public static Result error(String msg) { Result r = new Result(); r.code = 500; r.msg = msg; return r; } // getter/setter省略 }

定义好这个基础类后，Controller的每个方法返回值都改成Result，再配一个全局异常处理器把未捕获的异常统一转成Result，前端拿到的结构始终一致。这样做的收益在联调阶段最明显：前端同学不用为每个接口写不同的解析逻辑，后端排查问题时通过msg字段就能定位是哪一层出了问题，不需要翻网络面板看原始响应。

6.2 layui表格的JS侧接入

统一了后端返回格式之后，前端table.render的配置里需要增加一段parseData，把Result结构转成layui约定的结构。这个写法在多个页面可以复用，建议封装成一个公共函数，避免每个页面都复制一遍。

table.render({ elem: '#course-table', url: '/attendance/listByCourse', method: 'GET', where: { courseId: 1 }, page: true, parseData: function (res) { return { "code": res.code === 200 ? 0 : 1, "msg": res.msg, "count": res.data.count, "data": res.data.list }; }, cols: [[ { field: 'studentNo', title: '学号' }, { field: 'studentName', title: '姓名' }, { field: 'status', title: '状态' } ]] });

这里把Result里的code字段做了转换，因为layui要求的成功码是0，而Result里的成功码是200，如果不转就会被layui判定为失败。这个细节如果不注意，后端永远返回「成功」，前端永远显示「加载失败」。封装好parseData之后，所有列表页的初始化代码都统一从Result.getData()里取数据，格式一变到处跟着变的问题就避免了。

6.3 Postman接口回归清单与部署前自测

在项目交付或演示前，我习惯把核心接口用Postman跑一遍用例，顺序依次是：管理员登录、课程列表、学生列表、学生签到、重复签到、按课程查考勤、按日期查考勤、错误参数。这套用例不是全流程回归，但覆盖了最容易出问题的数据写入和幂等场景。

Postman里可以配置环境变量保存登录token，方便在多个学生ID之间切换测试。这一套流程跑完不超过20分钟，比部署到服务器上再发现问题效率高得多。我还习惯把每个接口的响应时间记录下来，如果一个接口响应超过2秒，部署到云服务器后大概率还会更慢，需要提前看是SQL没走索引还是循环调用数据库。

6.4 一个数据库字段的教训与收尾

上一个考勤项目里，我在attendance表加过一列sign_year用来单独存年份，理由是报表页面按年筛选更方便。上线后才发现，代码里所有统计SQL都要同时维护两个字段，稍不留神就会出现年份和日期对不上的脏数据。后来我删掉冗余字段，所有筛选条件都通过attendance_date的范围查询实现。那次之后我养成一个习惯：字段设计时多问一句「这个字段能不能由其他字段推导出来」，能推导出来的就别单独存。

做这类系统，设计一个防御性强的唯一索引，比后面写一堆查重代码省心得多；统一好返回结构，比让前端迁就十个不同接口省心得多；提前把所有时间相关的配置参数固定住，比部署后再发现8小时偏差省心得多。希望这些踩过的坑和验证方法能帮你把「学生课堂考勤管理系统」这把入门钥匙打磨得顺手一点。

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