简介这是一套面向高校计算机专业学生与Java初学者的人事人力资源管理系统完整开发资料适用于毕业设计、课程大作业及期末实训场景。系统采用JSP技术构建B/S架构基于MyEclipse开发环境与Tomcat服务器通过JDBC实现与MySQL数据库的无缝连接整体具备较好的完整性与安全性。功能覆盖系统管理员、部门信息、员工信息、合同管理、绩效管理含员工工资与奖惩记录以及考勤管理六大模块结构清晰便于二次开发与功能扩展。资源包共116个文件约3.02MB以69个JSP页面为主体辅以CSS样式、JS脚本、GIF与JPG界面素材、JAR依赖包并附有SQL数据库文件、开题报告文档及演示视频从需求分析到运行部署均有对应材料支撑。目前已有65人学习下载适合需要快速搭建可运行系统、撰写开题报告并完成答辩演示的读者参考使用。1. 从一份 Java 人事系统源码包说起它到底能解决什么问题很多做 Java 课程设计或者企业内训的同行手里都攥过类似「基于 Java 的人事人力资源管理系统」这样的题目。它不像电商秒杀那样有高并发光环也不像推荐算法那样自带话题度但它是绝大多数 Java 工程师从「会写增删改查」到「能交付一个完整业务系统」之间绕不开的一道坎。这个标题背后其实是一整套东西一套可运行的源码、一份开题报告、一份数据库文件外加一段演示视频。它解决的不是什么高深算法问题而是让一个新手或者需要交差的人能在本地把一套带权限、带审批流、带报表的人事系统跑起来并且能讲清楚每一层是怎么串起来的。这套东西适合谁第一类是在校生课程设计或者毕业设计需要一个人力资源管理系统要求有源码、有数据库、有文档最好还能录个演示视频交上去。第二类是刚转 Java 的初级开发想找一个业务闭环完整、技术栈不过时的项目练手比看纯理论视频强得多。第三类是小团队的技术负责人想拿一套现成的骨架改造成内部简易 HR 工具省去从零搭权限和基础模块的时间。需要提前说清楚的是这类源码包的质量参差不齐有的用 ServletJSP 写有的用 Spring BootMyBatis-Plus数据库从 MySQL 5.7 到 8.0 都有拿到手第一件事不是急着跑而是先判断它的技术栈和你的环境能不能对上。我见过太多人拿到压缩包解压、导入 IDE、点运行然后报一堆错就扔在一边了。其实这类系统的落地路径非常固定先看数据库脚本再对后端配置最后跑前端。顺序反了就会在「java 启动失败怎么解决」这种问题上耗掉一整天。下面几章我会按这个顺序把一套典型的人事人力资源管理系统从环境配置到核心模块实现再到避坑和进阶完整拆一遍。你照着做大概率能在一两个小时内看到登录页。2. 环境与数据库先行把 MySQL 脚本跑通再谈代码2.1 技术栈判断拿到源码包先看这三个文件解压之后不要急着用 IDE 打开整个目录先做一次「技术栈体检」。我一般会先找三个东西pom.xml或build.gradle、application.yml或application.properties、以及一个后缀为.sql的数据库文件。这三个文件基本决定了你后面所有操作的方向。pom.xml里重点看 Spring Boot 的版本和持久层框架。如果是spring-boot-starter-parent2.x 配mybatis-plus-boot-starter那说明这是一套比较现代的写法实体类可以直接用 MyBatis-Plus 的注解生成表结构省去手写大量 XML。如果是spring-boot-starter-jdbc配一堆.xml映射文件那就是传统 MyBatis 风格改起来稍微麻烦一点。数据库文件则决定了你本地要装 MySQL 还是别的绝大多数人事系统用的是 MySQL字符集一般是utf8mb4。这里有个血泪经验有些源码包里的 SQL 文件是用 Navicat 导出的里面带了SET FOREIGN_KEY_CHECKS0和大量DROP TABLE IF EXISTS直接在生产库跑会清空数据。所以导入前一定新建一个空库比如hr_system再执行脚本。2.2 用命令行导入数据库文件并校验表结构假设你已经装好 MySQL 8.0并且mysql命令在 PATH 里。下面这套命令是我常用的导入流程比图形化工具更可控出错时能看到具体是哪一行 SQL 有问题。# 登录 MySQL注意 -p 后面不要跟空格再跟密码回车后输入密码更安全 mysql -u root -p # 创建专用数据库字符集必须和 SQL 文件里的保持一致 CREATE DATABASE hr_system DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; # 切换到该库 USE hr_system; # 导入 SQL 文件路径用绝对路径或当前目录相对路径 SOURCE /path/to/your/hr_system.sql; # 导入完成后检查表数量一般人事系统在 15 到 30 张表之间 SHOW TABLES; # 重点看几张核心表是否存在用户表、员工表、部门表、考勤表、薪资表 SELECT COUNT(*) FROM information_schema.tables WHERE table_schema hr_system;这段命令的逻辑很直接先建库再切库再执行脚本。参数上唯一需要注意的是SOURCE后面的路径Windows 下用正斜杠或者双反斜杠否则会报Failed to open file。导入完成后SHOW TABLES的输出里如果能看到sys_user、hr_employee、hr_department、hr_attendance、hr_salary这类表名说明数据库这一层基本没问题。如果导入过程中报Unknown character set: utf8mb4_0900_ai_ci说明你的 MySQL 版本低于 8.0而脚本是按 8.0 的排序规则导出的。解决办法是把脚本里的utf8mb4_0900_ai_ci全部替换成utf8mb4_general_ci再重新导入。这个坑非常常见尤其是从别人那里拿到的源码包。2.3 后端配置文件的四个必改项数据库跑通之后打开application.yml重点改四个地方。这四个地方不改启动必报错。spring: datasource: driver-class-name: com.mysql.cj.jdbc.Driver url: jdbc:mysql://localhost:3306/hr_system?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/ShanghaiuseSSLfalse username: root password: 你的数据库密码 jackson: date-format: yyyy-MM-dd HH:mm:ss time-zone: GMT8 server: port: 8080第一项是driver-class-nameMySQL 8.0 必须用com.mysql.cj.jdbc.Driver用老的com.mysql.jdbc.Driver会提示驱动已废弃。第二项是url里的serverTimezone不写或者写错会导致时间字段差 8 小时考勤和薪资模块直接算错。第三项是username和password改成你本地实际的。第四项是server.port如果 8080 被占用改成 8081 或 9090但前端配置里的接口地址也要同步改。改完这四项再检查一下mybatis-plus的配置看看mapper-locations指向的路径和实际 XML 文件位置是否一致。有些源码包把 XML 放在resources/mapper下配置里却写的是classpath:/mapper/*.xml少一层目录就会导致Invalid bound statement错误。3. 核心模块实现从员工档案到考勤薪资的代码拆解3.1 员工档案模块实体类与 MyBatis-Plus 的配合人事系统最核心的表就是员工表。一个设计合理的hr_employee表通常包含工号、姓名、性别、身份证号、部门 ID、职位、入职日期、状态等字段。用 MyBatis-Plus 的话实体类写起来非常简洁。Data TableName(hr_employee) public class Employee { TableId(type IdType.AUTO) private Long id; private String empNo; private String name; private Integer gender; private String idCard; private Long deptId; private String position; JsonFormat(pattern yyyy-MM-dd) private LocalDate hireDate; private Integer status; TableField(fill FieldFill.INSERT) private LocalDateTime createTime; }这段代码里TableName指定表名TableId指定主键策略为自增。JsonFormat解决日期返回前端时的格式问题不加的话前端拿到的是时间戳或者带 T 的 ISO 格式。TableField(fill FieldFill.INSERT)配合一个MetaObjectHandler实现类可以在插入时自动填充创建时间省去每次手动 set。对应的 Mapper 接口只需要继承BaseMapperEmployee分页查询用PageEmployee对象条件构造器用LambdaQueryWrapper。比如按部门查在职员工LambdaQueryWrapperEmployee wrapper new LambdaQueryWrapper(); wrapper.eq(Employee::getDeptId, deptId) .eq(Employee::getStatus, 1) .orderByDesc(Employee::getHireDate); PageEmployee page new Page(pageNum, pageSize); employeeMapper.selectPage(page, wrapper);参数说明deptId是部门主键status为 1 表示在职pageNum和pageSize由前端传入。这里有个容易翻车的地方如果deptId传的是 nulleq条件不会生效会查出所有部门的员工。所以前端传参时要做非空校验或者后端用wrapper.eq(deptId ! null, Employee::getDeptId, deptId)这种带条件的写法。3.2 考勤与薪资两个最容易出计算错误的地方考勤模块的难点不在增删改查而在状态判断和统计。一张hr_attendance表通常记录员工每天的上下午打卡时间、考勤状态正常、迟到、早退、缺卡、请假。计算迟到不能简单比较字符串要把打卡时间转成LocalTime再和规定的上班时间比。LocalTime workStart LocalTime.of(9, 0); LocalTime actual attendance.getCheckInTime().toLocalTime(); if (actual.isAfter(workStart)) { long minutes Duration.between(workStart, actual).toMinutes(); attendance.setStatus(minutes 30 ? 3 : 2); // 3 严重迟到2 迟到 }这段逻辑里Duration.between算出的分钟数用于区分迟到等级。参数30是阈值不同公司规定不同有的 15 分钟有的 60 分钟改这个数字就行。注意toLocalTime()的前提是数据库里存的是datetime或timestamp如果存的是字符串先解析再比较。薪资模块更容易出问题。基本工资、岗位工资、绩效、考勤扣款、社保公积金每一项都要从不同表里取数再汇总。我一般会把计算逻辑单独抽一个SalaryCalculator类输入员工 ID 和月份输出薪资明细对象。这样测试的时候可以脱离 Controller 直接跑单元测试比在页面上点来点去高效得多。计算顺序上先算应发合计再算各项扣款最后算实发。扣款里考勤扣款依赖考勤统计结果所以考勤模块必须先跑完。3.3 权限控制用注解做行级权限的常见做法人事系统里普通员工只能看自己的档案和薪资部门经理能看本部门HR 能看全部。这种行级权限用 Spring Security 或者 Shiro 都能做但最轻量的方式是在 Service 层加自定义注解加 AOP 切面。Target(ElementType.METHOD) Retention(RetentionPolicy.RUNTIME) public interface DataScope { String deptAlias() default d; String userAlias() default u; }切面里根据当前登录用户的角色拼接 SQL 的WHERE条件。如果是管理员不加条件如果是部门经理加dept_id 当前用户部门如果是普通员工加user_id 当前用户。这种做法的好处是不侵入业务代码坏处是 SQL 拼接要小心注入所有参数必须走预编译。常见做法是用 MyBatis-Plus 的QueryWrapper在切面里追加条件而不是直接拼字符串。4. 避坑与排查人事系统落地时最容易翻车的五件事4.1 启动报错 Unknown database 或 Access denied现象是 Spring Boot 启动时抛java.sql.SQLSyntaxErrorException: Unknown database hr_system或者Access denied for user rootlocalhost。原因通常是数据库没建、库名拼错、或者密码不对。解决方法是回到 MySQL 命令行用SHOW DATABASES;确认库存在用SELECT user, host FROM mysql.user;确认账号允许从 localhost 连接。如果是 MySQL 8.0 且用了caching_sha2_password插件老版本客户端可能连不上需要执行ALTER USER rootlocalhost IDENTIFIED WITH mysql_native_password BY 新密码;再刷新权限。4.2 前端页面空白或接口 404现象是后端启动正常浏览器打开前端页面一片空白F12 看到接口请求返回 404。原因一般是前端配置的接口基地址和后端实际端口不一致或者跨域被拦。解决方法是检查前端vue.config.js或.env文件里的VUE_APP_BASE_API确保指向http://localhost:8080。跨域问题在后端加一个CorsConfig配置类允许所有来源、所有方法开发阶段够用上线前再收紧。4.3 日期字段差 8 小时导致考勤算错现象是数据库里存的时间是对的但页面上显示少了 8 小时或者考勤统计把正常打卡算成迟到。原因是 JDBC 连接串里没配serverTimezone或者配成了UTC。解决方法是在url里明确写serverTimezoneAsia/Shanghai同时application.yml里jackson的time-zone也设为GMT8。两个地方都改缺一不可。4.4 分页查询总数不对或每页条数失效现象是分页插件没生效查出来永远是全部数据或者总数一直是 0。原因是 MyBatis-Plus 的分页插件没有注册。解决方法是新建一个配置类加上MybatisPlusInterceptor并注册PaginationInnerInterceptor指定数据库类型为DbType.MYSQL。这个配置类很多源码包里漏掉了需要自己补。4.5 导入 SQL 后中文乱码现象是员工姓名、部门名称显示成问号或者乱码。原因是数据库、表、连接三处的字符集不一致。解决方法是建库时用utf8mb4导入前在 SQL 文件开头加SET NAMES utf8mb4;连接串里加characterEncodingutf8。三处统一之后乱码问题基本不会再出现。5. 进阶技巧用实体类反向生成建表 SQL 与接口自测5.1 用 MyBatis-Plus 实体类生成建表语句有时候你拿到的是源码但没有数据库文件或者想基于现有实体类重建一套表结构。MyBatis-Plus 本身不直接提供建表功能但可以借助它的TableInfoHelper拿到实体类的元信息再拼 SQL。下面这段代码我经常用来快速生成建表语句省去手写 DDL 的时间。public String generateCreateTableSql(Class? entityClass) { TableInfo tableInfo TableInfoHelper.getTableInfo(entityClass); StringBuilder sql new StringBuilder(CREATE TABLE IF NOT EXISTS ); sql.append(tableInfo.getTableName()).append( (); tableInfo.getFieldList().forEach(field - { sql.append(field.getColumn()).append( ) .append(field.getPropertyType().getSimpleName().equals(String) ? VARCHAR(255) : BIGINT) .append( COMMENT ).append(field.getComment()).append(,); }); sql.append(PRIMARY KEY ().append(tableInfo.getKeyColumn()).append()) ENGINEInnoDB DEFAULT CHARSETutf8mb4;); return sql.toString(); }这段代码的逻辑是先通过TableInfoHelper拿到实体类对应的表名、主键、字段列表然后遍历字段拼出列定义。参数上field.getComment()取的是实体类字段上TableField注解里的value或者注释如果没有就为空。实际使用时类型映射需要更细致比如LocalDate映射DATELocalDateTime映射DATETIMEInteger映射INT。这个技巧适合快速搭原型正式环境还是建议用 Flyway 或 Liquibase 管理 DDL 版本。5.2 接口自测不启动前端也能验证核心逻辑很多人习惯启动整个前后端再点页面测试效率很低。我一般用MockMvc或者直接写SpringBootTest加TestRestTemplate来测接口。比如测员工新增接口SpringBootTest(webEnvironment SpringBootTest.WebEnvironment.RANDOM_PORT) class EmployeeApiTest { Autowired private TestRestTemplate restTemplate; Test void testAddEmployee() { Employee emp new Employee(); emp.setEmpNo(E1001); emp.setName(张三); emp.setDeptId(1L); emp.setStatus(1); ResponseEntityString response restTemplate.postForEntity(/api/employee, emp, String.class); assertEquals(200, response.getStatusCodeValue()); } }这段测试代码启动一个随机端口的完整 Spring 上下文直接发 HTTP 请求。参数说明webEnvironment RANDOM_PORT避免和本地 8080 冲突postForEntity的第二个参数是请求体对象第三个是返回类型。跑通这个测试说明 Controller、Service、Mapper、数据库整条链路都是通的比在页面上点一遍可靠得多。5.3 一个我坚持了很久的习惯每次拿到一套新源码我不会先看业务代码而是先跑通「登录 → 查列表 → 新增一条 → 再查列表」这条最小闭环。这条链路通了说明环境、数据库、权限、前后端联调都没大问题剩下的就是业务细节。这个习惯帮我省下了大量在环境问题上反复折腾的时间。人事系统这类项目技术难度不高但细节琐碎能把最小闭环先跑通的人后面改需求、加模块都会顺很多。希望帮到你。本文还有配套的精品资源点击获取 Java人事系统源码包实战：从环境配置到核心模块的完整落地指南
简介这是一套面向高校计算机专业学生与Java初学者的人事人力资源管理系统完整开发资料适用于毕业设计、课程大作业及期末实训场景。系统采用JSP技术构建B/S架构基于MyEclipse开发环境与Tomcat服务器通过JDBC实现与MySQL数据库的无缝连接整体具备较好的完整性与安全性。功能覆盖系统管理员、部门信息、员工信息、合同管理、绩效管理含员工工资与奖惩记录以及考勤管理六大模块结构清晰便于二次开发与功能扩展。资源包共116个文件约3.02MB以69个JSP页面为主体辅以CSS样式、JS脚本、GIF与JPG界面素材、JAR依赖包并附有SQL数据库文件、开题报告文档及演示视频从需求分析到运行部署均有对应材料支撑。目前已有65人学习下载适合需要快速搭建可运行系统、撰写开题报告并完成答辩演示的读者参考使用。1. 从一份 Java 人事系统源码包说起它到底能解决什么问题很多做 Java 课程设计或者企业内训的同行手里都攥过类似「基于 Java 的人事人力资源管理系统」这样的题目。它不像电商秒杀那样有高并发光环也不像推荐算法那样自带话题度但它是绝大多数 Java 工程师从「会写增删改查」到「能交付一个完整业务系统」之间绕不开的一道坎。这个标题背后其实是一整套东西一套可运行的源码、一份开题报告、一份数据库文件外加一段演示视频。它解决的不是什么高深算法问题而是让一个新手或者需要交差的人能在本地把一套带权限、带审批流、带报表的人事系统跑起来并且能讲清楚每一层是怎么串起来的。这套东西适合谁第一类是在校生课程设计或者毕业设计需要一个人力资源管理系统要求有源码、有数据库、有文档最好还能录个演示视频交上去。第二类是刚转 Java 的初级开发想找一个业务闭环完整、技术栈不过时的项目练手比看纯理论视频强得多。第三类是小团队的技术负责人想拿一套现成的骨架改造成内部简易 HR 工具省去从零搭权限和基础模块的时间。需要提前说清楚的是这类源码包的质量参差不齐有的用 ServletJSP 写有的用 Spring BootMyBatis-Plus数据库从 MySQL 5.7 到 8.0 都有拿到手第一件事不是急着跑而是先判断它的技术栈和你的环境能不能对上。我见过太多人拿到压缩包解压、导入 IDE、点运行然后报一堆错就扔在一边了。其实这类系统的落地路径非常固定先看数据库脚本再对后端配置最后跑前端。顺序反了就会在「java 启动失败怎么解决」这种问题上耗掉一整天。下面几章我会按这个顺序把一套典型的人事人力资源管理系统从环境配置到核心模块实现再到避坑和进阶完整拆一遍。你照着做大概率能在一两个小时内看到登录页。2. 环境与数据库先行把 MySQL 脚本跑通再谈代码2.1 技术栈判断拿到源码包先看这三个文件解压之后不要急着用 IDE 打开整个目录先做一次「技术栈体检」。我一般会先找三个东西pom.xml或build.gradle、application.yml或application.properties、以及一个后缀为.sql的数据库文件。这三个文件基本决定了你后面所有操作的方向。pom.xml里重点看 Spring Boot 的版本和持久层框架。如果是spring-boot-starter-parent2.x 配mybatis-plus-boot-starter那说明这是一套比较现代的写法实体类可以直接用 MyBatis-Plus 的注解生成表结构省去手写大量 XML。如果是spring-boot-starter-jdbc配一堆.xml映射文件那就是传统 MyBatis 风格改起来稍微麻烦一点。数据库文件则决定了你本地要装 MySQL 还是别的绝大多数人事系统用的是 MySQL字符集一般是utf8mb4。这里有个血泪经验有些源码包里的 SQL 文件是用 Navicat 导出的里面带了SET FOREIGN_KEY_CHECKS0和大量DROP TABLE IF EXISTS直接在生产库跑会清空数据。所以导入前一定新建一个空库比如hr_system再执行脚本。2.2 用命令行导入数据库文件并校验表结构假设你已经装好 MySQL 8.0并且mysql命令在 PATH 里。下面这套命令是我常用的导入流程比图形化工具更可控出错时能看到具体是哪一行 SQL 有问题。# 登录 MySQL注意 -p 后面不要跟空格再跟密码回车后输入密码更安全 mysql -u root -p # 创建专用数据库字符集必须和 SQL 文件里的保持一致 CREATE DATABASE hr_system DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; # 切换到该库 USE hr_system; # 导入 SQL 文件路径用绝对路径或当前目录相对路径 SOURCE /path/to/your/hr_system.sql; # 导入完成后检查表数量一般人事系统在 15 到 30 张表之间 SHOW TABLES; # 重点看几张核心表是否存在用户表、员工表、部门表、考勤表、薪资表 SELECT COUNT(*) FROM information_schema.tables WHERE table_schema hr_system;这段命令的逻辑很直接先建库再切库再执行脚本。参数上唯一需要注意的是SOURCE后面的路径Windows 下用正斜杠或者双反斜杠否则会报Failed to open file。导入完成后SHOW TABLES的输出里如果能看到sys_user、hr_employee、hr_department、hr_attendance、hr_salary这类表名说明数据库这一层基本没问题。如果导入过程中报Unknown character set: utf8mb4_0900_ai_ci说明你的 MySQL 版本低于 8.0而脚本是按 8.0 的排序规则导出的。解决办法是把脚本里的utf8mb4_0900_ai_ci全部替换成utf8mb4_general_ci再重新导入。这个坑非常常见尤其是从别人那里拿到的源码包。2.3 后端配置文件的四个必改项数据库跑通之后打开application.yml重点改四个地方。这四个地方不改启动必报错。spring: datasource: driver-class-name: com.mysql.cj.jdbc.Driver url: jdbc:mysql://localhost:3306/hr_system?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/ShanghaiuseSSLfalse username: root password: 你的数据库密码 jackson: date-format: yyyy-MM-dd HH:mm:ss time-zone: GMT8 server: port: 8080第一项是driver-class-nameMySQL 8.0 必须用com.mysql.cj.jdbc.Driver用老的com.mysql.jdbc.Driver会提示驱动已废弃。第二项是url里的serverTimezone不写或者写错会导致时间字段差 8 小时考勤和薪资模块直接算错。第三项是username和password改成你本地实际的。第四项是server.port如果 8080 被占用改成 8081 或 9090但前端配置里的接口地址也要同步改。改完这四项再检查一下mybatis-plus的配置看看mapper-locations指向的路径和实际 XML 文件位置是否一致。有些源码包把 XML 放在resources/mapper下配置里却写的是classpath:/mapper/*.xml少一层目录就会导致Invalid bound statement错误。3. 核心模块实现从员工档案到考勤薪资的代码拆解3.1 员工档案模块实体类与 MyBatis-Plus 的配合人事系统最核心的表就是员工表。一个设计合理的hr_employee表通常包含工号、姓名、性别、身份证号、部门 ID、职位、入职日期、状态等字段。用 MyBatis-Plus 的话实体类写起来非常简洁。Data TableName(hr_employee) public class Employee { TableId(type IdType.AUTO) private Long id; private String empNo; private String name; private Integer gender; private String idCard; private Long deptId; private String position; JsonFormat(pattern yyyy-MM-dd) private LocalDate hireDate; private Integer status; TableField(fill FieldFill.INSERT) private LocalDateTime createTime; }这段代码里TableName指定表名TableId指定主键策略为自增。JsonFormat解决日期返回前端时的格式问题不加的话前端拿到的是时间戳或者带 T 的 ISO 格式。TableField(fill FieldFill.INSERT)配合一个MetaObjectHandler实现类可以在插入时自动填充创建时间省去每次手动 set。对应的 Mapper 接口只需要继承BaseMapperEmployee分页查询用PageEmployee对象条件构造器用LambdaQueryWrapper。比如按部门查在职员工LambdaQueryWrapperEmployee wrapper new LambdaQueryWrapper(); wrapper.eq(Employee::getDeptId, deptId) .eq(Employee::getStatus, 1) .orderByDesc(Employee::getHireDate); PageEmployee page new Page(pageNum, pageSize); employeeMapper.selectPage(page, wrapper);参数说明deptId是部门主键status为 1 表示在职pageNum和pageSize由前端传入。这里有个容易翻车的地方如果deptId传的是 nulleq条件不会生效会查出所有部门的员工。所以前端传参时要做非空校验或者后端用wrapper.eq(deptId ! null, Employee::getDeptId, deptId)这种带条件的写法。3.2 考勤与薪资两个最容易出计算错误的地方考勤模块的难点不在增删改查而在状态判断和统计。一张hr_attendance表通常记录员工每天的上下午打卡时间、考勤状态正常、迟到、早退、缺卡、请假。计算迟到不能简单比较字符串要把打卡时间转成LocalTime再和规定的上班时间比。LocalTime workStart LocalTime.of(9, 0); LocalTime actual attendance.getCheckInTime().toLocalTime(); if (actual.isAfter(workStart)) { long minutes Duration.between(workStart, actual).toMinutes(); attendance.setStatus(minutes 30 ? 3 : 2); // 3 严重迟到2 迟到 }这段逻辑里Duration.between算出的分钟数用于区分迟到等级。参数30是阈值不同公司规定不同有的 15 分钟有的 60 分钟改这个数字就行。注意toLocalTime()的前提是数据库里存的是datetime或timestamp如果存的是字符串先解析再比较。薪资模块更容易出问题。基本工资、岗位工资、绩效、考勤扣款、社保公积金每一项都要从不同表里取数再汇总。我一般会把计算逻辑单独抽一个SalaryCalculator类输入员工 ID 和月份输出薪资明细对象。这样测试的时候可以脱离 Controller 直接跑单元测试比在页面上点来点去高效得多。计算顺序上先算应发合计再算各项扣款最后算实发。扣款里考勤扣款依赖考勤统计结果所以考勤模块必须先跑完。3.3 权限控制用注解做行级权限的常见做法人事系统里普通员工只能看自己的档案和薪资部门经理能看本部门HR 能看全部。这种行级权限用 Spring Security 或者 Shiro 都能做但最轻量的方式是在 Service 层加自定义注解加 AOP 切面。Target(ElementType.METHOD) Retention(RetentionPolicy.RUNTIME) public interface DataScope { String deptAlias() default d; String userAlias() default u; }切面里根据当前登录用户的角色拼接 SQL 的WHERE条件。如果是管理员不加条件如果是部门经理加dept_id 当前用户部门如果是普通员工加user_id 当前用户。这种做法的好处是不侵入业务代码坏处是 SQL 拼接要小心注入所有参数必须走预编译。常见做法是用 MyBatis-Plus 的QueryWrapper在切面里追加条件而不是直接拼字符串。4. 避坑与排查人事系统落地时最容易翻车的五件事4.1 启动报错 Unknown database 或 Access denied现象是 Spring Boot 启动时抛java.sql.SQLSyntaxErrorException: Unknown database hr_system或者Access denied for user rootlocalhost。原因通常是数据库没建、库名拼错、或者密码不对。解决方法是回到 MySQL 命令行用SHOW DATABASES;确认库存在用SELECT user, host FROM mysql.user;确认账号允许从 localhost 连接。如果是 MySQL 8.0 且用了caching_sha2_password插件老版本客户端可能连不上需要执行ALTER USER rootlocalhost IDENTIFIED WITH mysql_native_password BY 新密码;再刷新权限。4.2 前端页面空白或接口 404现象是后端启动正常浏览器打开前端页面一片空白F12 看到接口请求返回 404。原因一般是前端配置的接口基地址和后端实际端口不一致或者跨域被拦。解决方法是检查前端vue.config.js或.env文件里的VUE_APP_BASE_API确保指向http://localhost:8080。跨域问题在后端加一个CorsConfig配置类允许所有来源、所有方法开发阶段够用上线前再收紧。4.3 日期字段差 8 小时导致考勤算错现象是数据库里存的时间是对的但页面上显示少了 8 小时或者考勤统计把正常打卡算成迟到。原因是 JDBC 连接串里没配serverTimezone或者配成了UTC。解决方法是在url里明确写serverTimezoneAsia/Shanghai同时application.yml里jackson的time-zone也设为GMT8。两个地方都改缺一不可。4.4 分页查询总数不对或每页条数失效现象是分页插件没生效查出来永远是全部数据或者总数一直是 0。原因是 MyBatis-Plus 的分页插件没有注册。解决方法是新建一个配置类加上MybatisPlusInterceptor并注册PaginationInnerInterceptor指定数据库类型为DbType.MYSQL。这个配置类很多源码包里漏掉了需要自己补。4.5 导入 SQL 后中文乱码现象是员工姓名、部门名称显示成问号或者乱码。原因是数据库、表、连接三处的字符集不一致。解决方法是建库时用utf8mb4导入前在 SQL 文件开头加SET NAMES utf8mb4;连接串里加characterEncodingutf8。三处统一之后乱码问题基本不会再出现。5. 进阶技巧用实体类反向生成建表 SQL 与接口自测5.1 用 MyBatis-Plus 实体类生成建表语句有时候你拿到的是源码但没有数据库文件或者想基于现有实体类重建一套表结构。MyBatis-Plus 本身不直接提供建表功能但可以借助它的TableInfoHelper拿到实体类的元信息再拼 SQL。下面这段代码我经常用来快速生成建表语句省去手写 DDL 的时间。public String generateCreateTableSql(Class? entityClass) { TableInfo tableInfo TableInfoHelper.getTableInfo(entityClass); StringBuilder sql new StringBuilder(CREATE TABLE IF NOT EXISTS ); sql.append(tableInfo.getTableName()).append( (); tableInfo.getFieldList().forEach(field - { sql.append(field.getColumn()).append( ) .append(field.getPropertyType().getSimpleName().equals(String) ? VARCHAR(255) : BIGINT) .append( COMMENT ).append(field.getComment()).append(,); }); sql.append(PRIMARY KEY ().append(tableInfo.getKeyColumn()).append()) ENGINEInnoDB DEFAULT CHARSETutf8mb4;); return sql.toString(); }这段代码的逻辑是先通过TableInfoHelper拿到实体类对应的表名、主键、字段列表然后遍历字段拼出列定义。参数上field.getComment()取的是实体类字段上TableField注解里的value或者注释如果没有就为空。实际使用时类型映射需要更细致比如LocalDate映射DATELocalDateTime映射DATETIMEInteger映射INT。这个技巧适合快速搭原型正式环境还是建议用 Flyway 或 Liquibase 管理 DDL 版本。5.2 接口自测不启动前端也能验证核心逻辑很多人习惯启动整个前后端再点页面测试效率很低。我一般用MockMvc或者直接写SpringBootTest加TestRestTemplate来测接口。比如测员工新增接口SpringBootTest(webEnvironment SpringBootTest.WebEnvironment.RANDOM_PORT) class EmployeeApiTest { Autowired private TestRestTemplate restTemplate; Test void testAddEmployee() { Employee emp new Employee(); emp.setEmpNo(E1001); emp.setName(张三); emp.setDeptId(1L); emp.setStatus(1); ResponseEntityString response restTemplate.postForEntity(/api/employee, emp, String.class); assertEquals(200, response.getStatusCodeValue()); } }这段测试代码启动一个随机端口的完整 Spring 上下文直接发 HTTP 请求。参数说明webEnvironment RANDOM_PORT避免和本地 8080 冲突postForEntity的第二个参数是请求体对象第三个是返回类型。跑通这个测试说明 Controller、Service、Mapper、数据库整条链路都是通的比在页面上点一遍可靠得多。5.3 一个我坚持了很久的习惯每次拿到一套新源码我不会先看业务代码而是先跑通「登录 → 查列表 → 新增一条 → 再查列表」这条最小闭环。这条链路通了说明环境、数据库、权限、前后端联调都没大问题剩下的就是业务细节。这个习惯帮我省下了大量在环境问题上反复折腾的时间。人事系统这类项目技术难度不高但细节琐碎能把最小闭环先跑通的人后面改需求、加模块都会顺很多。希望帮到你。本文还有配套的精品资源点击获取