如果有人让我推荐一个既能练手又能直接拿去用的 Java 后端项目我第一个想到的就是 Spring Boot 人力资源管理系统。这题目听起来发闷但真把组织架构、员工档案、考勤、薪资、权限这些模块全部捋清楚之后你会发现对 Spring Boot 的理解已经上了一个台阶。这套系统能做什么给 HR 一个在线管理入口新员工登记、老员工转正调岗、考勤数据流转到薪资核算、不同角色通过不同权限查看不同模块。适合谁来参考准备毕业设计的学生、想独立完成一个完整后端项目的中级开发者还有想把散落在 Excel 里的员工数据收拢成系统的中小企业内部技术人员。下面这套设计思路和实现过程是我实际做过、踩过坑之后整理出来的直接照着做能少走很多弯路。1. 项目定位与整体设计思路1.1 人力资源管理系统到底在管什么很多人一听到人力资源管理系统下意识以为就是把员工信息做成一张大表能增删改查就算完事。真动手做才发现HR 工作的核心其实是数据流转员工入职要把个人信息落到员工表里部门归属要同步到组织架构里每天考勤打卡的数据最终要汇总成薪资依据请假单审批通过之后又会反过来影响考勤统计。一个合格的 HR 系统本质上是把这些零散的业务动作串成一条完整的数据链路。传统小公司的问题是数据散。员工的身份证信息在 Excel 里工资核算在对私记录里考勤又在打卡机导出的文件里月底发工资全靠 HR 手工对表。一旦人数超过五十这套手工流程几乎必然出错。所以这个项目解决的核心痛点就一句话把分散的员工全生命周期数据收拢到一个平台用权限控制让不同角色只碰自己该碰的数据。从业务角度拆HR 系统大概可以分为六个板块组织架构部门和职位、员工档案入职、异动、离职、考勤管理打卡、请假、加班、薪资管理月度核算与工资条、招聘管理简历和面试、培训管理课程与记录。做项目的时候没必要贪多先把第一梯队的数据链路做完也就是档案、考勤、薪资、权限这四块招聘和培训可以作为扩展模块留到二期。1.2 技术选型为什么这个项目非 Spring Boot 不可选 Spring Boot 做这类业务系统不是因为追热点而是因为它和这种 CRUD 加业务流为主的管理系统配合度实在太高。Spring Boot 把 Spring 的自动装配能力发扬光大引入一个 starter 依赖框架自动帮你把内置 Tomcat、SpringMVC、数据源全部装配好开发者不用再写一堆 XML 配置。做完这个项目你自然会发现大部分时间其实花在业务逻辑和表结构设计上而不是和框架配置搏斗。版本选择上我要给一个明确的建议。如果你不是非要上 Java 17老老实实选 Spring Boot 2.7.x 加 JDK 8。这个组合被无数生产项目和培训机构验证过网上遇到的报错基本都能搜到答案。Spring Boot 3.x 固然新但要求 JDK 17并且从 3.0 开始把javax.*包全部换成了jakarta.*部分老代码直接复制过来会编译报错。如果你确实想用新版本做项目那就要接受生态兼容性带来的折腾成本。组合方案JDK 版本适用场景风险点Spring Boot 2.7.xJDK 8毕业设计、企业存量项目、稳妥首选生态成熟风险最低Spring Boot 3.2.xJDK 17新项目、想体验新特性老代码需改 javax 为 jakartaSpring Boot 3.x MyBatisJDK 17同时追求新框架与灵活 SQLMyBatis 也需用 3.5.x 以上版本持久层我推荐 MyBatis-Plus 而不是原生 MyBatis。理由很实在它自带BaseMapper单表 CRUD 不用写 XML分页查询有内置插件代码生成器还能根据表结构直接生成实体和 Mapper。人力资源管理系统里大量操作是单表查询加条件过滤MyBatis-Plus 可以把这部分开发量省掉一半。原生 MyBatis 适合对 SQL 有洁癖、喜欢手写复杂关联查询的团队但在确保项目进度这件事上,No,MyBatis-Plus 明显更能打。前端方案给两条路线。如果时间充足、想做前后端分离拿得出手建议 Vue3 加 Element Plus管理后台的风格成熟表格和表单组件开箱即用。如果时间紧或者后端基础还不够扎实用 Spring Boot 官方推荐的 Thymeleaf 做服务端渲染也能出完整页面少一套前端工程部署也简单。我的经验是毕设答辩时前后端分离的观感更好但工作量至少多出三分之一看你剩余时间再决定。1.3 功能模块怎么拆才合理模块拆分的核心原则是让每个模块对应一条清晰的数据流而不是把功能堆成一个大杂烩。参考我梳理过的参考模板实际的项目结构可以这样拆模块核心功能关键数据表系统管理用户登录、角色权限、操作日志sys_user、sys_role、sys_menu组织架构部门树、职位管理department、position员工管理员工档案、入职离职、导入导出employee考勤管理打卡记录、请假审批、考勤汇总attendance_detail、leave薪资管理薪资结构、月度核算、工资条salary_record、salary_item这里有个我实际踩过的坑最开始我照着商业 HR 软件的模块列表去设计把招聘、培训、绩效全部加进第一版结果光表结构就设计了两周最后论文写不完代码也没写明白。后来果断砍掉非核心部分只保留上面五张核心表加两张权限表两周内就把主体功能跑通了。做系统设计尤其是以交付为导向的项目完成比完美重要。招聘和培训完全可以设计成占位模块在论文里写清楚扩展方案即可。2. 核心设计数据库表、权限与自动装配2.1 数据库表设计里的关键取舍数据库设计是这类系统的地基。我建议直接用 MySQL 8.0字符集统一utf8mb4排序规则用utf8mb4_general_ci。核心表设计上有几个决策直接决定了后期开发体验。员工表是重中之重。常用字段就这些emp_no员工编号唯一索引、name、gender、birth_date、phone、email、department_id、position_id、entry_date、status在职/试用/离职、is_deleted。注意员工编号不要用自增主键去当业务编号因为离职重新入职、批量导入的场景下自增 ID 容易乱。我习惯单独设一个emp_no字段由程序生成比如EMP加入职日期加流水号这样既唯一又直观。部门和职位的关联有人用外键约束我在项目里用的是普通索引字段。外键能保证数据一致性但会让写入操作变慢而且删除部门时有可能会被外键拦住。实际用了department_id索引字段后应用层写逻辑去判断部门是否存在效果一样代码还更灵活。部门名称这种查询频繁的冗余字段我选择直接在员工表里冗余一份查询列表的时候少两次 join列表页渲染明显快。考勤和薪资的表结构要体现先明细后汇总的思路。打卡明细表存储每天的打卡时间和来源手动打卡、导入、门禁机同步薪资计算时再按月份把基础工资、绩效奖金、缺勤扣款汇总。特别注意salary_record表要建一个(employee_id, month)的唯一索引防止月底跑批脚本重复执行导致工资记录重复。我在做第一期的时候没加这个索引测试时误跑两次数据工资直接翻倍这个教训记忆太深刻了。2.2 登录认证与权限控制我选 Spring Security 加 JWT权限模型我直接采用经典的 RBAC基于角色的访问控制就是用户表、角色表、菜单/权限表三张核心表加两张关联表。一个用户可以有多个角色一个角色绑定一组权限。这种模型的好处是通用HR 想给培训专员开招聘权限只要改角色绑定关系就行代码不用动。认证方案纠结过一段时间。最开始的方案是 Session 加 Cookie传统且简单但放到前后端分离场景下会遇到跨域 Session 丢失的问题WebSocket 和移动端支持也不友好。后来我换成 Spring Security 配合 JWT登录成功后签发一个 token前端每次请求把 token 放在Authorization请求头里后端过滤器解析 token 得到用户身份。这套方案无状态扩展微服务的时候不用改认证逻辑面试聊起来也更有深度。关键实现有几个点。SecurityConfig里关闭 csrf放行登录、注册、Swagger 文档、静态资源这几个路径其余接口全部要求带有效 token。UserDetailsService从sys_user表里查用户配合BCryptPasswordEncoder做密码校验和加密存储这里注意密码字段永远不要明文存库。自定义一个JwtAuthenticationFilter在 Spring Security 过滤器链中加到UsernamePasswordAuthenticationFilter之前从 header 里取出 token校验通过就往SecurityContext里放一个Authentication对象。另外有个小坑必须提Spring Security 下要单独放行 OPTIONS 请求否则前端联调时跨域预检请求会直接 403。2.3 Spring Boot 自动装配是怎么让项目跑起来的做这个项目之前我其实没搞懂SpringBootApplication这个注解为什么跑起来后SpringMVC、Tomcat、MyBatis 就全都正常工作了。直到有一天我按住 Ctrl 点击去看源码才发现这个组合注解是由三个注解拼起来的SpringBootConfiguration标记配置类EnableAutoConfiguration开启自动装配ComponentScan负责扫描当前包下的组件。真正干活的是EnableAutoConfiguration。自动装配的原理可以理解为三步Spring Boot 启动时会去加载依赖包META-INF目录下的spring.factories文件在 Spring Boot 2.7 时代或者AutoConfiguration.imports文件Spring Boot 3 时代里面列了一长串自动配置类的名字。框架把这些类读出来逐一判断条件注解是否满足。举例来说ServletWebServerFactoryAutoConfiguration会先判断 classpath 里有没有Servlet类有的话再帮你启动内嵌 TomcatDataSourceAutoConfiguration判断你配置了数据源地址就自动帮你创建连接池。这套机制就是 Spring Boot少于配置背后的真相。项目骨架层面我的建议是按职责分层包名controller接口层、service业务层、mapper数据访问层、entity实体类、config配置类、common统一返回结果、全局异常。统一返回结果类ResultT是所有接口的固定包装包含code、message、data三个字段再用RestControllerAdvice写一个全局异常处理器业务校验不通过时返回明确的错误码。这套东西越早搭好后面写每个接口都能省心。3. 从零到一实操与核心功能实现3.1 初始化工程与项目骨架新建项目的路径比较顺一是 IDEA 自带 Spring Initializr可视化勾选依赖二是直接访问 start.spring.io 下载压缩包再导入 IDEA。我用的是 IDEA 开发选 Maven 作为构建工具注意 Java 版本要与后面 pom.xml 里配置一致JDK 8 就选 8JDK 17 就选 17。pom.xml 里核心依赖列出来是这样照着加就行dependencies dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-web/artifactId /dependency dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-security/artifactId /dependency dependency groupIdcom.baomidou/groupId artifactIdmybatis-plus-boot-starter/artifactId version3.5.5/version /dependency dependency groupIdmysql/groupId artifactIdmysql-connector-java/artifactId scoperuntime/scope /dependency dependency groupIdio.jsonwebtoken/groupId artifactIdjjwt/artifactId version0.9.1/version /dependency dependency groupIdorg.projectlombok/groupId artifactIdlombok/artifactId optionaltrue/optional /dependency /dependencies这里提醒一下如果你是 Spring Boot 3.xmysql-connector-java的 groupId 已经改成com.mysqlartifactId 是mysql-connector-j别盲目复制老代码。另外国内开发环境下 Maven 依赖下载慢是常态记得在settings.xml里配置阿里云公共镜像仓库线上项目是同样道理。application.yml是核心配置文件数据源、MyBatis-Plus 日志、JWT 密钥、端口都放这里。端口建议 8080配合后端接口前缀/apiserver: port: 8080 spring: datasource: url: jdbc:mysql://localhost:3306/hr_system?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/ShanghaiuseSSLfalse username: root password: your_password hikari: maximum-pool-size: 10 minimum-idle: 5 mybatis-plus: mapper-locations: classpath:mapper/*.xml configuration: log-impl: org.apache.ibatis.logging.stdout.StdOutImpl global-config: db-config: logic-delete-field: isDeleted logic-delete-value: 1 logic-not-delete-value: 0启动类很干净就一个SpringBootApplication注解加main方法。如果后面要整合 Redis 或消息队列也都是在启动类基础上加EnableCaching、EnableScheduling这类开关注解而不是写大段配置。3.2 员工管理模块的分页查询与 Excel 导入导出员工管理是 HR 系统里使用频率最高的模块也是我建议从小项目练起的真正核心。实体类Employee与表字段对应使用 Lombok 减少样板代码Data TableName(employee) public class Employee { TableId(type IdType.ASSIGN_ID) private Long id; private String empNo; private String name; private String gender; private Date birthDate; private String phone; private String email; private Long departmentId; private Long positionId; private Date entryDate; private Integer status; TableLogic private Integer isDeleted; }Mapper 接口只需要继承 MyBatis-Plus 的BaseMapperEmployee单表增删改查方法全都现成。核心业务集中在 Service 层也就是分页查询加条件搜索Override public PageEmployee pageQuery(EmployeeQueryDTO dto) { LambdaQueryWrapperEmployee wrapper new LambdaQueryWrapper(); wrapper.like(StringUtils.hasText(dto.getName()), Employee::getName, dto.getName()) .eq(dto.getDepartmentId() ! null, Employee::getDepartmentId, dto.getDepartmentId()) .eq(dto.getStatus() ! null, Employee::getStatus, dto.getStatus()) .orderByAsc(Employee::getEmpNo); return employeeMapper.selectPage(new Page(dto.getPageNum(), dto.getPageSize()), wrapper); }这段代码的 backbone 是LambdaQueryWrapperlike和eq的第一个参数是条件开关为 false 时自动忽略这个条件用同一套方法就能同时支撑空查询、单条件查询和多条件组合查询避免写一堆if。Excel 导入导出我强烈建议用 EasyExcel 而不是古老的 POI。EasyExcel 是阿里的开源工具对内存占用做了优化二十万行数据也不会 OOM。导入的思路是三步定义一个EmployeeImportDTO用ExcelProperty注解对应表头写一个AnalysisEventListener监听器每解析一行就插入一条在 Controller 里接收MultipartFile文件流交给 EasyExcel 的read方法。导出更简单查询出数据用EasyExcel.write(response.getOutputStream(), Employee.class).sheet(员工表).doWrite(list)就完事。这里有个细节坑Excel 里日期格式容易解析失败记得在日期字段的ExcelProperty注解上配format yyyy-MM-dd。3.3 考勤和薪资模块的数据处理流程考勤模块的核心设计是一张明细表加一张汇总统计维度。明细表attendance_detail存每天的打卡记录employee_id、work_date、first_clock_time、last_clock_time、考勤来源。技型系统常见的门禁机或钉钉打卡最后都会导出一个 Excel 文件所以在导入逻辑上我尽量做成通用接口先读取文件到临时表做数据校验员工编号是否存在、日期是否重复、时间是否合法校验通过再正式落库。这样做的好处是导入失败时不会污染主表回滚也干脆。薪资模块的月度核算是整个系统里最需要小心的地方。我设计的流程是月初触发薪资计算任务遍历当月在职员工从员工表带出基础工资从考勤汇总表带出缺勤天数再查询绩效评分计算出最终应发工资插入salary_record表。计算规则页面可以配置底薪、绩效比例、社保基数、扣款项但数据库设计上仍然保持一张salary_item表存放各项金额这样每个员工的工资构成都看得见而不是只有一个最终数字。防重复计算的措施很笨但有效在salary_record表加唯一索引uk_employee_month插入前先查一次如果已存在则返回本月已核算的提示。这个逻辑看似简单但实际踩坑频率极高尤其是脚本定时任务和手动触发叠加的时候一不留神就会产生脏数据。3.4 Docker 打包部署一条命令启动项目项目做完最终要交付运行部署方式我推荐 Docker 容器化。先保证本地打包没问题在项目根目录执行mvn clean package -DskipTeststarget 目录下会生成一个xx.jar。然后写一个精简的 DockerfileFROM openjdk:8-jre-alpine WORKDIR /app COPY target/hr-system.jar /app/hr-system.jar ENV TZAsia/Shanghai EXPOSE 8080 ENTRYPOINT [java, -jar, /app/hr-system.jar]构建镜像命令docker build -t hr-system:1.0 .启动命令docker run -d -p 8080:8080 --name hr hr-system:1.0。这里有几个容易疏忽的点第一是默认时区不对容器内时间是 UTC数据库连接串里已经指定了serverTimezoneAsia/Shanghai但应用本身时区也要通过TZ环境变量设置否则日志时间会差 8 小时第二是指定内存限制-Xmx512m这类 JVM 参数避免容器在低内存机器上被频繁杀掉第三是数据库连接不要直接写容器 IP生产环境建议用 docker-compose 把应用和 MySQL 放到同一个自定义网络里用服务名互相访问。如果你只是想在本地环境快速跑给别人看也可以直接java -jar hr-system.jar启动日志一目了然。Docker 更多是为了环境一致性换一台机器构建一次镜像五分钟就能把整个系统完整跑起来这点比什么都省心。4. 实战问题排查与避坑指南4.1 版本太高引发的连环坑JDK、javax 和 starterSpring Boot 版本太高这个坑几乎每个照着老教程做项目的都会遇到。最典型的就是 3.x 版本你用了 JDK 17 开启新项目却发现复制过来的代码里import javax.servlet.*全部报红因为 3.x 已经改成jakarta.servlet.*。更隐蔽的是 MyBatis-Plus、Druid、Shiro 这些第三方组件老版本是基于 Spring Boot 2 写的Boot 3 的自动装配机制变了可能出现Invalid value type for attribute factoryBeanObjectType这类奇怪的报错。我建议的排查思路是先确认项目实际使用的版本组合再决定代码从哪抄。最省事的做法是这个组合表技术栈稳定搭配注意项Spring Boot 2.7MyBatis-Plus 3.4、JDK 8网上教程最多样例最好找Spring Boot 3.2MyBatis-Plus 3.5.5、JDK 17老代码注意 javax/jakarta 变更Docker 部署openjdk:17-jre镜像与本地 JDK 版本要一致依赖冲突问题可以用 Maven 命令诊断mvn dependency:tree看是哪个包拉入了旧版本然后在 pom 里用exclusions剔除。多试几次就熟练了。4.2 数据库连接、中文乱码和时区问题数据库连接串就是那些参数反复出问题。少了characterEncodingutf8会导致中文写入乱码少了serverTimezoneAsia/ShanghaiJDBC 会拿系统默认时区去解析时间数据和时间差 8 小时useSSLfalse可以避免一些老版本 MySQL 驱动的 SSL 握手警告。建表时也注意统一ENGINEInnoDB DEFAULT CHARSETutf8mb4utf8 和 utf8mb4 在存储 emoji 表情时差别很大员工姓名地址里有特殊字符时utf8 直接存不进去。连接池 HikariCP 是 Spring Boot 默认的一般不用换。如果遇到数据库连接被占用、应用启动报Connection is not available先看是不是连接池空调整maximum-pool-size和connectionTimeout。一个常见误操作是测试代码里用完Connection没关连接池被耗尽接口全部卡死。这个问题排查半天最后发现就是少了个 try-with-resources好气又好笑。4.3 把 Jar 包反编译当源码学习值不值有不少人好奇怎么把 Spring Boot 的 jar 包还原成项目。实际上jar 包反编译做不到还原成完整的 Maven 项目结构但确实可以把里面的 class 文件反编译出来看代码逻辑。常用工具就三个IDEA 自带的反编译打开 jar 包里的 class 文件即可、JD-GUI图形化工具傻瓜操作、CFR命令行反编译处理泛型和枚举效果好。反编译真正有用的场景是学习框架源码比如你想搞明白MyBatisPlusAutoConfiguration是怎么创建那个SqlSessionFactory的直接在 IDE 里打开mybatis-plus-boot-starter的 jar 源码比自己瞎猜快得多。另外排查第三方依赖问题时反编译也可以确认某个类到底被哪个 jar 引入。这里必须提醒一句反编译产物仅供学习和定位问题绝对不能拿来作为自己项目的基础代码更不能用于商业发布这是基本的版权底线。4.4 前后端联调时的跨域和 Token 问题前后端分离联调时碰到最多的报错是Access to XMLHttpRequest ... blocked by CORS policy。原因是浏览器安全策略前端页面在 5173 端口后端接口在 8080 端口两者不同源预检请求就被拦下了。解决方式很标准在后端写一个WebMvcConfigurer配置类重写addCorsMappings方法允许的allowedOriginPatterns设置为你的前端地址或用*但在 Spring Security 下要注意配合。更隐蔽的问题是 Spring Security 对 OPTIONS 请求的不友善。浏览器发送跨域请求前会先发一个 OPTIONS 预检这个请求如果没有经过你的过滤器链被放行直接返回 403前端就傻眼了。处理方式是在SecurityFilterChain里对requestMatchers(HttpMethod.OPTIONS, /**)执行permitAll()。Token 的携带方式也要统一前端 axios 拦截器里从 localStorage 取出 token放入Authorization: Bearer token头后端解析时注意去掉Bearer前缀。如果发现有请求能到 Controller但SecurityContext里拿不到用户信息多半就是过滤器里 token 解析失败后没有显式放行或者抛了异常仔细看日志就好。5. 项目扩展方向与求职面试准备5.1 还能往这个项目里加什么主体功能做完之后如果你想把它从能跑升级到像一个合格的工程化项目有很多方向可以扩展。第一个是缓存优化员工列表被高频查询可以把热点部门下的员工数据缓存到 Redis设置过期时间五分钟后自动刷新接口响应时间能从几十毫秒降到个位数毫秒。Redis 还能顺便做登录验证码存储和 JWT token 黑名单这就把 Spring Boot 整合 Redis 这个技能点练了。第二个是文件存储员工头像、合同扫描件、Excel 导入模板这些文件不能直接丢到应用本地磁盘云资源又需要跨云服务商可以用 MinIO 搭一套私有对象存储通过 Spring Boot 的MinioClient上传下载同时解决文件预览和权限隔离的问题。第三个是搜索增强员工超过几万人之后用LIKE %关键字%做搜索性能会很差可以集成 Elasticsearch 做员工索引姓名、职位、部门三个字段建立全文索引搜索体验完全不同。还有个小趣味点Spring Boot 启动时那个默认 Banner 可以用在线 banner 生成器生成公司或项目名字的 ASCII 艺术字放到src/main/resources/banner.txt每次启动都很有仪式感面试演示项目时也能一下抓住眼球。消息通知权限审批这些可以后续再加 ActiveMQ 或 RabbitMQ甚至远程调用接口对接企业微信和钉钉把这些中间件挨个整合过简历上就写得满满当当了。5.2 面试官问到一个 HR 系统项目时怎么讲如果你做这个项目是冲着求职去的面试时不能只讲我写了增删改查。一个经典的面试表达框架是背景 - 方案 - 难点 - 结果。先说背景HR 手工管理员工数据效率低、易出错需要一个统一平台。再说方案Spring Boot 做后端Vue 做前端MySQL 存储JWT 做认证权限基于 RBAC。然后重点说难点薪资批量核算时怎么防重复、考勤数据导入怎么保证一致、Spring Security 过滤器的 token 解析为什么放在特定位置。最后说结果上线后 HR 录入效率提升、人工核算错误消除了。高频追问往往集中在几个点自动装配原理、JWT 认证的完整链路、MyBatis-Plus 分页的实现原理、事务失效的场景、Transactional自调用为什么失效。这些内容其实在开发过程中都会遇到只要是你亲手写的把这些点讲清楚比背八股文有用得多。千万不要在简历上只写完成员工管理模块要写成设计员工全生命周期数据模型实现基于 MyBatis-Plus 的通用查询与 EasyExcel 批量导入导出细节越具体越经得起追问。我个人的体会是一次完整的人力资源管理系统开发几乎把 Spring Boot 后端开发的主干技术练了个遍工程搭建、分层架构、数据库建模、认证授权、文件处理、缓存优化、容器部署。期间踩过的每一个坑回头看都是最值钱的经验。如果你正卡在某个阶段我的建议很直白先别急着扩展新功能把员工管理到薪资核算这五张表的数据链路完整跑通再把部署交付做完你对这个项目的掌控力就完全不一样了。做完这个后面再碰什么业务系统其实都是同一套思路换个皮罢了。