改造全攻略：环境匹配与权限设计)
简介这是一份基于Java开发的人力资源管理系统完整源码包主要面向Java初中级开发者、毕业设计选题者以及希望了解企业级Web项目结构的读者。系统中涵盖员工信息、部门管理、考勤、薪酬等常见业务模块可帮助学习Servlet、JSP、Spring、Hibernate、数据库设计等核心知识点。压缩包共1234个文件约18.61MB包含433个gif、405个htm、38个jsp、35个jar、34个java、34个class、27个xml、1个sql等类型覆盖前端页面、服务端逻辑、数据库脚本及工程配置便于对照分析项目结构与运行流程。资源已吸引1654人学习下载对于想通过完整项目提升Java开发能力、完成课程设计或深入理解HR系统业务实现的开发者来说是一份值得反复研读的实战资料。1. JAVA人力资源管理系统源码(含数据库).rar为什么我劝你别一上来就改代码拿到一个带数据库的 JAVA 人力资源管理系统源码很多人第一反应是解压、导入 IDE、改个密码就想跑起来。但我做过十几个这类项目的二次开发可以负责任地说这个方向的第一个坑不是业务逻辑而是环境匹配。人力资源管理系统通常涉及 Spring Boot MyBatis/JPA、MySQL 或 Oracle、Maven 多模块甚至还有 Shiro 或 Spring Security 做权限控制源码包里“含数据库”只代表有 SQL 脚本不代表导入就能连上。你真正要做的是先读懂这个包的服务端分层、数据字典和权限模型再考虑怎么改造成适合你团队的考勤、薪资、组织架构模块。这篇文章就按我平时接手的顺序来讲先判断这套源码的技术栈和可运行性再把它跑起来然后拆解人事、考勤、薪资、权限这几个核心模块的改造方法最后把数据库连接、日期处理、权限绕过、乱码这几个高频坑一次性说清楚。内容不依赖某个特定版本而是围绕“JAVA 人力资源管理系统源码”这类包通用的结构和逻辑展开适合要做课程设计、接手二手项目或者准备在公司内部快速搭一套 HRM 原型的人。2. 拆包看货源码文件结构、技术栈判断和数据库脚本认别2.1 先看这三个文件判断这个包能不能落地解压“JAVA人力资源管理系统源码(含数据库).rar”后不要直接找 Controller先看根目录和配置文件。一般这套系统会有三种形态第一种是 Eclipse/MyEclipse 时代的 Web 项目带.project、.classpath用 JSP Servlet JDBC数据库脚本通常是.sql文件第二种是 Maven 工程有pom.xml用 Spring Boot 或 SSMSpring SpringMVC MyBatis第三种是带webapp目录的 war 包结构。判断方法很简单有没有pom.xml决定构建方式有没有application.yml或spring-context.xml决定 Spring 配置风格有没有jdbc.properties或db.properties决定数据库连接方式。我一般会先看三处pom.xml依赖清单、resources下的数据库配置文件、以及数据库脚本的头部注释。脚本头部往往会写 MySQL 版本或字符集比如SET NAMES utf8mb4表示至少 MySQL 5.5 以上如果是 Oracle 结构有SYSDATE、VARCHAR2那你的本机环境就得装 Oracle 或者改成 MySQL。这一步的核心是确定「数据库 服务器 JDK」的三角匹配否则后面全是乱码和连接失败。2.2 人力资源系统的数据库脚本到底在传什么“含数据库”不是指那一个.rar里有个数据库文件而是指 SQL 脚本。常见形式有三种完整的建库建表脚本create_database.sql、带测试数据的insert_data.sql、以及视图/存储过程。一个规范的人力资源管理数据库至少要有部门表、员工表、用户表、角色表、薪资表、考勤表、请假表。你打开脚本后先数一下CREATE TABLE的数量再看有没有外键关系最后确认是否有INSERT INTO。缺测试数据的脚本会让你登录后看到一片空白缺视图脚本可能导致某些查询逻辑报错。这里有个很实际的建议拿到脚本后先本地新建一个空数据库再执行脚本。不要直接用源码包里可能带有的.mdf、.frm文件那些大多是文件型数据库或者 MySQL 的物理表文件版本不一致加载不了。正确做法是打开 MySQL 命令行或 Navicat执行mysql -u root -p -e source /path/to/schema.sql执行后用SHOW TABLES;确认表数量再抽查一张employee表的字段DESC employee;这一步的意义在于确认结构与你的业务需求之间的差距。如果你的系统需要「多公司架构」而这个脚本只有单公司字段那后续就要加company_id这类扩展列越早发现越好。2.3 技术栈选型为什么 Spring Boot MyBatis 的版本最值得上手如果你手里的源码是 JSP Servlet JDBC 的旧结构我的建议是不要花时间去精读它的数据访问层而是把它当成业务参考用 Spring Boot MyBatis 重写数据访问。原因很直接现代人力资源管理系统需要对接考勤机、薪资计算、审批流旧式Connection conn DriverManager.getConnection()的写法维护成本太高。但如果你是做课程设计原始 JDBC 版本反而更容易答辩——因为代码结构直白老师能看懂。本包若为 Spring Boot 版则会有spring-boot-starter-web、mybatis-spring-boot-starter、mysql-connector-java这几个核心依赖。启动入口是一个带SpringBootApplication的类。识别方法在src/main/java下找Application.java或者Main.java。启动前必须改三处配置application.yml里的数据源地址、用户名、密码以及mybatis.mapper-locations的路径是否匹配mapper/*.xml。这三处不改对后端服务永远在报连接超时或表不存在。3. 把系统跑起来的完整操作数据库初始化、Maven 配置和登录调试3.1 数据库初始化执行脚本的顺序与字符集设参数初始化数据库时最容易翻车的是字符集。人力资源管理系统里有大量中文姓名、部门名称和考勤备注如果表字段是utf8mb4而连接字符串没指定characterEncodingutf8写入中文就会变成问号。我的执行顺序是CREATE DATABASE IF NOT EXISTS hrms DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; USE hrms; SET NAMES utf8mb4; SOURCE /path/to/hrms_data.sql;先建库再SET NAMES最后执行脚本。如果脚本文件本身是 GBK 编码打开后看到的中文是乱码那么先用文本编辑器把脚本转成UTF-8 without BOM再执行。这一步能省掉后面至少两个小时的排查时间。3.2 修改数据库连接配置三处必须对齐的参数Spring Boot 项目的application.yml中数据源配置是第一个坑。常见做法是spring: datasource: url: jdbc:mysql://localhost:3306/hrms?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/ShanghaiuseSSLfalse username: root password: your_password driver-class-name: com.mysql.cj.jdbc.Driver mybatis: mapper-locations: classpath:mapper/*.xml type-aliases-package: com.example.hrms.entity注意driver-class-name有两个选择MySQL 5.x 用com.mysql.jdbc.DriverMySQL 8.x 必须用com.mysql.cj.jdbc.Driver。serverTimezone不设会在 JDBC 连接时报错Asia/Shanghai是大陆服务器常用值。如果你的源码是 SSM 结构这些配置写在jdbc.properties里并用context:property-placeholder引入改法同理。改完后启动 Spring Boot观察控制台日志。看到Tomcat started on port(s): 8080说明后端就绪。如果报Table hrms.xxx doesnt exist说明脚本没执行成功返回去查脚本里是否有跨库引用比如USE otherdb;把它改成你自己的库名。3.3 登录调试绕开验证码和权限拦截的最小路径人力资源管理系统一定带登录功能和权限控制。调试阶段最烦的是验证码或者邮箱激活。我的做法是先看登录 Controller 和前端登录页的交互逻辑找到验证码校验那段代码暂时注释掉等业务流程跑通再恢复。比如常常是这种逻辑PostMapping(/login) public Result login(String username, String password, String captchaCode) { // 校验验证码调试时先跳过 String sessionCaptcha (String) session.getAttribute(captcha); if (sessionCaptcha null || !sessionCaptcha.equalsIgnoreCase(captchaCode)) { return Result.error(验证码错误); } // 实际登录逻辑 User user userService.login(username, password); ... }调试期可以把验证码那段直接注释同时确保登录时传空的captchaCode也能走到userService.login。如果你搞不清楚登录页用的是什么参数格式用浏览器开发者工具看提交的Form Data或者Request Payload比猜省略得好。3.4 管理员账号密码找不到怎么办很多源码包自带的初始化数据里管理员账号是admin密码是admin或123456但也有部分喜欢用admin1、system。如果登录失败不要急着怀疑代码直接用 SQL 查用户表SELECT * FROM sys_user LIMIT 5;看看密码字段是什么格式。如果是明文直接改掉UPDATE sys_user SET password123456 WHERE usernameadmin;如果是 MD5就要先算出 MD5 值再更新。常见加密写法是MD5(密码)这里注意 MySQL 的MD5()函数算出来是 32 位小写十六进制。如果源码里用了 BCrypt特征是密码前缀$2a$则需要用 Java 的BCryptPasswordEncoder生成一段密文再更新最省事的做法是写一个 Spring Boot 命令行测试类生成密文千万别用在线网站生成的版本算法可能不一致。4. 改造核心模块员工管理、考勤、薪资与权限设计的落地思路4.1 员工管理模块部门树与员工档案的分页查询改造人力资源管理系统最核心的页面是员工列表通常要求支持多条件查询、部门树过滤和分页。MyBatis 下最常见的实现是写一个 mapper 接口加 XML。改造前先看实体类字段是否齐全工号、姓名、部门、职位、入职日期、手机号、身份证号、状态。如果只有少数几个字段你需要在数据库加列同时改实体、Mapper XML 的resultMap和前端表格列。分页查询我一般用 PageHelper配置方式PageHelper.startPage(pageNum, pageSize); ListEmployee list employeeMapper.selectByCondition(emp); PageInfoEmployee pageInfo new PageInfo(list);注意一个坑PageHelper.startPage必须紧跟 Mapper 查询方法中间不能穿插其他 SQL 操作否则分页会串到别的查询上。这是 PageHelper 的线程本地变量机制决定的很多人刚用时在这个地方翻过车。如果你不想引入分页插件可以直接用 MySQL 的LIMIT ? , ?但要注意计算偏移量(pageNum-1)*pageSize。4.2 考勤模块迟到早退统计的日期计算与状态机设计考勤模块是人力资源管理系统里业务复杂度最高的部分不只是查询打卡记录还涉及排班、请假、出差、加班。源码包里的考勤往往只有最简单的上下班打卡表和迟到标记你要做的是把它扩展成可以计算的模型。我的做法是引入「考勤日状态」字段normal、late、early、absent、leave、business。每日定时任务根据打卡数据与排班数据更新这个状态而不是在查询时实时计算。例如计算迟到时不能只看打卡时间还要看该员工当日排班的上班时间。常见 SQL 逻辑是UPDATE attendance a SET a.status late WHERE a.employee_id ? AND a.check_in_time ( SELECT s.shift_start_time FROM schedule s WHERE s.employee_id a.employee_id AND s.work_date a.work_date )注意日期边界跨天排班比如夜班 22:00 到次日 6:00不能简单地用check_in_time shift_start_time判断。常见做法是排班表里加一个shift_end_time如果结束时间小于开始时间表示跨天。这样比较时就要做日期加一天处理。4.3 薪资模块可用一个计算公式表代替一堆 if-else薪资模块最容易让二次开发头大因为每个公司的薪资构成不一样基本工资、岗位工资、绩效、全勤奖、餐补、社保扣款、个税。源码包里常见的实现是直接写死 Java 计算逻辑改一个薪资项就得改代码重新编译。我一般会建议改成公式配置方案在数据库建一张salary_item表字段包括项名称、计算方式固定值/员工档案字段/公式、优先级。然后在计算时动态拼公式用简单的字符串表达式解析器比如exp4j库去执行。比如全勤奖的公式可以是employee.salary * 0.1。这样做的好处是减少改代码。坏处是调试复杂公式报错不好定位。如果你只是做课设或内部小系统直接写calculateSalary()方法更直观没必要过度设计。4.4 权限模型RBAC 的过滤链与动态菜单实现人力资源管理系统里的员工数据是敏感数据权限至少要分管理员、HR、部门经理、普通员工四类。源码包通常用 Shiro 或 Spring Security。如果是 Shiro它的核心在于ShiroFilterFactoryBean中配置 URL 拦截规则。你需要理解几个常见过滤器anon匿名可访问、authc需登录、roles[admin]需 admin 角色、perms[employee:add]需某权限。动态菜单的常见实现方式用户登录时查询其角色对应的菜单权限列表存到 Session 里前端根据这个列表渲染菜单。这里有个很实际的坑前端页面静态写死了菜单导致权限控制只是后端有前端不显示但页面可以直接访问 URL。所以你还要在后端用拦截器对所有除登录页和静态资源外的 URL 做鉴权。检查方式打开浏览器开发者工具模拟一个未授权角色登录手动访问其他页面的 URL如果直接返回 200 且能看到数据说明鉴权有洞。5. 避坑指南人力资源管理系统二次开发的 5 个常见问题5.1 数据库连接池启动报错Access denied for user现象系统启动时出现Access denied for user rootlocalhost或者Communications link failure。原因一是密码不对二是 MySQL 8 默认使用caching_sha2_password认证插件而项目里的驱动版本太老只支持mysql_native_password。解决先确认密码在命令行mysql -u root -p手动登录一次。如果用 Navicat 能连但 Java 连不上多半是认证插件问题执行ALTER USER rootlocalhost IDENTIFIED WITH mysql_native_password BY your_password; FLUSH PRIVILEGES;同时把数据库驱动换成mysql-connector-java8.0.30 以上。如果是远程连接还要确认 MySQL 的bind-address不是只有127.0.0.1。5.2 页面显示中文问号数据库存进去也是问号现象员工姓名新增后显示???SQL 查询中文乱码。原因连接 URL 没设置characterEncoding或者表和字段字符集不是utf8mb4。解决先检查数据库表字符集SHOW CREATE TABLE employee;如果不是utf8mb4执行ALTER TABLE employee CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;然后确保 JDBC URL 里有characterEncodingutf8。最后查看页面编码JSP 页面顶部要有pageEncodingUTF-8HTML 页面要有meta charsetUTF-8。这三层必须统一。5.3 启动后访问登录页 404 或 405现象后端启动成功但访问/login返回 404或者提交表单返回 405Method Not Allowed。原因404 一般是静态资源路径不对比如项目放在了webapp下但你访问的路径没有配view-controller405 多半是 Controller 方法只写了GetMapping而前端表单用的是POST。解决看前端表单的method属性与后端注解是否匹配。如果是 Spring Boot JSP要检查spring.mvc.view.prefix和suffix配置。常见配置spring: mvc: view: prefix: /WEB-INF/views/ suffix: .jsp并且 JSP 文件必须放在src/main/webapp/WEB-INF/views下不能被拦截器拦截。5.4 明明用户已登录但每次都跳回登录页现象登录成功进入首页点击任何菜单后又被弹回登录页。原因Session 失效或者权限框架每次请求都没能读取到登录状态。常见的是 Shiro 配置中securityManager没有设置sessionManager的 cookie 域名或者项目路径改了导致 cookie 路径不匹配。解决检查浏览器的 Cookie看看登录后是否种下了JSESSIONID。如果每次请求响应头都重新设置JSESSIONID说明 Session 没有保存住。可能是后端在登录成功后session.invalidate()了旧 Session或前后端口不同导致 Cookie 跨域。在 Spring Boot 里可以这样设置 Cookie 路径server: servlet: session: cookie: path: /如果前后端分离则要配置 CORS 并设置allowCredentials(true)。5.5 修改了数据库密码运行时报Public Key Retrieval is not allowed现象启动数据库操作时报Public Key Retrieval is not allowed。原因MySQL 8 的认证机制在客户端请求 RSA 公钥时被拒绝多发生在连接 URL 未加allowPublicKeyRetrievaltrue。解决在 JDBC URL 中加两个参数useSSLfalseallowPublicKeyRetrievaltrue如果你的源码是部署到生产环境建议用专用账号而不是 root并限制该账号只对 hrms 库有权限毕竟人力资源数据涉及薪资和身份证信息安全等级要高一些。6. 进阶玩法把系统从单体 JSP 改成前后端分离并挂上统一日志和定时任务当你把这套人力资源管理系统跑通后下一步不是加新功能而是让它可持续维护。我见过太多团队在 JSP 里堆业务代码最终没人敢动。我的建议是保持后端接口不变前端改用 Vue 或 React 去请求 REST API。这么做你只需要在后端写RestController返回 JSON前端用 Axios 调用。改造时注意原项目里的Controller返回 ModelAndView 的代码要逐一改成RestController并给返回类加统一的Result包装{ code, message, data }。权限拦截思路不变但登录状态建议改成 JWT Header 传递而不是依赖 Session因为前后端分离后 Cookie 跨域问题太烦了。另外一个很实用的进阶点是给考勤和薪资计算加上定时任务。用 Spring Boot 的Scheduled就可以不用引入 Quartz 全家桶Component public class AttendanceTask { Scheduled(cron 0 0 2 * * *) public void runDailyAttendanceCalc() { // 每天凌晨 2 点计算前一天的考勤状态 attendanceService.calculateYesterday(); } Scheduled(cron 0 0 3 1 * *) public void runMonthlySalaryCalc() { // 每月 1 号凌晨 3 点计算上月薪资 salaryService.calculateLastMonth(); } }注意cron表达式在 Spring 里是六位与 Linux 的crontab五位不同多了秒位。定时任务里只做计算和写库不发送消息否则失败后没有补偿机制容易导致数据缺失。最后给一个验证系统的习惯每次改动数据库结构或权限配置后跑一遍三张核心表的数据流检查——部门新增员工 → 给员工分配账号 → 设置部门经理 → 经理能查下属考勤和薪资。这五步能覆盖人力资源管理系统八成核心链路。我自己的血泪经验是永远不要直接在生产库上执行源码包里的schema.sql先备份一份原始表结构再在测试库上模拟。有了后悔药你才敢放手改。希望这篇笔记能帮你在「JAVA人力资源管理系统源码(含数据库).rar」这个项目上少踩几个坑。如果你打算用它做课程设计或公司内部原型先从最小闭环做起跑通数据库、登录、员工增删改查再去折腾薪资和考勤这样即使出问题你也能迅速定位是改代码引入的还是原来就有问题。本文还有配套的精品资源点击获取 
长河君 · 2026/10/9 1:09:57 · 阅读 1.2k JAVA人力资源管理系统源码(含数据库)改造全攻略：环境匹配与权限设计
简介这是一份基于Java开发的人力资源管理系统完整源码包主要面向Java初中级开发者、毕业设计选题者以及希望了解企业级Web项目结构的读者。系统中涵盖员工信息、部门管理、考勤、薪酬等常见业务模块可帮助学习Servlet、JSP、Spring、Hibernate、数据库设计等核心知识点。压缩包共1234个文件约18.61MB包含433个gif、405个htm、38个jsp、35个jar、34个java、34个class、27个xml、1个sql等类型覆盖前端页面、服务端逻辑、数据库脚本及工程配置便于对照分析项目结构与运行流程。资源已吸引1654人学习下载对于想通过完整项目提升Java开发能力、完成课程设计或深入理解HR系统业务实现的开发者来说是一份值得反复研读的实战资料。1. JAVA人力资源管理系统源码(含数据库).rar为什么我劝你别一上来就改代码拿到一个带数据库的 JAVA 人力资源管理系统源码很多人第一反应是解压、导入 IDE、改个密码就想跑起来。但我做过十几个这类项目的二次开发可以负责任地说这个方向的第一个坑不是业务逻辑而是环境匹配。人力资源管理系统通常涉及 Spring Boot MyBatis/JPA、MySQL 或 Oracle、Maven 多模块甚至还有 Shiro 或 Spring Security 做权限控制源码包里“含数据库”只代表有 SQL 脚本不代表导入就能连上。你真正要做的是先读懂这个包的服务端分层、数据字典和权限模型再考虑怎么改造成适合你团队的考勤、薪资、组织架构模块。这篇文章就按我平时接手的顺序来讲先判断这套源码的技术栈和可运行性再把它跑起来然后拆解人事、考勤、薪资、权限这几个核心模块的改造方法最后把数据库连接、日期处理、权限绕过、乱码这几个高频坑一次性说清楚。内容不依赖某个特定版本而是围绕“JAVA 人力资源管理系统源码”这类包通用的结构和逻辑展开适合要做课程设计、接手二手项目或者准备在公司内部快速搭一套 HRM 原型的人。2. 拆包看货源码文件结构、技术栈判断和数据库脚本认别2.1 先看这三个文件判断这个包能不能落地解压“JAVA人力资源管理系统源码(含数据库).rar”后不要直接找 Controller先看根目录和配置文件。一般这套系统会有三种形态第一种是 Eclipse/MyEclipse 时代的 Web 项目带.project、.classpath用 JSP Servlet JDBC数据库脚本通常是.sql文件第二种是 Maven 工程有pom.xml用 Spring Boot 或 SSMSpring SpringMVC MyBatis第三种是带webapp目录的 war 包结构。判断方法很简单有没有pom.xml决定构建方式有没有application.yml或spring-context.xml决定 Spring 配置风格有没有jdbc.properties或db.properties决定数据库连接方式。我一般会先看三处pom.xml依赖清单、resources下的数据库配置文件、以及数据库脚本的头部注释。脚本头部往往会写 MySQL 版本或字符集比如SET NAMES utf8mb4表示至少 MySQL 5.5 以上如果是 Oracle 结构有SYSDATE、VARCHAR2那你的本机环境就得装 Oracle 或者改成 MySQL。这一步的核心是确定「数据库 服务器 JDK」的三角匹配否则后面全是乱码和连接失败。2.2 人力资源系统的数据库脚本到底在传什么“含数据库”不是指那一个.rar里有个数据库文件而是指 SQL 脚本。常见形式有三种完整的建库建表脚本create_database.sql、带测试数据的insert_data.sql、以及视图/存储过程。一个规范的人力资源管理数据库至少要有部门表、员工表、用户表、角色表、薪资表、考勤表、请假表。你打开脚本后先数一下CREATE TABLE的数量再看有没有外键关系最后确认是否有INSERT INTO。缺测试数据的脚本会让你登录后看到一片空白缺视图脚本可能导致某些查询逻辑报错。这里有个很实际的建议拿到脚本后先本地新建一个空数据库再执行脚本。不要直接用源码包里可能带有的.mdf、.frm文件那些大多是文件型数据库或者 MySQL 的物理表文件版本不一致加载不了。正确做法是打开 MySQL 命令行或 Navicat执行mysql -u root -p -e source /path/to/schema.sql执行后用SHOW TABLES;确认表数量再抽查一张employee表的字段DESC employee;这一步的意义在于确认结构与你的业务需求之间的差距。如果你的系统需要「多公司架构」而这个脚本只有单公司字段那后续就要加company_id这类扩展列越早发现越好。2.3 技术栈选型为什么 Spring Boot MyBatis 的版本最值得上手如果你手里的源码是 JSP Servlet JDBC 的旧结构我的建议是不要花时间去精读它的数据访问层而是把它当成业务参考用 Spring Boot MyBatis 重写数据访问。原因很直接现代人力资源管理系统需要对接考勤机、薪资计算、审批流旧式Connection conn DriverManager.getConnection()的写法维护成本太高。但如果你是做课程设计原始 JDBC 版本反而更容易答辩——因为代码结构直白老师能看懂。本包若为 Spring Boot 版则会有spring-boot-starter-web、mybatis-spring-boot-starter、mysql-connector-java这几个核心依赖。启动入口是一个带SpringBootApplication的类。识别方法在src/main/java下找Application.java或者Main.java。启动前必须改三处配置application.yml里的数据源地址、用户名、密码以及mybatis.mapper-locations的路径是否匹配mapper/*.xml。这三处不改对后端服务永远在报连接超时或表不存在。3. 把系统跑起来的完整操作数据库初始化、Maven 配置和登录调试3.1 数据库初始化执行脚本的顺序与字符集设参数初始化数据库时最容易翻车的是字符集。人力资源管理系统里有大量中文姓名、部门名称和考勤备注如果表字段是utf8mb4而连接字符串没指定characterEncodingutf8写入中文就会变成问号。我的执行顺序是CREATE DATABASE IF NOT EXISTS hrms DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; USE hrms; SET NAMES utf8mb4; SOURCE /path/to/hrms_data.sql;先建库再SET NAMES最后执行脚本。如果脚本文件本身是 GBK 编码打开后看到的中文是乱码那么先用文本编辑器把脚本转成UTF-8 without BOM再执行。这一步能省掉后面至少两个小时的排查时间。3.2 修改数据库连接配置三处必须对齐的参数Spring Boot 项目的application.yml中数据源配置是第一个坑。常见做法是spring: datasource: url: jdbc:mysql://localhost:3306/hrms?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/ShanghaiuseSSLfalse username: root password: your_password driver-class-name: com.mysql.cj.jdbc.Driver mybatis: mapper-locations: classpath:mapper/*.xml type-aliases-package: com.example.hrms.entity注意driver-class-name有两个选择MySQL 5.x 用com.mysql.jdbc.DriverMySQL 8.x 必须用com.mysql.cj.jdbc.Driver。serverTimezone不设会在 JDBC 连接时报错Asia/Shanghai是大陆服务器常用值。如果你的源码是 SSM 结构这些配置写在jdbc.properties里并用context:property-placeholder引入改法同理。改完后启动 Spring Boot观察控制台日志。看到Tomcat started on port(s): 8080说明后端就绪。如果报Table hrms.xxx doesnt exist说明脚本没执行成功返回去查脚本里是否有跨库引用比如USE otherdb;把它改成你自己的库名。3.3 登录调试绕开验证码和权限拦截的最小路径人力资源管理系统一定带登录功能和权限控制。调试阶段最烦的是验证码或者邮箱激活。我的做法是先看登录 Controller 和前端登录页的交互逻辑找到验证码校验那段代码暂时注释掉等业务流程跑通再恢复。比如常常是这种逻辑PostMapping(/login) public Result login(String username, String password, String captchaCode) { // 校验验证码调试时先跳过 String sessionCaptcha (String) session.getAttribute(captcha); if (sessionCaptcha null || !sessionCaptcha.equalsIgnoreCase(captchaCode)) { return Result.error(验证码错误); } // 实际登录逻辑 User user userService.login(username, password); ... }调试期可以把验证码那段直接注释同时确保登录时传空的captchaCode也能走到userService.login。如果你搞不清楚登录页用的是什么参数格式用浏览器开发者工具看提交的Form Data或者Request Payload比猜省略得好。3.4 管理员账号密码找不到怎么办很多源码包自带的初始化数据里管理员账号是admin密码是admin或123456但也有部分喜欢用admin1、system。如果登录失败不要急着怀疑代码直接用 SQL 查用户表SELECT * FROM sys_user LIMIT 5;看看密码字段是什么格式。如果是明文直接改掉UPDATE sys_user SET password123456 WHERE usernameadmin;如果是 MD5就要先算出 MD5 值再更新。常见加密写法是MD5(密码)这里注意 MySQL 的MD5()函数算出来是 32 位小写十六进制。如果源码里用了 BCrypt特征是密码前缀$2a$则需要用 Java 的BCryptPasswordEncoder生成一段密文再更新最省事的做法是写一个 Spring Boot 命令行测试类生成密文千万别用在线网站生成的版本算法可能不一致。4. 改造核心模块员工管理、考勤、薪资与权限设计的落地思路4.1 员工管理模块部门树与员工档案的分页查询改造人力资源管理系统最核心的页面是员工列表通常要求支持多条件查询、部门树过滤和分页。MyBatis 下最常见的实现是写一个 mapper 接口加 XML。改造前先看实体类字段是否齐全工号、姓名、部门、职位、入职日期、手机号、身份证号、状态。如果只有少数几个字段你需要在数据库加列同时改实体、Mapper XML 的resultMap和前端表格列。分页查询我一般用 PageHelper配置方式PageHelper.startPage(pageNum, pageSize); ListEmployee list employeeMapper.selectByCondition(emp); PageInfoEmployee pageInfo new PageInfo(list);注意一个坑PageHelper.startPage必须紧跟 Mapper 查询方法中间不能穿插其他 SQL 操作否则分页会串到别的查询上。这是 PageHelper 的线程本地变量机制决定的很多人刚用时在这个地方翻过车。如果你不想引入分页插件可以直接用 MySQL 的LIMIT ? , ?但要注意计算偏移量(pageNum-1)*pageSize。4.2 考勤模块迟到早退统计的日期计算与状态机设计考勤模块是人力资源管理系统里业务复杂度最高的部分不只是查询打卡记录还涉及排班、请假、出差、加班。源码包里的考勤往往只有最简单的上下班打卡表和迟到标记你要做的是把它扩展成可以计算的模型。我的做法是引入「考勤日状态」字段normal、late、early、absent、leave、business。每日定时任务根据打卡数据与排班数据更新这个状态而不是在查询时实时计算。例如计算迟到时不能只看打卡时间还要看该员工当日排班的上班时间。常见 SQL 逻辑是UPDATE attendance a SET a.status late WHERE a.employee_id ? AND a.check_in_time ( SELECT s.shift_start_time FROM schedule s WHERE s.employee_id a.employee_id AND s.work_date a.work_date )注意日期边界跨天排班比如夜班 22:00 到次日 6:00不能简单地用check_in_time shift_start_time判断。常见做法是排班表里加一个shift_end_time如果结束时间小于开始时间表示跨天。这样比较时就要做日期加一天处理。4.3 薪资模块可用一个计算公式表代替一堆 if-else薪资模块最容易让二次开发头大因为每个公司的薪资构成不一样基本工资、岗位工资、绩效、全勤奖、餐补、社保扣款、个税。源码包里常见的实现是直接写死 Java 计算逻辑改一个薪资项就得改代码重新编译。我一般会建议改成公式配置方案在数据库建一张salary_item表字段包括项名称、计算方式固定值/员工档案字段/公式、优先级。然后在计算时动态拼公式用简单的字符串表达式解析器比如exp4j库去执行。比如全勤奖的公式可以是employee.salary * 0.1。这样做的好处是减少改代码。坏处是调试复杂公式报错不好定位。如果你只是做课设或内部小系统直接写calculateSalary()方法更直观没必要过度设计。4.4 权限模型RBAC 的过滤链与动态菜单实现人力资源管理系统里的员工数据是敏感数据权限至少要分管理员、HR、部门经理、普通员工四类。源码包通常用 Shiro 或 Spring Security。如果是 Shiro它的核心在于ShiroFilterFactoryBean中配置 URL 拦截规则。你需要理解几个常见过滤器anon匿名可访问、authc需登录、roles[admin]需 admin 角色、perms[employee:add]需某权限。动态菜单的常见实现方式用户登录时查询其角色对应的菜单权限列表存到 Session 里前端根据这个列表渲染菜单。这里有个很实际的坑前端页面静态写死了菜单导致权限控制只是后端有前端不显示但页面可以直接访问 URL。所以你还要在后端用拦截器对所有除登录页和静态资源外的 URL 做鉴权。检查方式打开浏览器开发者工具模拟一个未授权角色登录手动访问其他页面的 URL如果直接返回 200 且能看到数据说明鉴权有洞。5. 避坑指南人力资源管理系统二次开发的 5 个常见问题5.1 数据库连接池启动报错Access denied for user现象系统启动时出现Access denied for user rootlocalhost或者Communications link failure。原因一是密码不对二是 MySQL 8 默认使用caching_sha2_password认证插件而项目里的驱动版本太老只支持mysql_native_password。解决先确认密码在命令行mysql -u root -p手动登录一次。如果用 Navicat 能连但 Java 连不上多半是认证插件问题执行ALTER USER rootlocalhost IDENTIFIED WITH mysql_native_password BY your_password; FLUSH PRIVILEGES;同时把数据库驱动换成mysql-connector-java8.0.30 以上。如果是远程连接还要确认 MySQL 的bind-address不是只有127.0.0.1。5.2 页面显示中文问号数据库存进去也是问号现象员工姓名新增后显示???SQL 查询中文乱码。原因连接 URL 没设置characterEncoding或者表和字段字符集不是utf8mb4。解决先检查数据库表字符集SHOW CREATE TABLE employee;如果不是utf8mb4执行ALTER TABLE employee CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;然后确保 JDBC URL 里有characterEncodingutf8。最后查看页面编码JSP 页面顶部要有pageEncodingUTF-8HTML 页面要有meta charsetUTF-8。这三层必须统一。5.3 启动后访问登录页 404 或 405现象后端启动成功但访问/login返回 404或者提交表单返回 405Method Not Allowed。原因404 一般是静态资源路径不对比如项目放在了webapp下但你访问的路径没有配view-controller405 多半是 Controller 方法只写了GetMapping而前端表单用的是POST。解决看前端表单的method属性与后端注解是否匹配。如果是 Spring Boot JSP要检查spring.mvc.view.prefix和suffix配置。常见配置spring: mvc: view: prefix: /WEB-INF/views/ suffix: .jsp并且 JSP 文件必须放在src/main/webapp/WEB-INF/views下不能被拦截器拦截。5.4 明明用户已登录但每次都跳回登录页现象登录成功进入首页点击任何菜单后又被弹回登录页。原因Session 失效或者权限框架每次请求都没能读取到登录状态。常见的是 Shiro 配置中securityManager没有设置sessionManager的 cookie 域名或者项目路径改了导致 cookie 路径不匹配。解决检查浏览器的 Cookie看看登录后是否种下了JSESSIONID。如果每次请求响应头都重新设置JSESSIONID说明 Session 没有保存住。可能是后端在登录成功后session.invalidate()了旧 Session或前后端口不同导致 Cookie 跨域。在 Spring Boot 里可以这样设置 Cookie 路径server: servlet: session: cookie: path: /如果前后端分离则要配置 CORS 并设置allowCredentials(true)。5.5 修改了数据库密码运行时报Public Key Retrieval is not allowed现象启动数据库操作时报Public Key Retrieval is not allowed。原因MySQL 8 的认证机制在客户端请求 RSA 公钥时被拒绝多发生在连接 URL 未加allowPublicKeyRetrievaltrue。解决在 JDBC URL 中加两个参数useSSLfalseallowPublicKeyRetrievaltrue如果你的源码是部署到生产环境建议用专用账号而不是 root并限制该账号只对 hrms 库有权限毕竟人力资源数据涉及薪资和身份证信息安全等级要高一些。6. 进阶玩法把系统从单体 JSP 改成前后端分离并挂上统一日志和定时任务当你把这套人力资源管理系统跑通后下一步不是加新功能而是让它可持续维护。我见过太多团队在 JSP 里堆业务代码最终没人敢动。我的建议是保持后端接口不变前端改用 Vue 或 React 去请求 REST API。这么做你只需要在后端写RestController返回 JSON前端用 Axios 调用。改造时注意原项目里的Controller返回 ModelAndView 的代码要逐一改成RestController并给返回类加统一的Result包装{ code, message, data }。权限拦截思路不变但登录状态建议改成 JWT Header 传递而不是依赖 Session因为前后端分离后 Cookie 跨域问题太烦了。另外一个很实用的进阶点是给考勤和薪资计算加上定时任务。用 Spring Boot 的Scheduled就可以不用引入 Quartz 全家桶Component public class AttendanceTask { Scheduled(cron 0 0 2 * * *) public void runDailyAttendanceCalc() { // 每天凌晨 2 点计算前一天的考勤状态 attendanceService.calculateYesterday(); } Scheduled(cron 0 0 3 1 * *) public void runMonthlySalaryCalc() { // 每月 1 号凌晨 3 点计算上月薪资 salaryService.calculateLastMonth(); } }注意cron表达式在 Spring 里是六位与 Linux 的crontab五位不同多了秒位。定时任务里只做计算和写库不发送消息否则失败后没有补偿机制容易导致数据缺失。最后给一个验证系统的习惯每次改动数据库结构或权限配置后跑一遍三张核心表的数据流检查——部门新增员工 → 给员工分配账号 → 设置部门经理 → 经理能查下属考勤和薪资。这五步能覆盖人力资源管理系统八成核心链路。我自己的血泪经验是永远不要直接在生产库上执行源码包里的schema.sql先备份一份原始表结构再在测试库上模拟。有了后悔药你才敢放手改。希望这篇笔记能帮你在「JAVA人力资源管理系统源码(含数据库).rar」这个项目上少踩几个坑。如果你打算用它做课程设计或公司内部原型先从最小闭环做起跑通数据库、登录、员工增删改查再去折腾薪资和考勤这样即使出问题你也能迅速定位是改代码引入的还是原来就有问题。本文还有配套的精品资源点击获取