简介这是一套基于Java与SSM框架Spring、SpringMVC、MyBatis实现的人事管理OA办公系统毕业设计项目面向计算机相关专业的学生、老师及初期开发者适用于毕业设计、课程设计、项目立项演示或进阶学习。源码已通过导师指导与答辩评审且已在macOS及Windows 10/11环境下完成运行测试功能稳定可在此基础上继续扩展。压缩包共286个文件主要包含Java源码、JSP页面、XML配置、数据库SQL脚本、前端CSS/JS与图片字体等资源整体约18MB目录结构清晰便于快速定位核心代码、配置文件与数据脚本。项目覆盖员工考勤、部门排班、通知公告等典型OA模块并配套使用文档与数据库文件可直接用于系统演示、二次开发或毕业设计论文撰写参考。目前已有109人学习或下载适合需要完整项目源码和有关资料的高校学生与开发者参考使用。1. 基于 Java SSM 的人事 OA 系统从 class 文件反推出整套设计我拆这份资源的时候第一件事不是看 README而是先看了压缩包里那一串UserExample$GeneratedCriteria.class、AttendanceExample$GeneratedCriteria.class这样的编译产物。看到这些类名基本就能断定这是一个标准的 SSM 分层项目而且持久层用了 MyBatis Generator 自动生成的 Example 查询体系。换句话说这不是随手拼的 CRUD demo而是一套包含用户、部门、考勤、排班、公告、项目六大模块的完整 OA 系统代码结构是能扛住答辩追问的。这份资源适合三类人一是计算机相关专业要做毕业设计或课程设计的学生拿到的是一套能直接跑、能讲清原理的完整源码二是初学 SSM 框架的开发者想找一个真实业务场景来对照学习 Spring、SpringMVC、MyBatis 是怎么协作的三是想快速搭一套人事管理演示系统的从业者改改页面和数据就能当项目初稿。它解决的问题很朴素把考勤记录、排班发布、公告管理、项目进度这些 OA 里最常问的业务用最典型的 SSM 三层架构串起来数据库脚本、使用文档、源码都在一个压缩包里落地成本很低。2. SSM 三大框架的分工与整合顺序先把依赖关系搞明白再动代码拆这种 SSM 项目最容易翻车的地方不是业务代码而是框架整合的配置文件。很多人拿到源码第一件事就是跑结果 Tomcat 一启动就报 bean 创建异常然后开始怀疑人生。其实 SSM 整合有一套固定的依赖顺序理解了这个顺序后面所有报错都能顺着线索查。2.1 三层架构的数据流请求从 Controller 到 Mapper 的完整链路这套人事 OA 系统是典型的 SSM 三层架构表现层是 SpringMVC 的 Controller业务层是 Service 接口加实现类持久层是 MyBatis 的 Mapper 接口加 XML 映射文件。从压缩包的 class 文件名能看出来IndexController、AttendanceExample、DeptScheduleExample这些类分别对应了登录入口、考勤模块、部门排班模块结构非常清晰。一个典型请求的流转过程是这样的浏览器发请求到 TomcatDispatcherServlet 根据RequestMapping找到对应的 Controller 方法Controller 里注入 Service 接口Service 实现类里注入 Mapper 接口Mapper 接口的方法名和 XML 里的select、insert语句绑定。这里注意MyBatis 的 Mapper 接口是只有一个空方法的 Java 接口真正的 SQL 全在 XML 里这就是为什么很多新手在 Controller 里明明调用了方法却总是报Invalid bound statement (not found)——多半是 XML 没被扫描到或者 namespace 写错了。这套项目在业务层做得比较规矩的地方在于每个模块的 Service 接口和实现类是分开的例如考勤模块就是AttendanceService和AttendanceServiceImpl。这样做的好处是答辩的时候你可以直接说我用的是面向接口编程方便后续替换实现类这句话在毕业设计答辩里非常加分。2.2 配置文件加载顺序applicationContext.xml 与 spring-mvc.xml 谁先谁后SSM 整合有四个核心配置文件web.xml、applicationContext.xmlSpring 根容器、spring-mvc.xmlSpringMVC 子容器、mybatis-config.xmlMyBatis 全局配置。加载顺序由web.xml里的配置决定Spring 根容器先启动SpringMVC 子容器后启动子容器可以拿父容器的 bean反过来不行。!-- web.xml 中的关键配置片段 -- context-param param-namecontextConfigLocation/param-name param-valueclasspath:applicationContext.xml/param-value /context-param listener listener-classorg.springframework.web.context.ContextLoaderListener/listener-class /listener servlet servlet-namedispatcherServlet/servlet-name servlet-classorg.springframework.web.servlet.DispatcherServlet/servlet-class init-param param-namecontextConfigLocation/param-name param-valueclasspath:spring-mvc.xml/param-value /init-param load-on-startup1/load-on-startup /servlet逻辑说明ContextLoaderListener负责创建 Spring 根容器加载applicationContext.xml这里面通常放着数据源、SqlSessionFactory、事务管理器、Service 层的 bean。DispatcherServlet 的contextConfigLocation指向spring-mvc.xml里面放着 Controller 扫描、视图解析器、静态资源映射。参数说明load-on-startup的1表示 Tomcat 启动时就初始化 DispatcherServlet如果你是 0 或者不配那要等第一个请求进来才创建容器很多第一次访问特别慢甚至超时的问题就是这个参数引起的。注意一个典型的坑如果spring-mvc.xml里把Service、Repository这些注解也扫了会导致 Service 层的 bean 被创建两次事务注解有时候会失效。常见做法是applicationContext.xml只扫 service 和 daospring-mvc.xml只扫 controller。2.3 mybatis-config.xml 与 Mapper 注册让 XML 映射文件被容器发现MyBatis 的全局配置里最核心的是别名校验、下划线转驼峰、以及 Mapper 文件的位置。很多 SSM 项目跑不起来就是死在这一步。!-- mybatis-config.xml 核心配置 -- configuration settings setting namemapUnderscoreToCamelCase valuetrue/ setting namelogImpl valueSTDOUT_LOGGING/ /settings typeAliases package namecom.example.entity/ /typeAliases /configuration逻辑说明mapUnderscoreToCamelCase设为 true 之后数据库字段dept_name就能自动映射到实体类的deptName属性不用手动写resultMap的每个字段映射这是懒人福音也是很多人忽略了导致查出来全是 null 的元凶。logImpl用STDOUT_LOGGING可以把 SQL 打印到控制台我调试这类项目必开。这里要强调 Mapper 的注册方式。在applicationContext.xml里配置MapperScannerConfigurer时basePackage要填 Mapper 接口所在的包同时 SqlSessionFactoryBean 的mapperLocations要指到 XML 文件的路径bean idsqlSessionFactory classorg.mybatis.spring.SqlSessionFactoryBean property namedataSource refdataSource/ property nameconfigLocation valueclasspath:mybatis-config.xml/ property namemapperLocations valueclasspath:mapper/*.xml/ /bean如果mapperLocations写的是classpath:mapper/*.xml那 XML 必须放在 resources 编译后的 classpath 根目录下。很多 IDEA 用户把 XML 放在了src/main/java目录下面没有在 build 配置里加上资源编译结果运行时 Mapper 接口找到了XML 却不在 classpath 里直接报绑定异常。血泪经验是先看 target/classes 目录里有没有 mapper 文件夹没有就说明资源没编译进去。3. 核心业务模块与数据库设计从 Example 类名反推表结构和业务关系这份资源的 class 文件名相当于项目的目录索引UserExample、DeptExample、AttendanceExample、DeptScheduleExample、UserScheduleExample、ProjectExample、NewsExample对应了七个核心实体。我反推表设计的时候发现模块之间的关联关系完全是照着真实 OA 场景做的不是随便堆几个表。3.1 用户与部门一对多关系与乐观锁字段设计用户表和部门表是这套系统的基础表。用户属于某个部门一个部门下有多个用户这是最典型的一对多。CREATE TABLE t_dept ( id INT PRIMARY KEY AUTO_INCREMENT, dept_name VARCHAR(50) NOT NULL, create_time DATETIME DEFAULT CURRENT_TIMESTAMP ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; CREATE TABLE t_user ( id INT PRIMARY KEY AUTO_INCREMENT, dept_id INT NOT NULL, username VARCHAR(50) NOT NULL UNIQUE, password VARCHAR(64) NOT NULL, real_name VARCHAR(30), role TINYINT DEFAULT 0, version INT DEFAULT 1, CONSTRAINT fk_user_dept FOREIGN KEY (dept_id) REFERENCES t_dept(id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;逻辑说明t_dept是部门表t_user是用户表通过dept_id外键关联。role字段用 TINYINT 区分管理员和普通员工0 是普通员工1 是管理员。version字段是乐观锁标记每次更新用户信息时 version 加 1通过WHERE version #{oldVersion}来防止并发修改覆盖这在答辩时可以讲成我考虑了并发安全。参数说明密码字段建议存VARCHAR(64)因为 MD5 加密输出是 32 位加盐后一般是 40 或 64 位。如果你看到的数据库脚本里密码是明文那记得改一下在 Service 层加一层 MD5 或 SHA-256 的加密这在毕业设计里是安全性的加分项。3.2 考勤模块Attendance 表的状态字段与判定逻辑考勤是 OA 系统里最常被问到的业务模块。从AttendanceExample$GeneratedCriteria.class可以看出这个模块是独立的一张表字段设计上应该包含用户、日期、上班打卡时间、下班打卡时间、考勤状态。CREATE TABLE t_attendance ( id INT PRIMARY KEY AUTO_INCREMENT, user_id INT NOT NULL, work_date DATE NOT NULL, check_in DATETIME, check_out DATETIME, status TINYINT DEFAULT 0, remark VARCHAR(255), UNIQUE KEY uk_user_date (user_id, work_date) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;逻辑说明work_date存日期check_in和check_out存具体的打卡时间。status字段是关键0 正常、1 迟到、2 早退、3 缺卡。这里UNIQUE KEY uk_user_date是核心它保证了同一个用户同一天只能有一条考勤记录程序里插入前先查当天是否已有记录有则执行更新而不是再插一条。异常逻辑的常见实现是假设上班时间是 9 点判断check_in是否晚于当天 9 点如果晚于就更新状态为迟到。这里要注意work_date用 DATE 类型、check_in用 DATETIME比较的时候用TIME(check_in) 09:00:00而不是拿字符串比否则8:59会被错误判定为迟到。3.3 排班模块DeptSchedule 与 UserSchedule 的发布和认领逻辑排班模块分了两张表部门排班DeptSchedule和个人排班UserSchedule这个设计很有意思。部门排班是管理员发布的公共班次个人排班是员工从部门排班中认领或管理员指派后的结果相当于一个是模板一个是实例。CREATE TABLE t_dept_schedule ( id INT PRIMARY KEY AUTO_INCREMENT, dept_id INT NOT NULL, schedule_date DATE NOT NULL, shift_name VARCHAR(20), start_time TIME, end_time TIME, publisher_id INT ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; CREATE TABLE t_user_schedule ( id INT PRIMARY KEY AUTO_INCREMENT, dept_schedule_id INT NOT NULL, user_id INT NOT NULL, status TINYINT DEFAULT 0, UNIQUE KEY uk_schedule_user (dept_schedule_id, user_id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;逻辑说明t_dept_schedule存的是某天某个部门的排班计划例如2025-05-20 早班 08:00-16:00。t_user_schedule是这个计划的执行情况——哪位员工被安排在这个班次。status字段标识是否已确认。这套设计最实用的地方在于拿t_dept_schedule的start_time和考勤表的check_in做比对就能自动算出员工当天是否迟到而不是写死在代码里每天几点上班。我在实际项目里就是这样干的——排班表是考勤判断的依据考勤记录直接关联当天的排班时间改动班次时间不用重编译代码。3.4 公告与项目模块News 和 Project 的 CRUD 权限设计公告和项目的表结构相对简单重点在权限控制。从 class 文件看News 和 Project 都是独立的 Mapper这意味着它们的增删改查都是独立操作。CREATE TABLE t_news ( id INT PRIMARY KEY AUTO_INCREMENT, title VARCHAR(100) NOT NULL, content TEXT, publisher_id INT, publish_time DATETIME DEFAULT CURRENT_TIMESTAMP ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; CREATE TABLE t_project ( id INT PRIMARY KEY AUTO_INCREMENT, project_name VARCHAR(100) NOT NULL, owner_id INT, progress TINYINT DEFAULT 0, deadline DATE, create_time DATETIME DEFAULT CURRENT_TIMESTAMP ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;权限这块常见做法是在 Service 层做判断管理员角色role1可以发布公告、创建项目、修改所有排班普通员工role0只能查看和更新自己的信息。判断逻辑通常在调用 Mapper 之前用当前登录用户的 role 做一次校验而不是把role当成参数传到 SQL 里——后者容易被接口直接调用绕过。4. 数据库脚本导入与 IDEA 本地部署从零到跑通全流程拿到压缩包后最快的验证方式是先不碰代码按导库 → 改配置 → 部署三步走。这套流程我跑了不下几十次把稳定的路径和参数讲清楚。4.1 导入 SQL 并配置数据源连接池参数的几个关键细节压缩包里的数据脚本一般叫oa_system.sql或db_oa.sql直接在 Navicat 或命令行导入即可。导入后确认库名然后改 JDBC 配置。# jdbc.properties jdbc.drivercom.mysql.cj.jdbc.Driver jdbc.urljdbc:mysql://localhost:3306/oa_system?useUnicodetruecharacterEncodingUTF-8serverTimezoneAsia/ShanghaiuseSSLfalse jdbc.usernameroot jdbc.password123456逻辑说明数据库连接池这里用的是 Spring 的DriverManagerDataSource或 dbcp具体看applicationContext.xml里的 bean 定义。characterEncodingUTF-8解决中文乱码serverTimezoneAsia/Shanghai解决 MySQL 8.0 以上的时区报错——如果这里不写时区启动时会直接抛The server time zone value Öйú±ê׼ʱ¼ä is unrecognized排查成本极高。参数说明数据库名要和你本地建的一致密码改成自己的。如果用的是 MySQL 5.7驱动可以换回com.mysql.jdbc.Driver但如果你没换用com.mysql.cj.jdbc.Driver也一样能跑兼容性没问题。4.2 IDEA 配置 TomcatArtifact 与部署上下文的正确姿势这一步是新手重灾区。很多人用 IDEA 的 Community 版没有 Tomcat 集成或者 Artifact 类型选错导致启动后访问 404。# 部署后的访问路径示例 # 上下文路径为 /oa_system 时 http://localhost:8080/oa_system/login # 上下文路径为 / 时 http://localhost:8080/login逻辑说明IDEA 里配置 Tomcat 时Deployment 选项卡里要添加 Artifact。如果是 war exploded 模式Application context 建议先设成/oa_system跑通后再改成/让项目作为根路径访问。改根路径有个风险如果项目里用了${pageContext.request.contextPath}拼静态资源路径那没问题如果是硬编码/oa_system/改成根路径后样式全丢。参数说明服务器端口默认 8080如果被占用可以改成 8081 或 8082改完要记得访问 URL 也同步改。JRE 版本建议用 JDK 8 或 JDK 11SSM 项目用太高版本的 JDK 偶尔会遇到 javassist 或 cglib 兼容问题。4.3 初始化管理员账号登录验证的完整闭环数据脚本里通常会初始化一个管理员账号常见的是admin / admin123或admin / 123456。登录逻辑在IndexController里从 class 文件名看它承担了登录认证和首页跳转的双重职责。// IndexController 中登录验证的核心逻辑 Controller public class IndexController { Autowired private UserService userService; RequestMapping(/login) public String login(String username, String password, HttpSession session, Model model) { User user userService.login(username, password); if (user null) { model.addAttribute(msg, 用户名或密码错误); return login; } session.setAttribute(loginUser, user); return redirect:/index; } }逻辑说明登录成功把用户对象放进 session后续所有页面通过 session 里的loginUser判断是否已登录。注意这里返回的是redirect:/index而不是直接返回视图名这样做的好处是刷新页面时不会重复提交登录表单。参数说明如果登录失败model.addAttribute(msg, ...)把错误信息带到 JSP 页面。JSP 里用${msg}或c:out输出。注意检查密码是否是 MD5 加密后存储的如果是Service 层的login方法里应该有DigestUtils.md5DigestAsHex(password.getBytes())这一步没有的话数据库里的密文没法匹配。5. SSM 毕设项目常见踩坑与排查清单五条最常遇到的报错这类 SSM 项目我前后帮人排查过不少遇到的问题高度重复。列五条最典型的每条按现象 → 原因 → 解决记录对照排查能省很多时间。5.1 启动报 ClassNotFoundException 或 NoClassDefFoundError现象Tomcat 启动时抛java.lang.ClassNotFoundException: org.springframework.web.context.ContextLoaderListener。原因IDEA 里 Artifact 打包时没有把依赖的 jar 包带进 WEB-INF/lib。常见于用 Maven 构建但 Tomcat 部署的是旧的 Artifact或手动导入 jar 的项目漏了依赖目录。解决打开 Project Structure → Artifacts选中输出目录为空的依赖项右键选择 Put into WEB-INF/lib。如果是 Maven 项目先执行mvn clean package重新构建 war再部署。部署前检查target/oa_system/WEB-INF/lib目录下是否有 spring-web、mybatis-spring 等核心 jar。5.2 登录成功后跳转 404现象登录页正常提交账号密码后地址栏变成了/index但页面显示 404控制台无任何异常输出。原因SpringMVC 的视图解析器配了前缀/WEB-INF/views/但 JSP 文件不在此目录下或 DispatcherServlet 的url-pattern配成了/把所有请求包括 JSP 都拦截了。解决先看spring-mvc.xml里的 InternalResourceViewResolver 配置确认前缀目录和实际 JSP 位置一致。再看web.xml里 servlet-mapping如果配了/需要在 spring-mvc.xml 里加mvc:default-servlet-handler/让静态资源和 JSP 能正常访问。5.3 页面上中文全是问号或乱码现象登录后页面显示中文乱码姓名变成????或者数据库里存的中文变成乱码。原因三个层面的编码不统一——JSP 页面编码、数据库连接编码、数据库表编码。最常见的是jdbc:mysql://...没加characterEncodingUTF-8或数据表创建时DEFAULT CHARSET不是utf8mb4。解决三处统一。JSP 顶部加pageEncodingUTF-8JDBC 连接串加useUnicodetruecharacterEncodingUTF-8已建的库表执行ALTER TABLE t_user CONVERT TO CHARACTER SET utf8mb4;修复。乱码问题排查优先级永远是连接串优先因为代码层面的编码问题通常在编译期就暴露了。5.4 上下文路径问题导致静态资源 404现象页面能打开但 CSS、JS、图片全部加载失败F12 看全是 404或者登录后跳转到一个不存在的页面。原因JSP 里用了绝对路径如/static/css/style.css但项目部署的上下文路径不是根路径导致路径拼成了/css/style.css或项目名/static/...对不上。解决统一在 JSP 里用c:url或${pageContext.request.contextPath}拼路径例如${pageContext.request.contextPath}/static/css/style.css。或者干脆把 Tomcat 部署的 Application context 改成/让项目作为根路径运行但注意 5.2 里提到的 DispatcherServlet 拦截问题要一起处理。5.5 Mapper 报 Invalid bound statement (not found)现象调用UserMapper.selectByExample(example)时抛org.apache.ibatis.binding.BindingException: Invalid bound statement (not found)。原因Mapper 接口编译进了 classpath但对应的 XML 映射文件没有。通常是 XML 放在了src/main/java目录下IDEA 默认只编译.java文件XML 没被复制到target/classes。解决在pom.xml的 build 节点加资源编译配置build resources resource directorysrc/main/java/directory includes include**/*.xml/include /includes /resource resource directorysrc/main/resources/directory /resource /resources /build逻辑说明第一个 resource 把src/main/java下的 XML 也打进 classpath第二个 resource 正常编译 resources 目录。配完后重新mvn clean再启动看target/classes下有没有生成 mapper 的 XML 文件。另外也检查一下 XML 里namespace是否和 Mapper 接口全限定名一致这个错更隐蔽因为运行时不会报 namespace 错误只报 statement 找不到。6. 把这份毕设改成自己的逆向工程与二次开发的三个技巧资源里带的使用文档对项目结构和启动流程已经讲得比较细了。当你把整套系统跑通之后下一步就是往里面加自己的东西。这里分享三个我用得最多的改造技巧。第一个技巧是用 MyBatis Generator 重新生成实体和 Example 类。压缩包里已经有UserExample、DeptExample这套东西说明之前就是用 MBG 生成的。你在generatorConfig.xml里改数据库连接和表名重新跑mvn mybatis-generator:generate新的Example类就会覆盖旧文件。生成后注意把selectByExample返回的Criteria对象用起来它是非常灵活的查询构造器createCriteria().andDeptIdEqualTo(3)这样的链式调用能省掉大量手写 SQL答辩时讲这个也很加分。第二个技巧是给考勤模块加一个迟到自动判定。原项目里的判定逻辑通常是写死在 Service 层我一般会在AttendanceServiceImpl里加一个validateCheckIn方法在打卡时调用t_user_schedule和t_dept_schedule拿到当天班次的start_time和当前时间做比对public void handleCheckIn(Integer userId) { Date now new Date(); DeptSchedule schedule deptScheduleMapper.selectTodayByUser(userId); if (schedule ! null now.after(schedule.getStartTime())) { Attendance attendance new Attendance(); attendance.setUserId(userId); attendance.setWorkDate(new java.sql.Date(now.getTime())); attendance.setStatus((byte) 1); // 1 表示迟到 attendanceMapper.insert(attendance); } }逻辑说明selectTodayByUser先查当天该员工被安排的班次拿到startTime后和当前时间比较。这里的时间比较不再依赖字符串而是直接用java.util.Date的after方法避免8:59和09:00字符串比较出错。参数说明状态 1 是迟到如果要区分早退和缺卡可以在打卡接口分别判断。第三个技巧是换连接池。原项目大概率用的 Spring 自带的DriverManagerDataSource开发环境够用但如果你在答辩演示时遇到连续点刷新页面偶发超时那多半就是连接没复用。把数据源换成 Druid只需要在applicationContext.xml改一处 bean 定义bean iddataSource classcom.alibaba.druid.pool.DruidDataSource property namedriverClassName value${jdbc.driver}/ property nameurl value${jdbc.url}/ property nameusername value${jdbc.username}/ property namepassword value${jdbc.password}/ property nameinitialSize value5/ property namemaxActive value20/ /bean这些改造做完项目就不是原封不动的毕设了——表结构是原来的但查询逻辑、业务判断、连接管理都有自己的痕迹。从那以后我拿到任何 SSM 源码都强制自己先走一遍导库 → 看配置依赖 → 改连接串 → 加日志 → 跑通后再动业务的流程因为顺序反了你根本分不清是框架问题还是业务问题。希望这些拆解和踩坑记录帮到你。本文还有配套的精品资源点击获取