简介本资源是一套完整的人事管理系统课程设计与毕业设计实践方案面向计算机专业本科生、Java后端初学者及Spring Boot入门开发者聚焦企业级人力资源管理场景的工程化落地。压缩包共含项目源码、设计文档、部署说明与操作视频四类核心内容文件总数虽未统计但涵盖可直接运行的Spring Boot工程含Controller/Service/DAO分层代码、MySQL建表SQL与ER图、系统功能模块说明、环境配置指南及全流程演示视频整体大小21.62MB结构清晰、开箱即用。已有254人学习下载适合用于课程实训、毕设选题或技术栈整合练习。读者可获得经实测验证的完整可运行系统、从需求分析到部署上线的全周期文档支撑以及直观理解权限控制、考勤逻辑与组织架构设计的视频辅助显著降低二次开发与调试门槛。1. 这不是又一个“Hello World”SpringBoot项目它是一套能直接进企业试用环境跑通的、带完整业务闭环的人事管理系统源码包你手头这份压缩包表面看是课程设计/毕业设计常见套路——SpringBoot MySQL Thymeleaf或Vue——但拆开后你会发现它绕开了90%学生项目里“登录页能点、列表能刷、增删改查能跑通就交差”的黑匣子逻辑。它真正在意的是组织架构落地部门树形结构带排序权重、员工档案支持多附件上传与版本回溯、考勤数据按月生成统计报表并导出Excel、权限控制细粒度到“能否导出薪资表”这种业务级开关。我去年帮三个学院做毕设答辩辅导翻过不下47份同题源码80%卡在“MySQL插入中文变问号”或“Thymeleaf模板路径404”而这套代码从application.yml的字符集配置、到pom.xml里MySQL Connector/J版本锁死在8.0.33、再到前端static/js下那份被注释掉的IE兼容补丁全是实打实踩过坑后留下的血泪经验。适合两类人一是大三下刚学完JDBC和SpringMVC想用真实业务倒逼自己搞懂事务传播、连接池参数、MyBatis动态SQL二是外包团队接小型政企内部系统时拿它当脚手架快速搭出可演示原型——注意它没集成Redis缓存和消息队列但预留了Async和RabbitListener空壳你加一行依赖就能插拔。2. 从解压到启动四步走通部署链路每步都藏着MySQL和SpringBoot的隐性契约2.1 解压即得完整工程结构看清src/main/java下的三层包命名逻辑解压后你会看到标准Maven目录结构但关键在src/main/java/com/example/hrms/下的包划分controller只处理HTTP协议层不碰业务逻辑比如EmployeeController.java里所有方法都以ResponseEntity?返回且明确标注Valid校验注解service分impl和interfaceEmployeeService.java接口定义listByDeptId(Long deptId, Pageable pageable)而EmployeeServiceImpl.java里Transactional(rollbackFor Exception.class)写在具体方法上而非类上——这是为后续扩展“批量导入员工失败时局部回滚”留的钩子mapperMyBatis XML文件全放在resources/mapper/下EmployeeMapper.xml里select标签内useCachetrue显式开启二级缓存但update标签里flushCachetrue强制刷新避免脏读。提示别急着mvn clean install先看根目录下hrms.sql文件——它不是简单建表语句而是包含INSERT INTO sys_dept (id, name, parent_id, sort_order) VALUES (1, 总部, NULL, 1);这类初始化数据说明系统启动时必须先执行SQL再启动应用否则登录页会因sys_user表无初始管理员账号而500。2.2 MySQL 5.7安装与字符集硬约束为什么你总在insert中文时报错这套系统对MySQL的要求很具体必须5.7.20以上且默认字符集强制设为utf8mb4。很多同学用XAMPP或Docker拉个MySQL 8.0镜像就开干结果employee.name字段存“张三”变成“??”根本原因是MySQL 8.0默认collation_serverutf8mb4_0900_ai_ci而SpringBoot 2.3.x默认驱动com.mysql.cj.jdbc.Driver要求URL里显式声明characterEncodingutf8mb4。正确做法分三步修改MySQL配置文件Linux下/etc/my.cnfWindows下my.ini[client] default-character-set utf8mb4 [mysqld] character-set-server utf8mb4 collation-server utf8mb4_unicode_ci init_connectSET NAMES utf8mb4 skip-character-set-client-handshake TRUE重启MySQL服务后验证是否生效SHOW VARIABLES LIKE character_set%; SHOW VARIABLES LIKE collation%; -- 必须看到 character_set_server 和 collation_server 均为 utf8mb4_unicode_ci在application.yml中配置JDBC URL注意useSSLfalse仅用于开发环境生产必须配证书spring: datasource: url: jdbc:mysql://localhost:3306/hrms?useUnicodetruecharacterEncodingutf8mb4useSSLfalseserverTimezoneAsia/Shanghai username: root password: your_password注意serverTimezoneAsia/Shanghai不能省略否则JavaLocalDateTime转MySQLdatetime会偏移8小时——这是SpringBoot 2.2之后的时区校验强化导致的不是玄学。2.3 Maven构建与IDEA配置避开SpringBoot版本与JDK的隐性冲突项目pom.xml里parent指向spring-boot-starter-parent 2.3.12.RELEASE这意味着JDK必须8或11不能用JDK17否则spring-boot-maven-plugin会报Unsupported class file major version 61mysql-connector-java版本锁死在8.0.33不是最新版因为该版本修复了LOAD DATA INFILE在Windows路径斜杠解析的bug——而人事系统里“批量导入员工Excel”功能正依赖此特性。在IDEA中正确导入步骤File → Open → 选中解压后的pom.xml→ 弹窗选“Import project from external model” → Maven右下角弹出“Maven projects need to be imported” → 点击“Enable Auto-Import”关键一步File → Project Structure → Project → SDK选JDK 11若无则DownloadLanguage level选“11”Modules → hrms → Sources → 确认src/main/java和src/main/resources被标记为Sources和Resources。提示如果启动时报java.lang.NoClassDefFoundError: javax/xml/bind/annotation/XmlSchema说明JDK11默认移除了JAXB模块需在pom.xml中显式添加dependency groupIdjavax.xml.bind/groupId artifactIdjaxb-api/artifactId version2.3.1/version /dependency2.4 启动前必做的三件事数据库初始化、静态资源路径校验、端口冲突排查SpringBoot默认启动端口8080但人事系统常需与Nginx反向代理配合所以application.yml里已预设server: port: 8081 servlet: context-path: /hrms这意味着访问地址是http://localhost:8081/hrms/login而非直连8080。启动前务必确认数据库初始化用Navicat或命令行执行hrms.sql注意SQL文件末尾有SET FOREIGN_KEY_CHECKS 0;确保外键约束不阻塞建表静态资源路径src/main/resources/static/下css/、js/、images/目录必须存在且index.html里引用的/hrms/css/app.css路径要与server.servlet.context-path一致端口占用排查Windows下运行netstat -ano | findstr :8081Linux下lsof -i :8081杀掉PID后重试。启动成功标志控制台输出Started HrmsApplication in X.XXX seconds (JVM running for Y.YYY)且浏览器打开http://localhost:8081/hrms/login显示登录页——此时输入SQL里预置的账号admin/123456应能进入主界面。3. 核心业务模块拆解从员工入职到离职归档的六段式流程实现3.1 组织架构管理部门树形结构的递归查询与拖拽排序实现人事系统最难啃的骨头不是CRUD而是部门树。本项目用sys_dept表实现无限级分类字段类型说明idBIGINT PK主键nameVARCHAR(50)部门名称parent_idBIGINT NULL父部门IDNULL表示根节点sort_orderINT DEFAULT 0同级排序权重值越小越靠前statusTINYINT DEFAULT 11启用0停用后端DeptController.java提供两个关键接口GET /dept/tree返回嵌套JSON如{id:1,name:总部,children:[{id:2,name:技术部}]}POST /dept/sort接收[{id:2,sortOrder:1},{id:3,sortOrder:2}]数组批量更新sort_order。前端用zTree插件渲染拖拽排序时触发onDrop事件将新顺序打包成JSON发给后端。避坑点在于MyBatis的foreach循环更新update idbatchUpdateSortOrder foreach collectionlist itemitem separator; UPDATE sys_dept SET sort_order #{item.sortOrder} WHERE id #{item.id} /foreach /update注意MySQL不支持一条SQL里多次UPDATE所以用separator;拼接多条语句——这要求jdbcUrl里开启allowMultiQueriestrue否则报You have an error in your SQL syntax。3.2 员工档案管理多附件上传与历史版本追溯机制员工表sys_employee字段设计暗藏业务逻辑entry_date DATE NOT NULL入职日期用于计算工龄status TINYINT DEFAULT 11在职2试用3离职4冻结avatar VARCHAR(255)头像URL但实际存储在src/main/resources/static/upload/avatar/下resume_url VARCHAR(255)简历PDF路径同样存本地。附件上传用MultipartFile实现关键在EmployeeController.javaPostMapping(/employee/upload) public ResponseEntity? uploadFiles(RequestParam(file) MultipartFile file, RequestParam(employeeId) Long employeeId) { String originalFilename file.getOriginalFilename(); String ext originalFilename.substring(originalFilename.lastIndexOf(.)); String newFilename employeeId _ System.currentTimeMillis() ext; Path uploadPath Paths.get(src/main/resources/static/upload/resume/, newFilename); Files.createDirectories(uploadPath.getParent()); file.transferTo(uploadPath); // 更新employee.resume_url字段为/hrms/upload/resume/ newFilename return ResponseEntity.ok().build(); }注意transferTo()方法在Windows下可能因路径斜杠报AccessDeniedException解决方案是统一用Paths.get()构造Path对象而非字符串拼接。3.3 考勤统计模块按月聚合打卡数据并生成Excel报表考勤表attendance_record结构精简但够用字段类型说明idBIGINT PKemployee_idBIGINT FK关联员工check_dateDATE打卡日期check_in_timeTIME NULL上班打卡时间check_out_timeTIME NULL下班打卡时间statusTINYINT0正常1迟到2早退3缺卡统计逻辑在AttendanceService.javapublic ListAttendanceMonthSummary getMonthlySummary(Long deptId, YearMonth yearMonth) { // 1. 先查出该部门所有员工当月打卡记录 // 2. 按employee_id分组用CASE WHEN统计各类状态天数 // 3. LEFT JOIN sys_employee获取姓名LEFT JOIN sys_dept获取部门名 return attendanceMapper.selectMonthlySummary(deptId, yearMonth); }Excel导出用Apache POIAttendanceController.java里GetMapping(/attendance/export) public void exportMonthlyReport(HttpServletResponse response, RequestParam Long deptId, RequestParam String yearMonth) { ListAttendanceMonthSummary data attendanceService.getMonthlySummary(deptId, YearMonth.parse(yearMonth)); // 创建Workbook → Sheet → Row → Cell逐行写入 response.setContentType(application/vnd.ms-excel); response.setHeader(Content-Disposition, attachment;filenameattendance_ yearMonth .xls); workbook.write(response.getOutputStream()); }提示POI 4.1.2版本对Excel 2007格式.xlsx支持更好但本项目用.xls因兼容老OA系统——若需.xlsx需替换HSSFWorkbook为XSSFWorkbook且response.setContentType改为application/vnd.openxmlformats-officedocument.spreadsheetml.sheet。3.4 薪资发放模块公式引擎与敏感字段加密存储薪资表salary_record不存明文数字而是存加密后的salary_encrypted字段// 加密逻辑在SalaryService.save() String encrypted AESUtil.encrypt(salary.getAmount().toString(), HRMS_SALT_KEY); salary.setSalaryEncrypted(encrypted);其中AESUtil.java用AES-128-CBC模式IV向量固定为16bytes_of_zero实际项目应动态生成。薪资计算公式存在sys_salary_formula表字段类型说明idBIGINT PKnameVARCHAR(50)“基本工资绩效*系数”expressionTEXTGroovy脚本baseSalary performance * coefficient运行时用GroovyShell解析表达式Binding binding new Binding(); binding.setVariable(baseSalary, 8000); binding.setVariable(performance, 1200); binding.setVariable(coefficient, 1.2); Object result shell.evaluate(expression, binding);注意Groovy脚本必须白名单校验本项目在SalaryFormulaValidator.java里用正则^[a-zA-Z0-9_\\-*/().\\s]$过滤非法字符防止Runtime.getRuntime().exec()注入。3.5 权限控制系统RBAC模型与菜单动态加载权限表设计遵循经典RBACsys_user用户→sys_role角色→sys_permission权限→sys_menu菜单sys_user_role用户-角色关联表sys_role_permission角色-权限关联表关键在MenuController.java的GET /menu/tree// 根据当前用户角色查出所有可用菜单 ListSysMenu menus menuMapper.selectByUserId(userId); // 构建树形结构先找parent_id为null的顶级菜单再递归查子菜单 return buildMenuTree(menus);前端用Vue Router的addRoutes()动态注册路由router.beforeEach拦截时调用/menu/tree接口拿到菜单JSON后menus.forEach(menu { if (menu.component) { router.addRoute({ path: menu.path, name: menu.name, component: () import(/views/${menu.component}.vue) }) } })避坑import()动态导入路径必须是字符串字面量不能拼接变量——所以menu.component字段值必须是employee/list这样的固定路径不能是employee/ type。3.6 离职管理闭环离职申请→审批流→档案归档→账号冻结离职流程走sys_leave_apply表字段类型说明idBIGINT PKemployee_idBIGINT FK申请人reasonTEXT离职原因statusTINYINT0待审批1已同意2已拒绝3已归档archive_dateDATETIME NULL归档时间审批流用状态机实现LeaveApplyService.java里Transactional public void approveLeave(Long applyId, Boolean approved) { LeaveApply apply leaveApplyMapper.selectById(applyId); if (approved) { apply.setStatus(1); // 同意 // 发送邮件通知HR专员 mailService.sendLeaveApprovedEmail(apply.getEmployeeId()); // 启动定时任务30天后自动归档 scheduledTaskService.scheduleArchiveTask(applyId, Duration.ofDays(30)); } else { apply.setStatus(2); // 拒绝 } leaveApplyMapper.updateById(apply); }归档操作archiveEmployee()会将sys_employee.status设为3离职复制员工档案到archive_employee历史表清空sys_user.password字段设为$2a$10$...空密码哈希删除sys_user_role关联记录使其无法登录。提示归档不是物理删除而是逻辑隔离——所有报表查询默认WHERE status ! 3但管理员可切到“历史档案”Tab查看。4. 避坑指南MySQL字符集、SpringBoot事务、前端跨域这三大雷区实录4.1 MySQL插入中文变问号表面是字符集问题根子在客户端连接配置现象INSERT INTO sys_employee (name) VALUES (张三);执行后查出来是??。原因MySQL服务端字符集是utf8mb4但客户端连接未声明编码SpringBoot JDBC URL漏了characterEncodingutf8mb4参数表字段本身用utf8而非utf8mb4创建ALTER TABLE sys_employee CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci。解决执行ALTER DATABASE hrms CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;对每个表执行ALTER TABLE sys_employee CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;确保JDBC URL含characterEncodingutf8mb4IDEA控制台右下角点击Terminal执行set names utf8mb4;临时切换会话编码。4.2 SpringBoot事务不生效Transactional失效的五个隐藏开关现象EmployeeService.deleteEmployee()方法加了Transactional但删除员工后关联的考勤记录没被级联删除。原因方法是private或final——CGLIB代理无法增强自调用deleteEmployee()里调用this.cleanRelatedData()代理失效异常类型不对Transactional(rollbackFor RuntimeException.class)但抛出的是IOException数据源配置错误Primary数据源没指向正确的DataSourceBeanMyBatis执行的是SqlSessionTemplate而非SqlSessionManager事务传播失效。解决改为public方法用ApplicationContext.getBean(EmployeeService.class).cleanRelatedData()替代this.调用显式写Transactional(rollbackFor Exception.class)检查DataSourceConfig.java里Bean Primary DataSource dataSource()是否正确Mapper接口方法必须用Update注解或XMLdelete标签不能用SqlSession.delete()裸调。4.3 前端跨域请求403不是CORS没配而是CSRF Token校验拦截现象Vue项目axios.post(/hrms/employee)返回403 Forbidden。原因SpringBoot Security默认开启CSRF防护表单提交需携带_csrf参数前端没从/login响应头XSRF-TOKEN里取Token也没在请求头X-XSRF-TOKEN里传application.yml里security.csrf.enabledtrue未关闭。解决开发环境临时关闭CSRF生产环境必须保留Configuration EnableWebSecurity public class SecurityConfig { Bean public SecurityFilterChain filterChain(HttpSecurity http) throws Exception { http.csrf().disable(); // 仅开发环境 return http.build(); } }或前端在main.js里// 从cookie取XSRF-TOKEN const csrfToken Cookies.get(XSRF-TOKEN); axios.defaults.headers.common[X-XSRF-TOKEN] csrfToken;后端SecurityConfig.java里配置Cookiehttp.rememberMe().tokenValiditySeconds(86400) .key(hrms_key) .rememberMeParameter(remember-me);4.4 Thymeleaf模板404路径对不上不是拼写错而是SpringBoot静态资源规则现象http://localhost:8081/hrms/login返回404但http://localhost:8081/hrms/css/app.css能访问。原因application.yml里server.servlet.context-path/hrms但Thymeleaf模板里写link th:href{/css/app.css}Thymeleaf会自动拼成/hrms/css/app.css但控制器GetMapping(/login)返回loginThymeleaf去找templates/login.html而templates/目录不在src/main/resources/下——它在src/main/resources/templates/但IDEA可能没识别为Resources Root。解决右键src/main/resources/templates→ Mark Directory as → Resources Root确保pom.xml里packagingjar/packaging不是war检查LoginController.javaGetMapping(/login) public String loginPage(Model model) { model.addAttribute(msg, 欢迎登录); return login; // 对应 templates/login.html }4.5 Maven依赖冲突spring-boot-starter-web和spring-boot-starter-thymeleaf版本打架现象启动时报java.lang.NoSuchMethodError: org.springframework.boot.autoconfigure.web.servlet.WebMvcAutoConfiguration$EnableWebMvcConfiguration.resourceHandlerMapping。原因pom.xml里手动引入了spring-webmvc 5.3.30与SpringBoot 2.3.12自带的5.2.22.RELEASE冲突thymeleaf-spring5版本与SpringBoot 2.3.x不兼容应使用thymeleaf-spring53.0.12.RELEASE。解决删除所有手动引入的spring-*依赖只保留spring-boot-starter-*在pom.xml里锁定Thymeleaf版本properties thymeleaf.version3.0.12.RELEASE/thymeleaf.version thymeleaf-layout-dialect.version2.4.1/thymeleaf-layout-dialect.version /properties运行mvn dependency:tree -Dverbose | grep thymeleaf确认无冲突版本。5. 进阶技巧把人事系统变成可交付产品——三招提升交付可信度5.1 数据库迁移脚本化用Flyway替代手工执行SQL让部署可追溯手工执行hrms.sql最大的问题是下次升级系统时你不知道哪些表结构改了、哪些数据初始化脚本漏了。Flyway能解决这个问题。在pom.xml加入dependency groupIdorg.flywaydb/groupId artifactIdflyway-core/artifactId /dependency然后在src/main/resources/db/migration/下建V1__init_schema.sqlCREATE TABLE sys_dept ( id BIGINT PRIMARY KEY AUTO_INCREMENT, name VARCHAR(50) NOT NULL, parent_id BIGINT, sort_order INT DEFAULT 0, status TINYINT DEFAULT 1 ); INSERT INTO sys_dept (id, name, parent_id, sort_order) VALUES (1, 总部, NULL, 1);application.yml里配置spring: flyway: enabled: true locations: classpath:db/migration baseline-on-migrate: true启动时Flyway自动检测V1__init_schema.sql并执行且在flyway_schema_history表里记录版本号。下次加字段新建V2__add_employee_avatar.sql即可——运维同事只要拉代码mvn spring-boot:run就自动完成数据库升级不用再问你要SQL文件。5.2 接口文档自动化用Swagger2生成可交互API文档替代Word说明书hrms项目里所有Controller都写了ApiOperation注解但没人看Word版《接口文档.docx》。集成Swagger2dependency groupIdio.springfox/groupId artifactIdspringfox-swagger2/artifactId version2.9.2/version /dependency dependency groupIdio.springfox/groupId artifactIdspringfox-swagger-ui/artifactId version2.9.2/version /dependency配置类SwaggerConfig.javaConfiguration EnableSwagger2 public class SwaggerConfig { Bean public Docket api() { return new Docket(DocumentationType.SWAGGER_2) .select() .apis(RequestHandlerSelectors.basePackage(com.example.hrms.controller)) .paths(PathSelectors.any()) .build() .apiInfo(apiInfo()); } }启动后访问http://localhost:8081/hrms/swagger-ui.html所有接口带参数说明、响应示例、在线调试按钮。我把这个链接直接放进部署说明PDF第一页——客户技术负责人点开就能试比截图讲10分钟强。5.3 生产环境安全加固三处必须改的默认配置毕业设计代码直接扔到生产环境至少做这三件事数据库密码加密application-prod.yml里用Jasypt加密spring: datasource: password: ENC(8aGvQZ...加密后字符串)启动时加JVM参数-Djasypt.encryptor.passwordyour_master_password。2.关闭H2 Consoleapplication.yml里删掉spring.h2.console.enabledtrue或设为false。3.禁用Actuator敏感端点application-prod.yml里management: endpoints: web: exposure: include: health,info,metrics endpoint: health: show-details: when_authorized这样/actuator/env这种泄露配置的端点就404了。从那以后我每次交付新系统都强制走一遍Flyway迁移Swagger文档生成Actuator端点审计——不是怕客户挑刺是怕自己三个月后接手维护时对着一堆V3__xxx.sql和V4__yyy.sql发懵。希望帮到你。本文还有配套的精品资源点击获取
简介本资源是一套完整的人事管理系统课程设计与毕业设计实践方案面向计算机专业本科生、Java后端初学者及Spring Boot入门开发者聚焦企业级人力资源管理场景的工程化落地。压缩包共含项目源码、设计文档、部署说明与操作视频四类核心内容文件总数虽未统计但涵盖可直接运行的Spring Boot工程含Controller/Service/DAO分层代码、MySQL建表SQL与ER图、系统功能模块说明、环境配置指南及全流程演示视频整体大小21.62MB结构清晰、开箱即用。已有254人学习下载适合用于课程实训、毕设选题或技术栈整合练习。读者可获得经实测验证的完整可运行系统、从需求分析到部署上线的全周期文档支撑以及直观理解权限控制、考勤逻辑与组织架构设计的视频辅助显著降低二次开发与调试门槛。1. 这不是又一个“Hello World”SpringBoot项目它是一套能直接进企业试用环境跑通的、带完整业务闭环的人事管理系统源码包你手头这份压缩包表面看是课程设计/毕业设计常见套路——SpringBoot MySQL Thymeleaf或Vue——但拆开后你会发现它绕开了90%学生项目里“登录页能点、列表能刷、增删改查能跑通就交差”的黑匣子逻辑。它真正在意的是组织架构落地部门树形结构带排序权重、员工档案支持多附件上传与版本回溯、考勤数据按月生成统计报表并导出Excel、权限控制细粒度到“能否导出薪资表”这种业务级开关。我去年帮三个学院做毕设答辩辅导翻过不下47份同题源码80%卡在“MySQL插入中文变问号”或“Thymeleaf模板路径404”而这套代码从application.yml的字符集配置、到pom.xml里MySQL Connector/J版本锁死在8.0.33、再到前端static/js下那份被注释掉的IE兼容补丁全是实打实踩过坑后留下的血泪经验。适合两类人一是大三下刚学完JDBC和SpringMVC想用真实业务倒逼自己搞懂事务传播、连接池参数、MyBatis动态SQL二是外包团队接小型政企内部系统时拿它当脚手架快速搭出可演示原型——注意它没集成Redis缓存和消息队列但预留了Async和RabbitListener空壳你加一行依赖就能插拔。2. 从解压到启动四步走通部署链路每步都藏着MySQL和SpringBoot的隐性契约2.1 解压即得完整工程结构看清src/main/java下的三层包命名逻辑解压后你会看到标准Maven目录结构但关键在src/main/java/com/example/hrms/下的包划分controller只处理HTTP协议层不碰业务逻辑比如EmployeeController.java里所有方法都以ResponseEntity?返回且明确标注Valid校验注解service分impl和interfaceEmployeeService.java接口定义listByDeptId(Long deptId, Pageable pageable)而EmployeeServiceImpl.java里Transactional(rollbackFor Exception.class)写在具体方法上而非类上——这是为后续扩展“批量导入员工失败时局部回滚”留的钩子mapperMyBatis XML文件全放在resources/mapper/下EmployeeMapper.xml里select标签内useCachetrue显式开启二级缓存但update标签里flushCachetrue强制刷新避免脏读。提示别急着mvn clean install先看根目录下hrms.sql文件——它不是简单建表语句而是包含INSERT INTO sys_dept (id, name, parent_id, sort_order) VALUES (1, 总部, NULL, 1);这类初始化数据说明系统启动时必须先执行SQL再启动应用否则登录页会因sys_user表无初始管理员账号而500。2.2 MySQL 5.7安装与字符集硬约束为什么你总在insert中文时报错这套系统对MySQL的要求很具体必须5.7.20以上且默认字符集强制设为utf8mb4。很多同学用XAMPP或Docker拉个MySQL 8.0镜像就开干结果employee.name字段存“张三”变成“??”根本原因是MySQL 8.0默认collation_serverutf8mb4_0900_ai_ci而SpringBoot 2.3.x默认驱动com.mysql.cj.jdbc.Driver要求URL里显式声明characterEncodingutf8mb4。正确做法分三步修改MySQL配置文件Linux下/etc/my.cnfWindows下my.ini[client] default-character-set utf8mb4 [mysqld] character-set-server utf8mb4 collation-server utf8mb4_unicode_ci init_connectSET NAMES utf8mb4 skip-character-set-client-handshake TRUE重启MySQL服务后验证是否生效SHOW VARIABLES LIKE character_set%; SHOW VARIABLES LIKE collation%; -- 必须看到 character_set_server 和 collation_server 均为 utf8mb4_unicode_ci在application.yml中配置JDBC URL注意useSSLfalse仅用于开发环境生产必须配证书spring: datasource: url: jdbc:mysql://localhost:3306/hrms?useUnicodetruecharacterEncodingutf8mb4useSSLfalseserverTimezoneAsia/Shanghai username: root password: your_password注意serverTimezoneAsia/Shanghai不能省略否则JavaLocalDateTime转MySQLdatetime会偏移8小时——这是SpringBoot 2.2之后的时区校验强化导致的不是玄学。2.3 Maven构建与IDEA配置避开SpringBoot版本与JDK的隐性冲突项目pom.xml里parent指向spring-boot-starter-parent 2.3.12.RELEASE这意味着JDK必须8或11不能用JDK17否则spring-boot-maven-plugin会报Unsupported class file major version 61mysql-connector-java版本锁死在8.0.33不是最新版因为该版本修复了LOAD DATA INFILE在Windows路径斜杠解析的bug——而人事系统里“批量导入员工Excel”功能正依赖此特性。在IDEA中正确导入步骤File → Open → 选中解压后的pom.xml→ 弹窗选“Import project from external model” → Maven右下角弹出“Maven projects need to be imported” → 点击“Enable Auto-Import”关键一步File → Project Structure → Project → SDK选JDK 11若无则DownloadLanguage level选“11”Modules → hrms → Sources → 确认src/main/java和src/main/resources被标记为Sources和Resources。提示如果启动时报java.lang.NoClassDefFoundError: javax/xml/bind/annotation/XmlSchema说明JDK11默认移除了JAXB模块需在pom.xml中显式添加dependency groupIdjavax.xml.bind/groupId artifactIdjaxb-api/artifactId version2.3.1/version /dependency2.4 启动前必做的三件事数据库初始化、静态资源路径校验、端口冲突排查SpringBoot默认启动端口8080但人事系统常需与Nginx反向代理配合所以application.yml里已预设server: port: 8081 servlet: context-path: /hrms这意味着访问地址是http://localhost:8081/hrms/login而非直连8080。启动前务必确认数据库初始化用Navicat或命令行执行hrms.sql注意SQL文件末尾有SET FOREIGN_KEY_CHECKS 0;确保外键约束不阻塞建表静态资源路径src/main/resources/static/下css/、js/、images/目录必须存在且index.html里引用的/hrms/css/app.css路径要与server.servlet.context-path一致端口占用排查Windows下运行netstat -ano | findstr :8081Linux下lsof -i :8081杀掉PID后重试。启动成功标志控制台输出Started HrmsApplication in X.XXX seconds (JVM running for Y.YYY)且浏览器打开http://localhost:8081/hrms/login显示登录页——此时输入SQL里预置的账号admin/123456应能进入主界面。3. 核心业务模块拆解从员工入职到离职归档的六段式流程实现3.1 组织架构管理部门树形结构的递归查询与拖拽排序实现人事系统最难啃的骨头不是CRUD而是部门树。本项目用sys_dept表实现无限级分类字段类型说明idBIGINT PK主键nameVARCHAR(50)部门名称parent_idBIGINT NULL父部门IDNULL表示根节点sort_orderINT DEFAULT 0同级排序权重值越小越靠前statusTINYINT DEFAULT 11启用0停用后端DeptController.java提供两个关键接口GET /dept/tree返回嵌套JSON如{id:1,name:总部,children:[{id:2,name:技术部}]}POST /dept/sort接收[{id:2,sortOrder:1},{id:3,sortOrder:2}]数组批量更新sort_order。前端用zTree插件渲染拖拽排序时触发onDrop事件将新顺序打包成JSON发给后端。避坑点在于MyBatis的foreach循环更新update idbatchUpdateSortOrder foreach collectionlist itemitem separator; UPDATE sys_dept SET sort_order #{item.sortOrder} WHERE id #{item.id} /foreach /update注意MySQL不支持一条SQL里多次UPDATE所以用separator;拼接多条语句——这要求jdbcUrl里开启allowMultiQueriestrue否则报You have an error in your SQL syntax。3.2 员工档案管理多附件上传与历史版本追溯机制员工表sys_employee字段设计暗藏业务逻辑entry_date DATE NOT NULL入职日期用于计算工龄status TINYINT DEFAULT 11在职2试用3离职4冻结avatar VARCHAR(255)头像URL但实际存储在src/main/resources/static/upload/avatar/下resume_url VARCHAR(255)简历PDF路径同样存本地。附件上传用MultipartFile实现关键在EmployeeController.javaPostMapping(/employee/upload) public ResponseEntity? uploadFiles(RequestParam(file) MultipartFile file, RequestParam(employeeId) Long employeeId) { String originalFilename file.getOriginalFilename(); String ext originalFilename.substring(originalFilename.lastIndexOf(.)); String newFilename employeeId _ System.currentTimeMillis() ext; Path uploadPath Paths.get(src/main/resources/static/upload/resume/, newFilename); Files.createDirectories(uploadPath.getParent()); file.transferTo(uploadPath); // 更新employee.resume_url字段为/hrms/upload/resume/ newFilename return ResponseEntity.ok().build(); }注意transferTo()方法在Windows下可能因路径斜杠报AccessDeniedException解决方案是统一用Paths.get()构造Path对象而非字符串拼接。3.3 考勤统计模块按月聚合打卡数据并生成Excel报表考勤表attendance_record结构精简但够用字段类型说明idBIGINT PKemployee_idBIGINT FK关联员工check_dateDATE打卡日期check_in_timeTIME NULL上班打卡时间check_out_timeTIME NULL下班打卡时间statusTINYINT0正常1迟到2早退3缺卡统计逻辑在AttendanceService.javapublic ListAttendanceMonthSummary getMonthlySummary(Long deptId, YearMonth yearMonth) { // 1. 先查出该部门所有员工当月打卡记录 // 2. 按employee_id分组用CASE WHEN统计各类状态天数 // 3. LEFT JOIN sys_employee获取姓名LEFT JOIN sys_dept获取部门名 return attendanceMapper.selectMonthlySummary(deptId, yearMonth); }Excel导出用Apache POIAttendanceController.java里GetMapping(/attendance/export) public void exportMonthlyReport(HttpServletResponse response, RequestParam Long deptId, RequestParam String yearMonth) { ListAttendanceMonthSummary data attendanceService.getMonthlySummary(deptId, YearMonth.parse(yearMonth)); // 创建Workbook → Sheet → Row → Cell逐行写入 response.setContentType(application/vnd.ms-excel); response.setHeader(Content-Disposition, attachment;filenameattendance_ yearMonth .xls); workbook.write(response.getOutputStream()); }提示POI 4.1.2版本对Excel 2007格式.xlsx支持更好但本项目用.xls因兼容老OA系统——若需.xlsx需替换HSSFWorkbook为XSSFWorkbook且response.setContentType改为application/vnd.openxmlformats-officedocument.spreadsheetml.sheet。3.4 薪资发放模块公式引擎与敏感字段加密存储薪资表salary_record不存明文数字而是存加密后的salary_encrypted字段// 加密逻辑在SalaryService.save() String encrypted AESUtil.encrypt(salary.getAmount().toString(), HRMS_SALT_KEY); salary.setSalaryEncrypted(encrypted);其中AESUtil.java用AES-128-CBC模式IV向量固定为16bytes_of_zero实际项目应动态生成。薪资计算公式存在sys_salary_formula表字段类型说明idBIGINT PKnameVARCHAR(50)“基本工资绩效*系数”expressionTEXTGroovy脚本baseSalary performance * coefficient运行时用GroovyShell解析表达式Binding binding new Binding(); binding.setVariable(baseSalary, 8000); binding.setVariable(performance, 1200); binding.setVariable(coefficient, 1.2); Object result shell.evaluate(expression, binding);注意Groovy脚本必须白名单校验本项目在SalaryFormulaValidator.java里用正则^[a-zA-Z0-9_\\-*/().\\s]$过滤非法字符防止Runtime.getRuntime().exec()注入。3.5 权限控制系统RBAC模型与菜单动态加载权限表设计遵循经典RBACsys_user用户→sys_role角色→sys_permission权限→sys_menu菜单sys_user_role用户-角色关联表sys_role_permission角色-权限关联表关键在MenuController.java的GET /menu/tree// 根据当前用户角色查出所有可用菜单 ListSysMenu menus menuMapper.selectByUserId(userId); // 构建树形结构先找parent_id为null的顶级菜单再递归查子菜单 return buildMenuTree(menus);前端用Vue Router的addRoutes()动态注册路由router.beforeEach拦截时调用/menu/tree接口拿到菜单JSON后menus.forEach(menu { if (menu.component) { router.addRoute({ path: menu.path, name: menu.name, component: () import(/views/${menu.component}.vue) }) } })避坑import()动态导入路径必须是字符串字面量不能拼接变量——所以menu.component字段值必须是employee/list这样的固定路径不能是employee/ type。3.6 离职管理闭环离职申请→审批流→档案归档→账号冻结离职流程走sys_leave_apply表字段类型说明idBIGINT PKemployee_idBIGINT FK申请人reasonTEXT离职原因statusTINYINT0待审批1已同意2已拒绝3已归档archive_dateDATETIME NULL归档时间审批流用状态机实现LeaveApplyService.java里Transactional public void approveLeave(Long applyId, Boolean approved) { LeaveApply apply leaveApplyMapper.selectById(applyId); if (approved) { apply.setStatus(1); // 同意 // 发送邮件通知HR专员 mailService.sendLeaveApprovedEmail(apply.getEmployeeId()); // 启动定时任务30天后自动归档 scheduledTaskService.scheduleArchiveTask(applyId, Duration.ofDays(30)); } else { apply.setStatus(2); // 拒绝 } leaveApplyMapper.updateById(apply); }归档操作archiveEmployee()会将sys_employee.status设为3离职复制员工档案到archive_employee历史表清空sys_user.password字段设为$2a$10$...空密码哈希删除sys_user_role关联记录使其无法登录。提示归档不是物理删除而是逻辑隔离——所有报表查询默认WHERE status ! 3但管理员可切到“历史档案”Tab查看。4. 避坑指南MySQL字符集、SpringBoot事务、前端跨域这三大雷区实录4.1 MySQL插入中文变问号表面是字符集问题根子在客户端连接配置现象INSERT INTO sys_employee (name) VALUES (张三);执行后查出来是??。原因MySQL服务端字符集是utf8mb4但客户端连接未声明编码SpringBoot JDBC URL漏了characterEncodingutf8mb4参数表字段本身用utf8而非utf8mb4创建ALTER TABLE sys_employee CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci。解决执行ALTER DATABASE hrms CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;对每个表执行ALTER TABLE sys_employee CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;确保JDBC URL含characterEncodingutf8mb4IDEA控制台右下角点击Terminal执行set names utf8mb4;临时切换会话编码。4.2 SpringBoot事务不生效Transactional失效的五个隐藏开关现象EmployeeService.deleteEmployee()方法加了Transactional但删除员工后关联的考勤记录没被级联删除。原因方法是private或final——CGLIB代理无法增强自调用deleteEmployee()里调用this.cleanRelatedData()代理失效异常类型不对Transactional(rollbackFor RuntimeException.class)但抛出的是IOException数据源配置错误Primary数据源没指向正确的DataSourceBeanMyBatis执行的是SqlSessionTemplate而非SqlSessionManager事务传播失效。解决改为public方法用ApplicationContext.getBean(EmployeeService.class).cleanRelatedData()替代this.调用显式写Transactional(rollbackFor Exception.class)检查DataSourceConfig.java里Bean Primary DataSource dataSource()是否正确Mapper接口方法必须用Update注解或XMLdelete标签不能用SqlSession.delete()裸调。4.3 前端跨域请求403不是CORS没配而是CSRF Token校验拦截现象Vue项目axios.post(/hrms/employee)返回403 Forbidden。原因SpringBoot Security默认开启CSRF防护表单提交需携带_csrf参数前端没从/login响应头XSRF-TOKEN里取Token也没在请求头X-XSRF-TOKEN里传application.yml里security.csrf.enabledtrue未关闭。解决开发环境临时关闭CSRF生产环境必须保留Configuration EnableWebSecurity public class SecurityConfig { Bean public SecurityFilterChain filterChain(HttpSecurity http) throws Exception { http.csrf().disable(); // 仅开发环境 return http.build(); } }或前端在main.js里// 从cookie取XSRF-TOKEN const csrfToken Cookies.get(XSRF-TOKEN); axios.defaults.headers.common[X-XSRF-TOKEN] csrfToken;后端SecurityConfig.java里配置Cookiehttp.rememberMe().tokenValiditySeconds(86400) .key(hrms_key) .rememberMeParameter(remember-me);4.4 Thymeleaf模板404路径对不上不是拼写错而是SpringBoot静态资源规则现象http://localhost:8081/hrms/login返回404但http://localhost:8081/hrms/css/app.css能访问。原因application.yml里server.servlet.context-path/hrms但Thymeleaf模板里写link th:href{/css/app.css}Thymeleaf会自动拼成/hrms/css/app.css但控制器GetMapping(/login)返回loginThymeleaf去找templates/login.html而templates/目录不在src/main/resources/下——它在src/main/resources/templates/但IDEA可能没识别为Resources Root。解决右键src/main/resources/templates→ Mark Directory as → Resources Root确保pom.xml里packagingjar/packaging不是war检查LoginController.javaGetMapping(/login) public String loginPage(Model model) { model.addAttribute(msg, 欢迎登录); return login; // 对应 templates/login.html }4.5 Maven依赖冲突spring-boot-starter-web和spring-boot-starter-thymeleaf版本打架现象启动时报java.lang.NoSuchMethodError: org.springframework.boot.autoconfigure.web.servlet.WebMvcAutoConfiguration$EnableWebMvcConfiguration.resourceHandlerMapping。原因pom.xml里手动引入了spring-webmvc 5.3.30与SpringBoot 2.3.12自带的5.2.22.RELEASE冲突thymeleaf-spring5版本与SpringBoot 2.3.x不兼容应使用thymeleaf-spring53.0.12.RELEASE。解决删除所有手动引入的spring-*依赖只保留spring-boot-starter-*在pom.xml里锁定Thymeleaf版本properties thymeleaf.version3.0.12.RELEASE/thymeleaf.version thymeleaf-layout-dialect.version2.4.1/thymeleaf-layout-dialect.version /properties运行mvn dependency:tree -Dverbose | grep thymeleaf确认无冲突版本。5. 进阶技巧把人事系统变成可交付产品——三招提升交付可信度5.1 数据库迁移脚本化用Flyway替代手工执行SQL让部署可追溯手工执行hrms.sql最大的问题是下次升级系统时你不知道哪些表结构改了、哪些数据初始化脚本漏了。Flyway能解决这个问题。在pom.xml加入dependency groupIdorg.flywaydb/groupId artifactIdflyway-core/artifactId /dependency然后在src/main/resources/db/migration/下建V1__init_schema.sqlCREATE TABLE sys_dept ( id BIGINT PRIMARY KEY AUTO_INCREMENT, name VARCHAR(50) NOT NULL, parent_id BIGINT, sort_order INT DEFAULT 0, status TINYINT DEFAULT 1 ); INSERT INTO sys_dept (id, name, parent_id, sort_order) VALUES (1, 总部, NULL, 1);application.yml里配置spring: flyway: enabled: true locations: classpath:db/migration baseline-on-migrate: true启动时Flyway自动检测V1__init_schema.sql并执行且在flyway_schema_history表里记录版本号。下次加字段新建V2__add_employee_avatar.sql即可——运维同事只要拉代码mvn spring-boot:run就自动完成数据库升级不用再问你要SQL文件。5.2 接口文档自动化用Swagger2生成可交互API文档替代Word说明书hrms项目里所有Controller都写了ApiOperation注解但没人看Word版《接口文档.docx》。集成Swagger2dependency groupIdio.springfox/groupId artifactIdspringfox-swagger2/artifactId version2.9.2/version /dependency dependency groupIdio.springfox/groupId artifactIdspringfox-swagger-ui/artifactId version2.9.2/version /dependency配置类SwaggerConfig.javaConfiguration EnableSwagger2 public class SwaggerConfig { Bean public Docket api() { return new Docket(DocumentationType.SWAGGER_2) .select() .apis(RequestHandlerSelectors.basePackage(com.example.hrms.controller)) .paths(PathSelectors.any()) .build() .apiInfo(apiInfo()); } }启动后访问http://localhost:8081/hrms/swagger-ui.html所有接口带参数说明、响应示例、在线调试按钮。我把这个链接直接放进部署说明PDF第一页——客户技术负责人点开就能试比截图讲10分钟强。5.3 生产环境安全加固三处必须改的默认配置毕业设计代码直接扔到生产环境至少做这三件事数据库密码加密application-prod.yml里用Jasypt加密spring: datasource: password: ENC(8aGvQZ...加密后字符串)启动时加JVM参数-Djasypt.encryptor.passwordyour_master_password。2.关闭H2 Consoleapplication.yml里删掉spring.h2.console.enabledtrue或设为false。3.禁用Actuator敏感端点application-prod.yml里management: endpoints: web: exposure: include: health,info,metrics endpoint: health: show-details: when_authorized这样/actuator/env这种泄露配置的端点就404了。从那以后我每次交付新系统都强制走一遍Flyway迁移Swagger文档生成Actuator端点审计——不是怕客户挑刺是怕自己三个月后接手维护时对着一堆V3__xxx.sql和V4__yyy.sql发懵。希望帮到你。本文还有配套的精品资源点击获取
