SpringBoot+MyBatis构建企业级HRM系统实践指南-育师

1. 项目背景与核心价值

人力资源管理系统（HRM）作为企业数字化转型的核心组件，正在从传统桌面软件向云端Web应用快速迁移。基于SpringBoot的Web版HR系统之所以成为计算机专业毕业设计的热门选题，关键在于它完美融合了三个维度的实践价值：

技术层面：完整覆盖SpringBoot+MyBatis+Thymeleaf的主流技术栈实战业务层面：实现组织架构、考勤、薪酬等HR核心业务模块的数字化建模架构层面：演示单体架构向微服务过渡的典型设计模式

我指导过37个同类毕业设计项目，发现学生最容易陷入"重功能实现轻业务逻辑"的误区。比如某届学生花了80%时间做花哨的前端界面，却用静态数组存储员工数据。本文将重点分享如何构建一个业务完备、技术规范、具有生产级潜力的HRM系统。

2. 技术选型与架构设计

2.1 技术栈组合方案

基础框架选型遵循"稳中求进"原则：

核心框架：SpringBoot 2.7.x（LTS版本）
数据持久化：MyBatis-Plus 3.5.x（避免重复CRUD）
模板引擎：Thymeleaf 3.1.x（天然支持HTML5）
安全控制：Spring Security 5.8.x（RBAC实现）
前端组件：Bootstrap 5 + AdminLTE 3（快速构建管理后台）

关键提示：坚决避免盲目追新，某学生使用SpringBoot 3.0导致与MyBatis插件不兼容，调试耗时两周

2.2 分层架构设计

采用经典三层架构但进行业务适配改造：

com.hrm ├── config # 安全/缓存等配置 ├── controller # 前后端交互层 ├── service # 业务逻辑层 │ ├── impl # 实现类 │ └── strategy # 策略模式包（如考勤计算策略） ├── dao # 数据访问层 ├── entity # 持久化对象 ├── dto # 数据传输对象 └── util # 工具类

特别注意：HR业务存在大量条件分支（如不同岗位的薪资计算），建议在service层使用策略模式避免if-else泛滥。某电商公司HR系统曾因层层嵌套的if语句导致维护困难。

3. 核心业务模块实现

3.1 组织架构管理

数据库设计需考虑树形结构存储：

CREATE TABLE `sys_dept` ( `dept_id` bigint NOT NULL AUTO_INCREMENT, `parent_id` bigint DEFAULT NULL COMMENT '父部门ID', `ancestors` varchar(255) DEFAULT '' COMMENT '祖级列表', `dept_name` varchar(30) NOT NULL COMMENT '部门名称', `order_num` int DEFAULT '0' COMMENT '显示顺序', `leader` varchar(20) DEFAULT NULL COMMENT '负责人', `phone` varchar(11) DEFAULT NULL COMMENT '联系电话', `status` char(1) DEFAULT '0' COMMENT '状态（0正常 1停用）', PRIMARY KEY (`dept_id`) ) ENGINE=InnoDB COMMENT='部门表';

关键实现技巧：

使用MP的@TableField(typeHandler = JacksonTypeHandler)处理ancestors字段的JSON转换
部门删除时需检查是否存在子部门（递归查询）
前端采用ztree插件实现可视化拖拽排序

3.2 智能化考勤模块

考勤业务复杂点在于异常情况处理：

// 考勤策略接口 public interface AttendanceStrategy { AttendanceResult calculate(AttendanceRecord record); } // 正常考勤策略 @Service public class NormalStrategy implements AttendanceStrategy { @Override public AttendanceResult calculate(AttendanceRecord record) { // 实现标准计算逻辑 } } // 弹性工作制策略 @Service public class FlexibleStrategy implements AttendanceStrategy { @Override public AttendanceResult calculate(AttendanceRecord record) { // 实现弹性时间计算 } }

血泪教训：某项目将考勤规则硬编码在Service中，后期新增"调休不计缺勤"规则时不得不重构整个模块

3.3 薪酬计算引擎

薪酬模块必须实现可配置化：

@Transactional public SalaryResult calculateSalary(Long userId) { // 1. 获取基础薪资 BigDecimal baseSalary = salaryMapper.selectBaseSalary(userId); // 2. 计算绩效奖金 BigDecimal performanceBonus = bonusService.calculate(userId); // 3. 社保公积金扣除 SocialSecurity security = socialSecurityService.getDetails(userId); // 4. 个税计算（使用策略模式） TaxStrategy strategy = TaxStrategyFactory.getStrategy( security.getPaymentCity()); BigDecimal tax = strategy.calculate(baseSalary.add(performanceBonus)); return new SalaryResult(baseSalary, performanceBonus, tax); }

特别注意：薪酬计算必须保证事务性，某生产系统曾因非事务操作导致薪资数据不一致引发劳资纠纷。

4. 典型问题排查实录

4.1 并发考勤签到时出现数据覆盖

现象：多人同时签到最后只记录一条数据根因：MyBatis-Plus的saveOrUpdate方法非原子操作解决方案：

public boolean signIn(Attendance attendance) { return transactionTemplate.execute(status -> { // 先查询再插入/更新 Attendance exist = lambdaQuery() .eq(Attendance::getUserId, attendance.getUserId()) .eq(Attendance::getDate, LocalDate.now()) .one(); if(exist != null) { exist.setSignInTime(attendance.getSignInTime()); return updateById(exist); } return save(attendance); }); }

4.2 部门导出Excel内存溢出

现象：导出5000+员工数据时OOM 优化方案：

使用EasyExcel替代POI
分页查询数据（每页1000条）
使用SXSSFWorkbook流式写入

// 设置1000行的内存缓存 SXSSFWorkbook workbook = new SXSSFWorkbook(1000); Sheet sheet = workbook.createSheet("部门数据"); // 使用模板方法填充数据 excelExportService.fillData(sheet, queryParams); // 及时清理临时文件 workbook.dispose();