考勤系统这类项目SpringBoot早已成了默认选择了。最近在整理之前做过的课程设计项目翻到这套企业人员考勤管理系统觉得把从需求拆解到最终跑通部署的完整过程写出来比单纯甩代码有价值得多。考勤打卡、请假审批、月度统计听上去都是很常规的功能但真正落地时数据库表怎么设计、SpringBoot版本怎么选、打卡边界情况怎么处理、打包部署时配置文件怎么弄每一个环节都能让新手卡上大半天。这篇文章就从零开始把整个系统从设计到部署的关键节点全部过一遍既讲实现步骤也讲背后的取舍逻辑。1. 考勤系统到底在解决什么问题需求边界与模块划分1.1 企业考勤的常见痛点与系统的核心价值很多同学拿到这类题目第一反应是不就是个打卡吗实际做下来才发现真正的难点从来不在打卡本身而在打卡之后的统计和审批流程。传统人工考勤方式我见过太多Excel表格记出勤月底人事一个个核对迟到早退、请假调休全靠翻聊天记录遇到跨月排班直接算到怀疑人生。数据分散、标准不统一、追溯困难这就是考勤系统要解决的本质问题。系统上线后能做到的事情很明确员工自己打上班卡和下班卡数据自动落到库里管理员在后台维护员工信息、部门结构和请假审批系统按规则自动计算迟到、早退、异常缺卡月末一键生成考勤统计报表支持按部门和日期筛选所以这个系统的核心价值不是记录打卡这一个动作而是把考勤数据从散落状态变成结构化数据再通过规则自动输出结果替代人工核对。为了达成这个目标系统必须覆盖完整的业务闭环人员基础数据维护、打卡行为采集、考勤规则判定、请假审批流转、统计结果输出缺一环都会让考勤系统名不副实。1.2 核心功能模块与角色权限边界完整的考勤系统按角色切分会非常清晰。我把这套项目的功能模块拆成五大块员工管理模块员工信息的增删改查关联部门维护入职状态部门管理模块部门层级结构员工归属部门考勤打卡模块上班卡、下班卡登记打卡记录查询请假管理模块员工发起请假申请管理员审批支持请假类型区分统计报表模块按月份、按部门统计出勤情况展示迟到、请假、异常天数权限边界方面我采用了最务实的两级角色管理员和普通员工。管理员拥有全部模块的操作权限普通员工只能查看自己的考勤记录、提交自己的请假申请、查看自己的统计结果。页面上的按钮也是跟着角色走的管理员登录能看到员工管理部门管理菜单普通员工登录只能看到我的考勤我的请假。这样设计权限模型虽然简单但对接后端拦截器非常方便不会出现权限越界又难以追查的情况。提示我见过有些课设项目一上来就设计四五种角色RBAC、数据权限全上结果把大量时间耗在权限框架的配置上业务功能反而草草了事。做企业考勤系统两级角色完全够用先把核心业务跑通再考虑权限扩展。2. 技术选型与开发环境准备版本匹配决定了你的一天心情2.1 为什么是SpringBoot而不是SSH或SSM很多刚接触Java Web的同学会纠结框架选型。SSHStruts2 Spring Hibernate早就是历史包袱了不用考虑。SSMSpring SpringMVC MyBatis确实还能见到但配置繁琐光Spring和SpringMVC的XML配置文件就能写几百行。SpringBoot的价值在于把框架整合和自动配置这些脏活累活都干掉了起步依赖直接引入内置Tomcat一个main方法就能启动整个项目。特别是针对课设或者毕业设计这种既要功能完整又要按期交付的场景SpringBoot能省掉大量环境配置的时间把精力放在业务代码上。它的自动装配机制会自动配置数据源、事务管理器、Web容器开发人员只需要关注自己的业务逻辑。我个人的经验是如果从零搭SpringMVC可能花两天用SpringBoot起步十分钟就能跑出一个Hello World这个时间差距在赶论文和答辩的时候就是生死线。这套考勤系统最终选型是SpringBoot MyBatis-Plus MySQL。MyBatis-Plus的好处后面会专门说它把单表CRUD的代码量压缩到了一个令人舒适的程度。2.2 SpringBoot版本、JDK与数据库版本的匹配关系版本匹配是新手最容易踩坑的地方特别现在SpringBoot 3.x已经很普及了但它默认要求JDK 17而很多学校机房和本机环境还是JDK 8。我在这个项目里用的是SpringBoot 2.7.x JDK 8 MySQL 8.0的组合这是一个经过大量验证的稳定搭配也是大部分教材和网络教程默认的版本线。版本匹配的核心规则整理如下组件推荐版本注意事项JDK1.88u201之后SpringBoot 2.x必须JDK83.x需要JDK17SpringBoot2.7.14最后一个2.x维护版本稳定可靠MySQL8.0.34注意驱动名称是com.mysql.cj.jdbc.DriverMyBatis-Plus3.5.3.1兼容SpringBoot 2.x3.5.5开始强依赖新版Maven3.6.3IDEA自带Maven也行但建议指定本地仓库注意SpringBoot 3.x虽然性能更好但如果你要用JDK 8直接放弃3.x不用纠结。SpringBoot 2.7在Spring官方支持结束后社区维护和教程资源仍然充足用于课程设计完全可行。开发工具我用的是IDEA 2023.1 Navicat 16。IDEA的Spring Initializr可以直接快速生成项目骨架选中需要的依赖后自动下载并生成maven项目结构。Navicat主要负责数据库的建库建表和可视化调试。2.3 项目初始化的关键步骤我直接说初始化项目时的操作路径照着做基本不会出错IDEA里选择 Spring InitializrServer URL选择start.spring.io选择Java版本8包名建议com.example.attendance这种结构依赖勾选Spring Web、MyBatis Framework、MySQL Driver、Lombok生成项目后手动在pom.xml中引入MyBatis-Plus的依赖Spring Initializr里没有这个选项检查Maven仓库下载是否正常这一步如果网络不好会提前暴露问题如果IDEA创建时下载依赖一直失败多半是Maven源的问题。我习惯在Maven的settings.xml里配置阿里云镜像国内下载速度快很多。配置文件位置在Maven安装目录的conf目录下IDEA自带Maven的话路径在IDEA安装目录里也能找得到。pom.xml里还要注意一个点——SpringBoot 2.7的版本号不要动MyBatis-Plus的版本也不要盲目选最新我实测3.5.3.1配合2.7.x的SpringBoot完全没有兼容性问题再往上的版本反而可能出现需要用MyBatis-Plus自带启动类替换SpringBoot默认启动类的情况。3. 数据库设计考勤业务的表结构是如何一步步推演出来的3.1 部门、员工与用户账号基础数据的三层结构数据库表设计是整个系统的地基。地基不稳后面所有统计逻辑都会极其别扭。我先从最基础的三张表说起部门表、员工表、用户表。部门表dept最简设计只需要三个字段id、dept_name、create_time。如果要支持多级部门可以加parent_id字段。我在这个项目里加了parent_id因为做后期扩展的时候多级部门统计非常有用提前设计好字段比后期改表要省事得多。员工表employee是核心基础表字段包括id主键emp_no员工工号唯一索引emp_name姓名gender性别phone手机号dept_id关联部门表hire_date入职日期status在职状态1在职0离职员工表和部门表用dept_id关联这是一个典型的多对一关系。查询员工列表的时候用JOIN把部门名称查出来页面展示就非常自然。用户表user用来存登录账号信息。可能有人会问为什么不直接在员工表里加username和password字段我的做法是拆开。原因很简单员工表存的是基础人事数据用户表存的是系统账号数据职责分离。员工可能离职了账号需要禁用但基础数据还要留档而且同一个员工理论上未来可能有多个角色账号。拆开后用户表的字段就是id、employee_id、username、password、role、status、create_time。3.2 打卡记录表最需要想清楚的表打卡记录表是整个系统里设计难度最高的一张表。我最初设计时用过一张简单的表字段是employee_id、check_time、type上班卡/下班卡用TYPE字段区分上下班。但实际运行后发现这种设计在统计某天是否迟到早退时有致命缺陷——很难直接判断某一天是否打全了两张卡写统计SQL会变得异常痛苦。最终我采用了一条记录保存一整天的打卡情况的设计字段名类型说明idbigint主键employee_idbigint员工IDattendance_datedate打卡日期check_in_timedatetime上班打卡时间check_out_timedatetime下班打卡时间statusvarchar出勤状态正常/迟到/早退/缺卡remarkvarchar备注这样设计的好处非常明显一次打卡动作只需要根据employee_id attendance_date找到对应的记录然后更新check_in_time或check_out_time字段。统计某天迟到的人直接一条SQL查status迟到就出来了。一个月的考勤情况也就是一个范围查询。防止重复打卡的逻辑也变得简单如果某条记录的check_in_time已经不为空说明今天已经打过上班卡再打就提示已打卡。3.3 请假管理表与审批状态机请假表的字段设计要考虑审批状态流转。我的设计如下id主键employee_id申请人leave_type请假类型事假/病假/年假/调休start_time开始时间end_time结束时间leave_day请假天数由开始结束时间自动算出reason请假原因status审批状态0待审批1已通过2已驳回apply_time申请时间approver_id审批人IDapprove_time审批时间approve_remark审批意见这里有个容易忽略的实际细节请假天数leave_day的计算。如果只存开始时间和结束时间两个日期相减得到的是自然日天数但企业的请假通常按工作日计算。考虑到课设的复杂度和实际需求我采用的是结束日期减开始日期加一的方式比如9月1日请到9月3日天数就是3天。如果要精确到半天请假或者排除节假日就需要引入排班表和节假日表这个我建议放到扩展功能里去讲基础版本不做太复杂。3.4 数据库脚本编写与Navicat操作要点建表时需要注意几点这些都是我在实际操作中反复踩过的MySQL 8.0字符集选择utf8mb4而不是utf8。utf8mb4能存储emoji和更多特殊字符而且兼容性更好不会出现中文乱码字段注释要写全。我习惯在建表SQL里给每个字段加上COMMENT注释后面维护时能省大量时间时间字段建议用datetime类型日期用date类型不要全部用int时间戳。虽然int时间戳好比较但可读性差调试和写说明文档都不方便而且MySQL的datetime类型本身效率足够主键用自增id简单可靠Navicat操作方面我都是先写好SQL脚本再用Navicat执行。不直接在图形界面点着建表因为SQL脚本可以随着源码一起交付也可以在服务器上重复执行比手工点界面规范得多。建完表后我会顺手用Navicat的模型功能看一眼表关系图确认外键关联没有遗漏。经验之谈如果你用了MyBatis-Plus表名和实体类名的映射规则要注意。MyBatis-Plus默认开启驼峰转下划线映射比如实体类的attendanceDate会映射到数据库的attendance_dateEntity里的字段名不用刻意改成下划线风格自然写Java驼峰风格就行。但如果遇到数据库自带的保留字当字段名比如remarkdescribe这些要么加反引号要么换写法避免SQL报错。4. 后端核心接口的落地登录、打卡、统计与请假审批4.1 登录鉴权拦截器 Session的轻量方案登录鉴权方案我选了轻量级方案SpringBoot拦截器 Session没有引入Spring Security或者JWT。理由很直接课程设计级别的系统用Session存储登录状态已经足够代码写起来简单直观也容易在论文里讲清楚原理。Spring Security虽然更专业但配置复杂一旦不会用就卡进度得不偿失。具体实现流程前端提交username和password到/login接口后端根据username查出用户用BCrypt算法校验密码校验成功后将用户信息id、姓名、角色放入Session自定义HandlerInterceptor拦截器对需要登录的接口进行拦截拦截器判断Session中是否存在用户不存在则返回401状态码跳转登录页密码加密用BCrypt这个点很多同学会忽略直接明文存数据库。企业项目里明文密码是绝对不能接受的即便课设也建议养成好习惯。Spring Security中自带的BCryptPasswordEncoder可以单独引入也可以直接用spring-security-crypto这一个轻量依赖不必引入整套Security。拦截器还有个细节管理员和普通员工的接口权限拦截可以在登录时把角色信息写入Session在拦截器中判断当前访问的URL前缀。比如/admin/**开头的接口只允许管理员访问普通员工请求就会提示无权限。这个方案写起来几行代码但很好的撑起了角色权限管理。4.2 打卡接口边界判断是精华所在打卡接口表面上就是往数据库里写一条打卡时间但边界条件的处理才是真正的精华。我在实现时把逻辑分成了三层第一层判断当天是否已经有打卡记录。如果没有说明这是今天第一次打卡直接新增一条记录写入check_in_time默认状态暂时记为正常。第二层判断打卡类型。如果记录已经存在且check_in_time不为空check_out_time为空说明这次是打下班卡补充check_out_time。然后联查开始时间根据预设的上班时间和下班时间判断状态上班卡晚于规定时间就是迟到下班卡早于规定时间就是早退。第三层判断是否重复打卡。如果check_in_time和check_out_time都不为空说明今天上下班卡都已经打过了再请求就返回今天已完成打卡。考勤规则我放在了配置文件里比如上班时间09:00下班时间18:00。代码里读取规则然后和实际打卡时间比较。为什么放配置文件而不是数据库因为考勤规则是全局参数基本上几个月都不变放配置文件里一眼就能看到、改起来也方便项目维护者。打卡接口核心代码逻辑大概这样public Result doCheckIn(HttpServletRequest request) { Employee employee getCurrentEmployee(request); LocalDate today LocalDate.now(); AttendanceRecord record mapper.selectOne( new LambdaQueryWrapperAttendanceRecord() .eq(AttendanceRecord::getEmployeeId, employee.getId()) .eq(AttendanceRecord::getAttendanceDate, today) ); if (record null) { // 第一次打卡生成记录写入上班卡 record new AttendanceRecord(); record.setEmployeeId(employee.getId()); record.setAttendanceDate(today); record.setCheckInTime(LocalDateTime.now()); record.setStatus(calculateStatus(today, LocalDateTime.now(), false)); mapper.insert(record); return Result.success(上班打卡成功); } if (record.getCheckOutTime() null) { // 第二次打卡写入下班卡更新状态 record.setCheckOutTime(LocalDateTime.now()); record.setStatus(calculateStatus(today, LocalDateTime.now(), true)); mapper.updateById(record); return Result.success(下班打卡成功); } return Result.error(今日已完成上下班打卡); }注意LocalDateTime的使用不要用java.util.Date做时间运算LocalDateTime的API在处理比较和加减时比Date优雅太多了。4.3 考勤统计SQL聚合和Java内存计算如何取舍考勤统计数据主要分两个维度按员工维度统计和按部门维度统计。最简单直接的方案是写SQL聚合语句一次查出来但实际实现时我用了基础数据查询 Java内存统计的组合方式。原因是这样的考勤统计规则比较多比如本月出勤天数迟到次数请假天数如果全部在SQL里拼语句会很复杂后期加一条统计规则就要改SQL维护成本比较高。而先查出这个月的打卡记录列表和请假记录列表然后在Java代码里用循环统计虽然性能上不如一条聚合SQL但对课设级别的数据量一个月几百上千条记录来说耗时差异可以忽略而代码的可读性和可扩展性会好很多。统计逻辑的关键点正常出勤天数 当月打卡记录中status为正常且上下班卡齐全的数量迟到次数 status为迟到的记录数上班卡晚于规定时间早退次数 status为早退的记录数下班卡早于规定时间请假天数 当月请假审批通过的天数累加缺卡次数 上下班卡有一项为空的记录数统计结果我用一个AttendanceStatVO对象返回给前端前端用Thymeleaf或者Vue渲染成一个表格加上ECharts画柱状图展示迟到趋势演示效果就很好了。4.4 请假审批接口状态流转的控制请假接口涉及到从提交到审批的状态流转。我设计的接口有三个POST /leave/apply员工提交请假申请GET /leave/my员工查看自己的请假记录POST /leave/approve管理员审批请假审批接口里有个很容易忽略的点审批时除了更新状态还要校验这条申请确实是待审批状态。也就是说审批操作要带着乐观锁的意识。我在代码里先查询这条请假记录的status如果status不是0直接返回该申请已处理防止管理员在页面上双击或者两个管理员同时操作导致状态被覆盖。请假天数计算放在提交申请时完成服务端根据startTime和endTime计算后存库而不是前端传过来。这个习惯很重要前端传来的数据永远是不可信的服务端必须自己计算关键数据。事务方面请假审批不涉及复杂的事务单表更新就行。但打卡生成记录的时候如果涉及插入后续更新两个操作我加了Transactional注解。这个注解用起来简单却是很多新手容易忽略的等到出现半个操作成功半个失败的时候再补就麻烦了。5. 本地调试到部署上线把项目从IDE跑到服务器上的完整链路5.1 本地调试启动失败和接口报错的处理本地启动SpringBoot项目遇到比较多的问题我按出现的频率整理一下application.yml配置错误是启动失败的常见原因。数据库连接配置一定要检查这几项URL、username、password、driver-class-name。MySQL 8.0的驱动类名是com.mysql.cj.jdbc.Driver不是老版本的com.mysql.jdbc.Driver这个很多人会忽略。同时URL中要加上参数比如useUnicodetruecharacterEncodingutf8serverTimezoneAsia/Shanghai没加时区参数启动后执行SQL会报时间时区相关的错。Maven依赖没有下载全也会导致编译失败。解决办法是用IDEA右侧Maven面板里的刷新按钮或者命令行执行mvn clean compile -U强制重新下载快照包。端口占用是另一个高频问题。SpringBoot默认端口8080如果本地已有服务占用启动会报Port 8080 was already in use。解决办法是在application.yml里改端口或者找出占用进程kill掉。我习惯在配置里直接写server.port: 8081避免常见端口冲突。接口调试阶段我用的工具是Postman。测试期间建议把SpringBoot的日志级别调成DEBUG能看到SQL执行日志遇到SQL写错的情况排查效率翻倍。日志配置也是放在application.yml里的logging: level: com.example.attendance.mapper: debug5.2 打包部署jar包方式是最省心的上线方案SpringBoot项目最终交付有两种方式jar包和war包。我这套系统采用的是jar包方式。原因很明显SpringBoot内置Tomcatjar包方式一把梭不需要在服务器上额外安装Tomcat也不用处理繁琐的外部容器配置。war包方式还需要修改启动类继承SpringBootServletInitializer然后部署到Tomcat webapps目录下多好几步操作。打包命令mvn clean package -DskipTests打包完成后target目录下会生成attendance-system-0.0.1-SNAPSHOT.jar。把这个jar包上传到服务器上执行nohup java -jar attendance-system-0.0.1-SNAPSHOT.jar app.log 21 这里用nohup和后台运行日志输出到app.log关闭终端也不影响程序运行。查看日志用tail -f app.log。如果需要停掉服务先lsof -i:8080找到进程PID然后kill -9 PID。新手在服务器部署时经常遇到的问题是数据库连接失败。因为本机的MySQL账号密码和服务器上的不一样。如果你把数据库配置写死在application.yml里每次打包部署都要改一份非常容易出错。我的做法是把配置文件中的数据库连接信息改为读取环境变量spring: datasource: url: jdbc:mysql://${DB_HOST:localhost}:${DB_PORT:3306}/${DB_NAME:attendance}?serverTimezoneAsia/Shanghai username: ${DB_USER:root} password: ${DB_PASSWORD:123456}这样本机调试不设置环境变量也能用默认值跑起来服务器部署时通过环境变量注入真实值代码不用改。这个小习惯在正式项目里非常常见课程设计里早用上会显得专业很多。5.3 前端资源的组织Thymeleaf还是前后端分离这个项目我用的方案是Thymeleaf Bootstrap的经典服务端渲染模式。虽然现在前后端分离是大趋势但课设和毕设项目里Thymeleaf能省去跨域、token存储、前端路由等一大堆麻烦事。Thymeleaf的优势一个是模板和静态资源SpringBoot原生支持不需要额外配置就能跑起来另一个是后端渲染页面登录状态检查起来更方便拦截器通过判断Session有没有用户就决定放行还是跳转。对于考勤管理系统这种后台管理类系统页面交互不复杂不需要Vue这种渐进式框架的响应式优势。页面数量也不算多登录页、员工管理页、部门管理页、打卡页、考勤记录页、请假申请页、统计报表页一共7个页面。Bootstrap的现成样式改一改就能做到界面整洁我在系统界面截图里能看到最终渲染效果表格和小按钮的质感对课设来说完全在线。如果小伙伴想用Vue重写前端也可以把后端接口做成RESTful风格前端用axios对接本质上后端代码不用大改只是多配一个跨域过滤器。6. 项目跑通之后时间时区、依赖冲突和未来的扩展思路6.1 日期时间类bug的集中排查考勤系统对时间极其敏感踩过的日期时间坑我列出来大家遇到可以直接对照排查数据库时区问题MySQL连接串必须加serverTimezoneAsia/Shanghai。否则MyBatis操作datetime字段时会发现取出来的时间和实际时间差8小时或者14小时。这个8小时问题在中国区开发场景中是出现频率非常高的。Java端日期处理不一致代码里有的地方用new Date()有的地方用LocalDateTime.now()排序和比较时非常容易出问题。我在这个项目里强制统一使用LocalDate和LocalDateTime只有Entity类映射数据库字段时才转java.util.Date。日期格式化前端提交日期字符串到后端如果格式不匹配会绑定失败。我通过DateTimeFormat(pattern yyyy-MM-dd)注解指定了接收格式并在全局异常处理中捕获类型转换异常给前端返回友好提示而不是默认的500错误页。月底和跨月边界算考勤范围时注意月份的天数。我封装了一个工具方法用YearMonth.parse(yearMonth).lengthOfMonth()获取当月最后一天避免手动写死30天或者31天。6.2 Maven依赖冲突的常见情况与处理办法依赖冲突在项目中几乎必然出现最典型的是MyBatis-Plus和SpringBoot内置的MyBatis版本冲突。如果pom.xml里手动引入了org.mybatis:mybatis的某个版本又引入了mybatis-plus-boot-starter后者自带对应版本的MyBatis两个版本不一致就会出现Invalid bound statement (not found)的报错方法映射不上。解决办法是只保留MyBatis-Plus的starter依赖删掉手动引入的MyBatis依赖。用IDEA打开Maven面板点击Show Dependencies能看到依赖树排查冲突非常直观。另外一个经验是引入Lombok后如果IDEA版本较老运行时会出现java: package lombok does not exist。这不是依赖冲突而是IDEA没有安装Lombok插件导致的编译问题。安装插件或者升级IDEA版本即可。6.3 从课设项目到企业级系统的扩展方向最后说点后续可以继续做的方向。很多同学交完项目就完事了但如果时间允许我建议在现有基础上往这几个方向扩展能讲出更多亮点缓存层引入Redis缓存用户登录信息和考勤统计结果降低数据库压力权限框架把Session拦截器替换为Spring Security JWT支持多角色细粒度权限控制消息通知引入Spring Boot整合ActiveMQ或RabbitMQ实现请假审批通过后发站内消息或邮件通知打卡方式升级在现在的手动点击打卡基础上增加人脸识别打卡或定位打卡接口对接第三方SDK排班系统增加班次管理支持不同部门不同班次考勤规则从单规则变成多班次匹配这几个方向随便选一个深入下去都能让系统从课设水平往工程水平迈进一大步。我个人第一次扩展就加了Redis缓存统计结果改动量不大但对接口响应速度的提升肉眼可见答辩的时候也更容易展现思考深度。考勤系统这套项目做完给我最大的感受是完整的业务系统开发真正的难点不是某个技术点而是把散落的业务需求有序地拆成数据表、接口、页面再把它们串起来。如果你正在做类似的项目抓住先设计表再设计接口最后写页面这条主线多数坑都能提前避开。过程中遇到具体报错别慌优先看日志和排查配置大部分问题都能在十分钟内解决。