简介这是一份面向Java开发者的企业办公OA系统完整项目资料涵盖源代码、讲解视频与数据库脚本适合学习企业级Web开发或准备毕设的读者。项目基于Java技术栈内含工作流、文档管理、任务分配等典型OA模块可直观理解Spring Boot/Spring MVC、MyBatis/JPA等框架在真实项目中的应用。包内共4个文件包括2个mp4讲解视频、1个zip源码工程和1个sql数据库脚本整体约206MB视频带看部署与调试源码结构清晰便于定位功能SQL脚本则展示数据模型与表关系利于二次开发。目前已有312人学习下载。对于中级开发者可结合视频和源码把握OA系统从架构设计到代码实现的完整链路提升企业级开发实战能力。1. 开箱即用的Java OA系统拿到手先验证哪一步很多人下载Java OA系统源码第一反应是把LeyeOA.zip塞进IDEA然后盯着爆红的报错日志发呆。这套基于Java的企业办公OA系统资源包内部结构其实很直白001_video里是两段讲解视频002_code里是可导入的源码工程004_reference里躺着leyeoa.sql数据库脚本。它能省掉的是你从空工程搭一套OA的时间成本工作流、公告、文档管理这些模块有现成代码可以改拿来用在毕业设计、小团队内部系统或者当作spring boot结合mybatis的面试项目讲都很合适。适合两类人一类是Java基础还行、但没见过完整企业项目长什么样的开发者另一类是正在整理java面试题答案、想拿真实系统讲模块设计的候选人。对这个包最反直觉的一点是最快验证它能不能用的动作不是先跑代码而是先把leyeoa.sql干净地导进你的MySQL。数据库这一步立不住后面代码启动得再顺也白搭。2. 项目导入与环境配对JDK、Maven、MySQL的版本搭配与首次启动拿到压缩包先别急着解压双击IDEA。按我拆过几十个Java资源包的习惯第一步永远是摸清楚它的技术栈和运行环境不然环境不匹配后面每一步都是玄学报错。这个包的结构决定了它的启动路径是固定的先建库再导数据然后改配置最后跑代码——顺序反了你在启动日志里看到的问题会比正常情况多一倍。2.1 从资源包结构判断技术栈与打开顺序解压后能看到三层内容001_video放视频002_code放LeyeOA.zip源码工程004_reference放的是leyeoa.sql核心参考脚本。判断技术栈的关键在源码工程里——先解压LeyeOA.zip看根目录有没有pom.xml、有没有src/main/resources/mapper这样的目录结构。LeyeOA ├── pom.xml ├── src/main/java ├── src/main/resources │ ├── application.yml │ ├── mapper/ # 如果有这个目录数据层基本是MyBatis │ └── templates/ # 如果有这个目录前端用的是服务端模板 └── sql我一般会按这个逻辑判断pom.xml里出现spring-boot-starter-web和mybatis-spring-boot-starter就是Spring Boot加MyBatis的组合如果全是spring-boot-starter-data-jpa和Repository接口那是JPA方案。这个包从leyeoa.sql和工程命名看比较接近前一种组合这也符合国内大多数OA系统的落地习惯——MyBatis对复杂报表查询和SQL调优更直接OA里那种多表关联的待办列表用SQL写比JPA的自动查询好控制得多。打开顺序建议是数据库优先配置其次代码最后视频留作对答案。视频文件是01和02两段常见编排是01讲环境搭建、02讲模块实现但不必先看完再动手遇到问题按时间段定位回看效率更高。2.2 数据库初始化leyeoa.sql的导入姿势与验证数据库这步是整套系统的地基。先在MySQL命令行里建库再导入注意字符集一定要指定utf8mb4OA系统里全是中文utf8mb4才能同时覆盖中文、生僻字和表情符号不会出现导入后中文全部变问号的尴尬。# 进入MySQL命令行 mysql -uroot -p # 如果leyeoa.sql里没有CREATE DATABASE语句先手动建库 CREATE DATABASE leyeoa DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; EXIT; # 从命令行导入指定字符集防止乱码 mysql -uroot -p --default-character-setutf8mb4 leyeoa leyeoa.sql参数说明-u指定用户-p表示输入密码--default-character-set控制客户端与脚本传输时的字符集 leyeoa.sql表示把脚本内容重定向给MySQL执行。如果脚本里已经带了CREATE DATABASE手动建库再导入会报库已存在看到这个报错直接跳过建库步骤重导一遍即可。导入完成后做两步验证一是看表数量二是看表名规律USE leyeoa; SHOW TABLES; SELECT COUNT(*) AS table_count FROM information_schema.tables WHERE table_schema leyeoa;表数量能直观反映模块完整度几十张表是正常水平。表名前缀也有规律sys_开头的一般是用户、角色、权限这类系统表oa_开头的多是业务表比如oa_notice是公告、oa_leave是请假申请。看到这种命名习惯后面读代码时定位表就快很多。提示导入前先确认MySQL版本是5.7还是8.x这直接决定后面配置文件里的驱动类名提前确认能少踩一个坑。2.3 配置文件修改与首次启动数据库就绪后改配置文件。源码工程里一般叫application.yml或application.properties重点改数据源这一段server: port: 8080 spring: datasource: url: jdbc:mysql://localhost:3306/leyeoa?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/Shanghai username: root password: 改成你自己的密码 driver-class-name: com.mysql.cj.jdbc.Driver参数说明useUnicode和characterEncoding保证中文读写不乱码serverTimezoneAsia/Shanghai必须加不然MySQL 8和JDBC驱动之间的时区校验会直接报错这是启动失败的重灾区。如果你本地是MySQL 5.7驱动类名要换成com.mysql.jdbc.Driver5.7不认识cj这个新版驱动路径。密码这里不建议包含、#这类特殊字符YAML解析会把后半个值吞掉。配置改完有两种启动方式IDE里直接跑带SpringBootApplication注解的入口类或者命令行打包运行我习惯用命令行方式方便看完整日志mvn clean package -DskipTests java -jar target/leyeoa-0.0.1-SNAPSHOT.jar-DskipTests跳过测试编译可以省一半时间打包重点是看target目录下有没有生成可执行jar。启动日志里出现Tomcat started on port(s): 8080就说明环境通了。如果卡在这一步别急着怀疑代码先回头检查数据库连没连上、密码对不对八成问题出在这两个位置。3. 核心功能模块拆解工作流、权限与文档管理的代码落地系统跑起来只是开始要真正能用它应付简历和面试得把代码拆开看。OA系统看起来功能一大堆拆到底就是三块核心权限怎么控制、审批流怎么走、文档怎么存取。这三块看懂一个整个系统的代码逻辑就能串起来了。3.1 用户-角色-权限模型RBAC表设计与登录拦截OA系统的访问控制九成以上是RBAC模型也就是用户-角色-权限三件套。打开leyeoa.sql看到sys_user、sys_role、sys_user_role这三张表就说明用的是这套。表结构一般长这样CREATE TABLE sys_user ( id BIGINT NOT NULL AUTO_INCREMENT, username VARCHAR(50) NOT NULL COMMENT 登录名, password VARCHAR(100) NOT NULL COMMENT 加密后的密码, real_name VARCHAR(50) COMMENT 真实姓名, dept_id BIGINT COMMENT 部门ID, status TINYINT DEFAULT 1 COMMENT 1启用 0禁用, PRIMARY KEY (id), UNIQUE KEY uk_username (username) ); CREATE TABLE sys_role ( id BIGINT NOT NULL AUTO_INCREMENT, role_name VARCHAR(50) COMMENT 角色名如部门主管, role_key VARCHAR(100) COMMENT 角色标识如dept_manager, PRIMARY KEY (id) ); CREATE TABLE sys_user_role ( user_id BIGINT NOT NULL, role_id BIGINT NOT NULL, PRIMARY KEY (user_id, role_id) );说明sys_user和sys_role是主表sys_user_role是关联表中间表的存在让用户和角色变成多对多关系——一个用户可以有多个角色一个角色也能分配给多个用户。password字段存的是加密后的密文不要试图在数据库里直接改密码明文项目里一般会有MD5加盐或者BCrypt的工具类。权限控制的落地代码通常在拦截器里这是java面试时最常被追问的点。核心逻辑是请求进来先判断要不要登录要不要权限校验Component public class LoginInterceptor implements HandlerInterceptor { // 不需要登录就能访问的路径登录页、验证码、静态资源 private final ListString excludePaths Arrays.asList(/login, /captcha, /static/, /error); Override public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception { String uri request.getRequestURI(); // 白名单路径直接放行 if (excludePaths.stream().anyMatch(uri::startsWith)) { return true; } // 登录态校验session里没有userId就返回401 Object userId request.getSession().getAttribute(userId); if (userId null) { response.setStatus(401); return false; } return true; } }说明preHandle执行顺序在Controller方法之前返回值false时请求被拦断。excludePaths是白名单用startsWith匹配前缀登录态存在HttpSession里session里没有userId就视为未登录。真实项目会在这一步继续查角色、查按钮权限但骨架就是这段代码。这里拦截器的另一个价值是兜底配合前端权限控制避免有人绕过页面直接调接口。3.2 工作流引擎为什么小项目别急着上Activiti审批流是OA的灵魂商业产品比如泛微OA这类系统核心卖点就是图形化流程建模。我见过不少Java开发者一听说OA就打算上Activiti结果被流程部署、办理人解析、历史归档一堆概念绕晕。填这类的坑填多了以后我的结论是小项目优先用字段驱动状态机简单、可控且数据库里改几行就能跑。状态机的思路用Java表达就是定义状态流转规则比如请假审批四个状态public class LeaveProcess { // 状态0草稿 1待部门审批 2待人事审批 3已通过 4已驳回 private Integer status; // 当前处理人生成待办列表时用 private String currentAssignee; // 提交申请只有草稿状态能发起 public void submit(String applicant) { if (status ! 0) { throw new IllegalStateException(草稿状态才能提交); } this.status 1; this.currentAssignee dept_manager; } // 审批动作通过则推进一档驳回则直接结束 public void approve(boolean passed, String operator) { if (passed) { if (status 1) { this.status 2; this.currentAssignee hr_manager; } else if (status 2) { this.status 3; this.currentAssignee null; } } else { this.status 4; this.currentAssignee null; } } }说明status作为数据库里的int字段每次审批就是一次updatecurrentAssignee用来支撑「我的待办」查询。非法状态用IllegalStateException兜底比静默失败好排查。状态机和Activiti的边界在于流程要频繁调整、需要版本回退、要支持会签和并行网关时再上Activiti或Flowable这种工作流引擎固定模板式的审批状态机完全够用这也是很多中小企业OA的真实状态。3.3 文档管理文件上传下载的通用写法文档管理模块的代码套路非常固定看过一次就能迁移到任何项目。核心是Controller接收MultipartFile、重命名存储、数据库记录元信息RestController RequestMapping(/doc) public class DocController { Value(${doc.upload-path:./upload}) private String uploadPath; PostMapping(/upload) public Result upload(RequestParam(file) MultipartFile file) { if (file.isEmpty()) { return Result.error(上传文件不能为空); } String originalFilename file.getOriginalFilename(); String ext ; if (originalFilename ! null originalFilename.contains(.)) { ext originalFilename.substring(originalFilename.lastIndexOf(.)); } // 只放行常见办公文档类型防止上传可执行文件 ListString allow Arrays.asList(.docx, .xlsx, .pdf, .png, .jpg, .txt); if (!allow.contains(ext.toLowerCase())) { return Result.error(不支持的文件类型); } // UUID重命名避免同名文件互相覆盖 String storedName UUID.randomUUID().toString().replace(-, ) ext; File dest new File(uploadPath, storedName); try { file.transferTo(dest); // 数据库记录原始文件名、存储名、大小、上传人ID、上传时间 return Result.success(storedName); } catch (IOException e) { return Result.error(保存文件失败); } } }说明RequestParam(file)对应前端表单里input的name属性UUID重命名是关键设计原文件名叫「年度计划.docx」还是叫「报告.docx」都无所谓磁盘上存的是无意义的哈希串避免两个同名文件互相覆盖扩展名白名单是安全底线防止有人传jsp或exe上去。uploadPath用Value注入写在application.yml里改路径不用重新编译。下载时注意响应头里Content-Disposition的filename要用URLEncoder编码否则下载下来的文件名中文会乱码。4. 避坑指南部署与调试中最常见的五个翻车现场这个包我帮人远程排查过多次也自己在不同机器上复现过。下面五条按「现象→原因→解决」排列每一条都是真实发生过的不是理论推演。踩完这套坑你在这个项目上的排错能力基本就到位了。4.1 导入IDEA后pom.xml一片红依赖全部加载失败现象Maven项目导入后pom文件波浪线爆红右键刷新也没用跑启动类直接报ClassNotFoundException。原因大部分情况是JDK版本和项目基线不匹配。老一点的Spring Boot项目按Java 8写的你本地装的是Java 17或21编译符合性直接崩另一类原因是Maven仓库里没拉下依赖网络问题或镜像没配。解决Project Structure里把SDK切到Java 8pom.xml里如果写死了java.version1.8本地必须装对应JDK然后检查Maven settings.xml配置阿里云镜像源重新执行mvn clean compile强制拉依赖。这两步做完绝大部分红叉自动消失。4.2 导入leyeoa.sql后中文全部变成问号现象数据导进去了页面上所有中文名称显示为?????数据库里直接SELECT出来也是问号。原因终端或命令行客户端默认用了latin1字符集连接MySQL建库时也没指定字符集表默认继承库的latin1编码。导入这一步之前所有环节但凡有一个没带utf8mb4中文就会在传输过程中被错误转码。解决把库、表、连接三层全部统一成utf8mb4。重建库时用CREATE DATABASE leyeoa DEFAULT CHARACTER SET utf8mb4导入命令必须带--default-character-setutf8mb4URL连接串里带上characterEncodingutf8。这三处对齐后重新导入一次中文就正常了。4.3 启动报端口被占用Address already in use现象第二次启动时报BindException: Address already in use明显是上一个没关干净或者同机其他程序占了8080。原因IDEA里之前启动的Java进程没有终止或者本机装了其他占用8080的服务常见的比如Jenkins、Nacos甚至某些游戏的调试端口。解决Windows下用netstat -ano | findstr 8080查占用的PID然后taskkill /F /PID 对应的进程号更省事的办法是改application.yml里的端口比如server.port: 8081。改端口是正规解法不要觉得改端口丢人一台机器跑多个Java服务本来就应该各自占端口。4.4 审批通过了但流程状态字段没变现象页面点了「通过」按钮报操作成功但刷新后状态还是「待审批」数据库里status也是旧值。原因大概率是事务没生效或者后端update语句的where条件没匹配到数据。常见翻车点有三个Service方法没加Transactional异常被吞了update语句里where条件带了错误的状态值比如用status2去更新本来就该是status1的数据前端传的参数名和后端接收的字段名对不上导致状态字段没被赋值。解决打开控制台SQL日志MyBatis场景在application.yml里加logging.level.你的mapper包名DEBUG看真实执行的update语句和参数。确认where条件里的status值和数据库当前值一致再检查Service类上有没有Transactional如果Spring代理没生效事务配置写在配置类里检查是不是被final方法给挡了。4.5 给表加了个字段查询直接报Unknown column现象按需求在oa_notice表加了start_time字段启动后列表接口报错Unknown column start_time in field list但数据库里明明有这一列。原因MyBatis的resultMap写死了列名映射或者实体类根本没有这个字段。数据库改了结构Java代码和Mapper没同步这是数据库结构修改后最常见的连锁反应。你没有走数据库表创建、实体、Mapper映射、前端展示这条完整的链路查到一半自然断了。解决三层同步。数据库执行ALTER TABLE oa_notice ADD COLUMN start_time DATETIME实体类加上private Date startTime字段Mapper的resultMap里补上 如果用了map-underscore-to-camel-case自动驼峰映射实体字段小写即可。改完重启确认MyBatis映射成功这一条是java开发和数据库增删改查配合度最高的踩坑点。5. 二次开发验证改一个公告时间筛选检验自己真读懂了看懂别人的代码和能改别人的代码是两回事。建议用「公告模块加一个发布时间范围筛选」这个小需求来验证自己是否吃透了这个OA系统这也是企业内部最常被提起的改动。改动链路横跨SQL、Mapper、Service三层能跑通就说明模块关系理清了。先在公告的Mapper XML里给列表查询加两个可选参数select idselectNoticeList resultTypeNotice SELECT * FROM oa_notice WHERE 1 1 if testbeginTime ! null and beginTime ! AND create_time gt; #{beginTime} /if if testendTime ! null and endTime ! AND create_time lt; #{endTime} /if ORDER BY create_time DESC /select说明 是MyBatis的动态SQLbeginTime为空时不拼接条件达到「可选筛选」的效果和是XML里对和的转义写法直接写会解析报错。ORDER BY create_time DESC就是Java项目里最常见的排序写法OA列表几乎都是按时间倒序。Service层接收前端传来的两个参数拼进查询条件前端加两个日期选择框就够了。然后对照001_video里两段讲解视频完整复现一遍流程第一段大概率是环境搭建和数据库初始化第二段才是模块讲解。复现时强制自己不看视频先动手卡住了再定位到对应时间段。我第一次拆这套系统时贪快跳过视频里数据库初始化的段落直接导数据结果字符集问题折腾了一下午最后回头发现就是少了--default-character-setutf8mb4这一个参数。从那以后我每次拿到别人给的源码包都强制自己先跑通leyeoa.sql再碰业务代码跑通数据库才允许自己看视频——顺序不乱返工就少。这套纪律帮我省下的排错时间远比我当年省下的半小时值钱。希望帮到你。本文还有配套的精品资源点击获取 
长河君 · 2026/10/5 2:51:30 · 阅读 1.2k Java OA系统二次开发指南：环境搭建、角色权限与工作流实战拆解
简介这是一份面向Java开发者的企业办公OA系统完整项目资料涵盖源代码、讲解视频与数据库脚本适合学习企业级Web开发或准备毕设的读者。项目基于Java技术栈内含工作流、文档管理、任务分配等典型OA模块可直观理解Spring Boot/Spring MVC、MyBatis/JPA等框架在真实项目中的应用。包内共4个文件包括2个mp4讲解视频、1个zip源码工程和1个sql数据库脚本整体约206MB视频带看部署与调试源码结构清晰便于定位功能SQL脚本则展示数据模型与表关系利于二次开发。目前已有312人学习下载。对于中级开发者可结合视频和源码把握OA系统从架构设计到代码实现的完整链路提升企业级开发实战能力。1. 开箱即用的Java OA系统拿到手先验证哪一步很多人下载Java OA系统源码第一反应是把LeyeOA.zip塞进IDEA然后盯着爆红的报错日志发呆。这套基于Java的企业办公OA系统资源包内部结构其实很直白001_video里是两段讲解视频002_code里是可导入的源码工程004_reference里躺着leyeoa.sql数据库脚本。它能省掉的是你从空工程搭一套OA的时间成本工作流、公告、文档管理这些模块有现成代码可以改拿来用在毕业设计、小团队内部系统或者当作spring boot结合mybatis的面试项目讲都很合适。适合两类人一类是Java基础还行、但没见过完整企业项目长什么样的开发者另一类是正在整理java面试题答案、想拿真实系统讲模块设计的候选人。对这个包最反直觉的一点是最快验证它能不能用的动作不是先跑代码而是先把leyeoa.sql干净地导进你的MySQL。数据库这一步立不住后面代码启动得再顺也白搭。2. 项目导入与环境配对JDK、Maven、MySQL的版本搭配与首次启动拿到压缩包先别急着解压双击IDEA。按我拆过几十个Java资源包的习惯第一步永远是摸清楚它的技术栈和运行环境不然环境不匹配后面每一步都是玄学报错。这个包的结构决定了它的启动路径是固定的先建库再导数据然后改配置最后跑代码——顺序反了你在启动日志里看到的问题会比正常情况多一倍。2.1 从资源包结构判断技术栈与打开顺序解压后能看到三层内容001_video放视频002_code放LeyeOA.zip源码工程004_reference放的是leyeoa.sql核心参考脚本。判断技术栈的关键在源码工程里——先解压LeyeOA.zip看根目录有没有pom.xml、有没有src/main/resources/mapper这样的目录结构。LeyeOA ├── pom.xml ├── src/main/java ├── src/main/resources │ ├── application.yml │ ├── mapper/ # 如果有这个目录数据层基本是MyBatis │ └── templates/ # 如果有这个目录前端用的是服务端模板 └── sql我一般会按这个逻辑判断pom.xml里出现spring-boot-starter-web和mybatis-spring-boot-starter就是Spring Boot加MyBatis的组合如果全是spring-boot-starter-data-jpa和Repository接口那是JPA方案。这个包从leyeoa.sql和工程命名看比较接近前一种组合这也符合国内大多数OA系统的落地习惯——MyBatis对复杂报表查询和SQL调优更直接OA里那种多表关联的待办列表用SQL写比JPA的自动查询好控制得多。打开顺序建议是数据库优先配置其次代码最后视频留作对答案。视频文件是01和02两段常见编排是01讲环境搭建、02讲模块实现但不必先看完再动手遇到问题按时间段定位回看效率更高。2.2 数据库初始化leyeoa.sql的导入姿势与验证数据库这步是整套系统的地基。先在MySQL命令行里建库再导入注意字符集一定要指定utf8mb4OA系统里全是中文utf8mb4才能同时覆盖中文、生僻字和表情符号不会出现导入后中文全部变问号的尴尬。# 进入MySQL命令行 mysql -uroot -p # 如果leyeoa.sql里没有CREATE DATABASE语句先手动建库 CREATE DATABASE leyeoa DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; EXIT; # 从命令行导入指定字符集防止乱码 mysql -uroot -p --default-character-setutf8mb4 leyeoa leyeoa.sql参数说明-u指定用户-p表示输入密码--default-character-set控制客户端与脚本传输时的字符集 leyeoa.sql表示把脚本内容重定向给MySQL执行。如果脚本里已经带了CREATE DATABASE手动建库再导入会报库已存在看到这个报错直接跳过建库步骤重导一遍即可。导入完成后做两步验证一是看表数量二是看表名规律USE leyeoa; SHOW TABLES; SELECT COUNT(*) AS table_count FROM information_schema.tables WHERE table_schema leyeoa;表数量能直观反映模块完整度几十张表是正常水平。表名前缀也有规律sys_开头的一般是用户、角色、权限这类系统表oa_开头的多是业务表比如oa_notice是公告、oa_leave是请假申请。看到这种命名习惯后面读代码时定位表就快很多。提示导入前先确认MySQL版本是5.7还是8.x这直接决定后面配置文件里的驱动类名提前确认能少踩一个坑。2.3 配置文件修改与首次启动数据库就绪后改配置文件。源码工程里一般叫application.yml或application.properties重点改数据源这一段server: port: 8080 spring: datasource: url: jdbc:mysql://localhost:3306/leyeoa?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/Shanghai username: root password: 改成你自己的密码 driver-class-name: com.mysql.cj.jdbc.Driver参数说明useUnicode和characterEncoding保证中文读写不乱码serverTimezoneAsia/Shanghai必须加不然MySQL 8和JDBC驱动之间的时区校验会直接报错这是启动失败的重灾区。如果你本地是MySQL 5.7驱动类名要换成com.mysql.jdbc.Driver5.7不认识cj这个新版驱动路径。密码这里不建议包含、#这类特殊字符YAML解析会把后半个值吞掉。配置改完有两种启动方式IDE里直接跑带SpringBootApplication注解的入口类或者命令行打包运行我习惯用命令行方式方便看完整日志mvn clean package -DskipTests java -jar target/leyeoa-0.0.1-SNAPSHOT.jar-DskipTests跳过测试编译可以省一半时间打包重点是看target目录下有没有生成可执行jar。启动日志里出现Tomcat started on port(s): 8080就说明环境通了。如果卡在这一步别急着怀疑代码先回头检查数据库连没连上、密码对不对八成问题出在这两个位置。3. 核心功能模块拆解工作流、权限与文档管理的代码落地系统跑起来只是开始要真正能用它应付简历和面试得把代码拆开看。OA系统看起来功能一大堆拆到底就是三块核心权限怎么控制、审批流怎么走、文档怎么存取。这三块看懂一个整个系统的代码逻辑就能串起来了。3.1 用户-角色-权限模型RBAC表设计与登录拦截OA系统的访问控制九成以上是RBAC模型也就是用户-角色-权限三件套。打开leyeoa.sql看到sys_user、sys_role、sys_user_role这三张表就说明用的是这套。表结构一般长这样CREATE TABLE sys_user ( id BIGINT NOT NULL AUTO_INCREMENT, username VARCHAR(50) NOT NULL COMMENT 登录名, password VARCHAR(100) NOT NULL COMMENT 加密后的密码, real_name VARCHAR(50) COMMENT 真实姓名, dept_id BIGINT COMMENT 部门ID, status TINYINT DEFAULT 1 COMMENT 1启用 0禁用, PRIMARY KEY (id), UNIQUE KEY uk_username (username) ); CREATE TABLE sys_role ( id BIGINT NOT NULL AUTO_INCREMENT, role_name VARCHAR(50) COMMENT 角色名如部门主管, role_key VARCHAR(100) COMMENT 角色标识如dept_manager, PRIMARY KEY (id) ); CREATE TABLE sys_user_role ( user_id BIGINT NOT NULL, role_id BIGINT NOT NULL, PRIMARY KEY (user_id, role_id) );说明sys_user和sys_role是主表sys_user_role是关联表中间表的存在让用户和角色变成多对多关系——一个用户可以有多个角色一个角色也能分配给多个用户。password字段存的是加密后的密文不要试图在数据库里直接改密码明文项目里一般会有MD5加盐或者BCrypt的工具类。权限控制的落地代码通常在拦截器里这是java面试时最常被追问的点。核心逻辑是请求进来先判断要不要登录要不要权限校验Component public class LoginInterceptor implements HandlerInterceptor { // 不需要登录就能访问的路径登录页、验证码、静态资源 private final ListString excludePaths Arrays.asList(/login, /captcha, /static/, /error); Override public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception { String uri request.getRequestURI(); // 白名单路径直接放行 if (excludePaths.stream().anyMatch(uri::startsWith)) { return true; } // 登录态校验session里没有userId就返回401 Object userId request.getSession().getAttribute(userId); if (userId null) { response.setStatus(401); return false; } return true; } }说明preHandle执行顺序在Controller方法之前返回值false时请求被拦断。excludePaths是白名单用startsWith匹配前缀登录态存在HttpSession里session里没有userId就视为未登录。真实项目会在这一步继续查角色、查按钮权限但骨架就是这段代码。这里拦截器的另一个价值是兜底配合前端权限控制避免有人绕过页面直接调接口。3.2 工作流引擎为什么小项目别急着上Activiti审批流是OA的灵魂商业产品比如泛微OA这类系统核心卖点就是图形化流程建模。我见过不少Java开发者一听说OA就打算上Activiti结果被流程部署、办理人解析、历史归档一堆概念绕晕。填这类的坑填多了以后我的结论是小项目优先用字段驱动状态机简单、可控且数据库里改几行就能跑。状态机的思路用Java表达就是定义状态流转规则比如请假审批四个状态public class LeaveProcess { // 状态0草稿 1待部门审批 2待人事审批 3已通过 4已驳回 private Integer status; // 当前处理人生成待办列表时用 private String currentAssignee; // 提交申请只有草稿状态能发起 public void submit(String applicant) { if (status ! 0) { throw new IllegalStateException(草稿状态才能提交); } this.status 1; this.currentAssignee dept_manager; } // 审批动作通过则推进一档驳回则直接结束 public void approve(boolean passed, String operator) { if (passed) { if (status 1) { this.status 2; this.currentAssignee hr_manager; } else if (status 2) { this.status 3; this.currentAssignee null; } } else { this.status 4; this.currentAssignee null; } } }说明status作为数据库里的int字段每次审批就是一次updatecurrentAssignee用来支撑「我的待办」查询。非法状态用IllegalStateException兜底比静默失败好排查。状态机和Activiti的边界在于流程要频繁调整、需要版本回退、要支持会签和并行网关时再上Activiti或Flowable这种工作流引擎固定模板式的审批状态机完全够用这也是很多中小企业OA的真实状态。3.3 文档管理文件上传下载的通用写法文档管理模块的代码套路非常固定看过一次就能迁移到任何项目。核心是Controller接收MultipartFile、重命名存储、数据库记录元信息RestController RequestMapping(/doc) public class DocController { Value(${doc.upload-path:./upload}) private String uploadPath; PostMapping(/upload) public Result upload(RequestParam(file) MultipartFile file) { if (file.isEmpty()) { return Result.error(上传文件不能为空); } String originalFilename file.getOriginalFilename(); String ext ; if (originalFilename ! null originalFilename.contains(.)) { ext originalFilename.substring(originalFilename.lastIndexOf(.)); } // 只放行常见办公文档类型防止上传可执行文件 ListString allow Arrays.asList(.docx, .xlsx, .pdf, .png, .jpg, .txt); if (!allow.contains(ext.toLowerCase())) { return Result.error(不支持的文件类型); } // UUID重命名避免同名文件互相覆盖 String storedName UUID.randomUUID().toString().replace(-, ) ext; File dest new File(uploadPath, storedName); try { file.transferTo(dest); // 数据库记录原始文件名、存储名、大小、上传人ID、上传时间 return Result.success(storedName); } catch (IOException e) { return Result.error(保存文件失败); } } }说明RequestParam(file)对应前端表单里input的name属性UUID重命名是关键设计原文件名叫「年度计划.docx」还是叫「报告.docx」都无所谓磁盘上存的是无意义的哈希串避免两个同名文件互相覆盖扩展名白名单是安全底线防止有人传jsp或exe上去。uploadPath用Value注入写在application.yml里改路径不用重新编译。下载时注意响应头里Content-Disposition的filename要用URLEncoder编码否则下载下来的文件名中文会乱码。4. 避坑指南部署与调试中最常见的五个翻车现场这个包我帮人远程排查过多次也自己在不同机器上复现过。下面五条按「现象→原因→解决」排列每一条都是真实发生过的不是理论推演。踩完这套坑你在这个项目上的排错能力基本就到位了。4.1 导入IDEA后pom.xml一片红依赖全部加载失败现象Maven项目导入后pom文件波浪线爆红右键刷新也没用跑启动类直接报ClassNotFoundException。原因大部分情况是JDK版本和项目基线不匹配。老一点的Spring Boot项目按Java 8写的你本地装的是Java 17或21编译符合性直接崩另一类原因是Maven仓库里没拉下依赖网络问题或镜像没配。解决Project Structure里把SDK切到Java 8pom.xml里如果写死了java.version1.8本地必须装对应JDK然后检查Maven settings.xml配置阿里云镜像源重新执行mvn clean compile强制拉依赖。这两步做完绝大部分红叉自动消失。4.2 导入leyeoa.sql后中文全部变成问号现象数据导进去了页面上所有中文名称显示为?????数据库里直接SELECT出来也是问号。原因终端或命令行客户端默认用了latin1字符集连接MySQL建库时也没指定字符集表默认继承库的latin1编码。导入这一步之前所有环节但凡有一个没带utf8mb4中文就会在传输过程中被错误转码。解决把库、表、连接三层全部统一成utf8mb4。重建库时用CREATE DATABASE leyeoa DEFAULT CHARACTER SET utf8mb4导入命令必须带--default-character-setutf8mb4URL连接串里带上characterEncodingutf8。这三处对齐后重新导入一次中文就正常了。4.3 启动报端口被占用Address already in use现象第二次启动时报BindException: Address already in use明显是上一个没关干净或者同机其他程序占了8080。原因IDEA里之前启动的Java进程没有终止或者本机装了其他占用8080的服务常见的比如Jenkins、Nacos甚至某些游戏的调试端口。解决Windows下用netstat -ano | findstr 8080查占用的PID然后taskkill /F /PID 对应的进程号更省事的办法是改application.yml里的端口比如server.port: 8081。改端口是正规解法不要觉得改端口丢人一台机器跑多个Java服务本来就应该各自占端口。4.4 审批通过了但流程状态字段没变现象页面点了「通过」按钮报操作成功但刷新后状态还是「待审批」数据库里status也是旧值。原因大概率是事务没生效或者后端update语句的where条件没匹配到数据。常见翻车点有三个Service方法没加Transactional异常被吞了update语句里where条件带了错误的状态值比如用status2去更新本来就该是status1的数据前端传的参数名和后端接收的字段名对不上导致状态字段没被赋值。解决打开控制台SQL日志MyBatis场景在application.yml里加logging.level.你的mapper包名DEBUG看真实执行的update语句和参数。确认where条件里的status值和数据库当前值一致再检查Service类上有没有Transactional如果Spring代理没生效事务配置写在配置类里检查是不是被final方法给挡了。4.5 给表加了个字段查询直接报Unknown column现象按需求在oa_notice表加了start_time字段启动后列表接口报错Unknown column start_time in field list但数据库里明明有这一列。原因MyBatis的resultMap写死了列名映射或者实体类根本没有这个字段。数据库改了结构Java代码和Mapper没同步这是数据库结构修改后最常见的连锁反应。你没有走数据库表创建、实体、Mapper映射、前端展示这条完整的链路查到一半自然断了。解决三层同步。数据库执行ALTER TABLE oa_notice ADD COLUMN start_time DATETIME实体类加上private Date startTime字段Mapper的resultMap里补上 如果用了map-underscore-to-camel-case自动驼峰映射实体字段小写即可。改完重启确认MyBatis映射成功这一条是java开发和数据库增删改查配合度最高的踩坑点。5. 二次开发验证改一个公告时间筛选检验自己真读懂了看懂别人的代码和能改别人的代码是两回事。建议用「公告模块加一个发布时间范围筛选」这个小需求来验证自己是否吃透了这个OA系统这也是企业内部最常被提起的改动。改动链路横跨SQL、Mapper、Service三层能跑通就说明模块关系理清了。先在公告的Mapper XML里给列表查询加两个可选参数select idselectNoticeList resultTypeNotice SELECT * FROM oa_notice WHERE 1 1 if testbeginTime ! null and beginTime ! AND create_time gt; #{beginTime} /if if testendTime ! null and endTime ! AND create_time lt; #{endTime} /if ORDER BY create_time DESC /select说明 是MyBatis的动态SQLbeginTime为空时不拼接条件达到「可选筛选」的效果和是XML里对和的转义写法直接写会解析报错。ORDER BY create_time DESC就是Java项目里最常见的排序写法OA列表几乎都是按时间倒序。Service层接收前端传来的两个参数拼进查询条件前端加两个日期选择框就够了。然后对照001_video里两段讲解视频完整复现一遍流程第一段大概率是环境搭建和数据库初始化第二段才是模块讲解。复现时强制自己不看视频先动手卡住了再定位到对应时间段。我第一次拆这套系统时贪快跳过视频里数据库初始化的段落直接导数据结果字符集问题折腾了一下午最后回头发现就是少了--default-character-setutf8mb4这一个参数。从那以后我每次拿到别人给的源码包都强制自己先跑通leyeoa.sql再碰业务代码跑通数据库才允许自己看视频——顺序不乱返工就少。这套纪律帮我省下的排错时间远比我当年省下的半小时值钱。希望帮到你。本文还有配套的精品资源点击获取