开源OA源码实战：可视化审批流程设计与部署避坑指南

简介这套OA系统源码提供完整的企业级解决方案核心亮点在于用户可自行设计审批流程适合需要根据内部管理需求定制审批逻辑的开发者或企业团队。资源总计两千个文件以C#代码和ASP.NET页面为主辅以图片素材、JavaScript脚本及CSS样式等前端资源压缩包大小43.54MB目录结构涵盖移动端、Web端、数据库工具库、业务逻辑层及公共模块。已有6929人学习下载源码从数据库交互到业务规则均清晰分层便于开发者理解整个系统的架构设计尤其能掌握审批流程从表单提交、规则配置到状态流转的实现方式并可直接扩展文档管理、任务分配等日常办公功能。对于希望快速搭建或二次开发办公自动化系统的技术人员这是一份具有实践参考价值的完整源码包。1. 选OA源码之前先问一句审批流程能不能自己画市面上能跑的OA系统源码不少但多数所谓的“开源”OA流程是写死在代码里的。想加一个“部门经理先审、财务再核、总经理终审”的环节得改Java类、改数据库表结构、重新编译部署审批流变成了一场开发灾难。这套源码的核心卖点不在界面有多漂亮而在“可自己设计审批流程”——流程节点、审批人、条件分支都通过可视化设计器配置存成JSON审批时动态解析改流程不用动代码。它适合手里有明确审批场景、不想被固定流程锁死、又愿意花半天时间自己部署一套系统的从业者。下面我会把源码结构、启动步骤、流程设计器原理、生产环境部署和常见坑一次讲透。2. 源码拆开看从表结构到BPM引擎的代码地图2.1 技术栈与选型理由这类自带流程设计器的OA系统主流技术栈是Java系Spring Boot做后端骨架MyBatis操作数据库MySQL存业务和流程数据前端用Vue Element UI做管理界面流程设计器部分用原生JS或vis.js实现拖拽。选这套组合不是偶然Spring Boot的自动配置能省掉大量XML配置MyBatis写复杂审批查询时比JPA更直接Vue的组件化开发正好匹配流程设计器这种“节点连线”的高交互场景。我拆过的几套同类源码里数据库一般分两类表一类是组织权限表user、role、department、menu一类是流程引擎表flow_definition、flow_node、flow_instance、flow_task。前者管“谁能登录、能看什么菜单”后者管“审批流怎么定义、跑到哪一步了”。理解这两类表的界限很重要二次开发时最怕在组织表里塞流程字段或者在流程表里硬关联部门结构。2.2 核心模块与代码地图打开源码目录重点关注这几个包com.xxx.oa ├── controller # 接口层审批发起、审批通过、流程设计器保存 ├── service # 业务层流程解析、节点跳转、任务分配 ├── mapper # MyBatis数据层流程定义、实例、任务查询 ├── model # 实体类FlowDefinition、FlowNode、FlowTask ├── flow # 流程引擎核心解析JSON、执行节点流转 └── config # 全局配置拦截器、权限校验、数据源flow这个包是整个系统的核心通常包含三块逻辑流程定义解析器读JSON把节点和连线转成对象图、节点执行器按类型分发到审批节点、条件节点、抄送节点、任务分配器根据审批人配置决定下一任审批人是谁。如果你下载的源码没有独立的flow包那多半是把流程逻辑塞在service层里这种结构后期改起来会很吃力。2.3 流程引擎的表结构设计流程相关表是最值得先读的因为设计器画的每一张图最终都落到这几张表里表名作用关键字段flow_definition流程定义表id、flow_name、flow_json、statusflow_node流程节点表id、definition_id、node_type、approver_type、condition_exprflow_instance流程实例表id、definition_id、business_key、current_node、statusflow_task任务表id、instance_id、node_id、assignee、approve_result、commentflow_definition.flow_json存的是设计器保存的完整JSON包括所有节点的坐标、属性、连线关系flow_node和flow_task才是审批运行时真正查询的表。设计器点保存时前端把画布JSON提交到/flow/definition/save后端解析后拆分写入flow_node这张表是流程引擎的判断依据。3. 把源码跑起来建库、改参数、登录第一笔审批3.1 准备环境与数据库初始化先确认本机环境JDK 1.8、Maven 3.6、MySQL 5.7。这套源码依赖不算新JDK 8完全够不建议直接上JDK 17有些老版本依赖在JDK 17下会报模块访问错误。# 创建数据库注意字符集 CREATE DATABASE oa_system DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; # 导入数据库脚本一般在 sql/ 目录下 mysql -uroot -p oa_system sql/oa_init.sql;导入脚本常见有两个文件oa_init.sql是表结构oa_data.sql是初始数据。注意不要只导前者不导后者否则登录时账号都不存在。我习惯先看一遍oa_data.sql里的admin账号和初始菜单确认密码是明文还是MD5加密——如果是MD5拿初始化账号登录后第一件事就是改密码。3.2 修改配置并启动服务改配置是第一个容易翻车的地方核心配置都在application.ymlserver: port: 8080 spring: datasource: url: jdbc:mysql://localhost:3306/oa_system?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/Shanghai username: root password: your_password driver-class-name: com.mysql.cj.jdbc.Driver mybatis: mapper-locations: classpath:mapper/*.xml type-aliases-package: com.xxx.oa.model提示serverTimezone必须显式声明很多OA系统部署后报时区错误或日期差8小时就是少了这一项。MySQL 8.0以下用com.mysql.jdbc.Driver8.0及以上用com.mysql.cj.jdbc.Driver驱动类写错会在启动时直接抛ClassNotFoundException。# 启动后端服务 mvn spring-boot:run启动日志出现Started Application in xx seconds基本就成了。前端部分如果是Vue项目进入frontend目录执行npm install npm run dev浏览器访问http://localhost:8080。如果前端是纯静态页面直接放到src/main/resources/static下访问即可省去Node环境。3.3 登录后先验证两条主链路登录成功后不要急着到处乱点先走两条链路一条是“新建审批→选择流程→填写表单→提交”确认流程实例能创建另一条是“审批中心→通过/驳回→查看流程走向”确认节点能流转。这两条链路通了说明流程引擎整体可用。如果第一条就失败优先看flow_instance表有没有插入记录第二条失败看flow_task表的assignee字段是否正确分配给了当前登录人。4. 流程设计器核心原理JSON驱动的审批流是怎么落地的4.1 流程定义的数据结构流程设计器是这套源码最值得研究的部分它的核心数据结构是把画布上的节点和连线序列化成一个JSON对象{ flowName: 请假审批流程, nodes: [ { id: node_start, type: start, name: 开始, next: node_1 }, { id: node_1, type: approval, name: 部门经理审批, approverType: role, approverValue: dept_manager, next: node_2 }, { id: node_2, type: condition, name: 请假天数判断, conditionExpr: ${days} 3, next: node_3, otherwise: node_end }, { id: node_3, type: approval, name: 总经理审批, approverType: user, approverValue: 10001, next: node_end }, { id: node_end, type: end, name: 结束 } ] }这个JSON的核心在设计意图nodes数组定义了所有节点type决定节点类型next指向下一个节点IDconditionExpr是条件分支的表达式。保存流程时后端拿到这个JSON后做两件事——把整体JSON写入flow_definition.flow_json做备份同时解析每个节点写入flow_node表供运行时查询。4.2 审批人、条件分支与会签的实现方式审批人配置是这个设计器是否好用的分水岭。常见的有三种指定用户写死user_id、指定角色运行按角色查人、按发起人上级动态找发起人的部门负责人。源码里一般用approverType字段区分// 审批人解析伪代码 public ListString resolveApprovers(FlowNode node, FlowInstance instance) { String type node.getApproverType(); if (user.equals(type)) { return Arrays.asList(node.getApproverValue()); } if (role.equals(type)) { return userMapper.findByRoleId(node.getApproverValue()); } if (leader.equals(type)) { User initiator userMapper.findById(instance.getInitiatorId()); return Arrays.asList(initiator.getLeaderId()); } // 其他自定义类型抛异常方便设计器做校验 }条件分支的表达式解析是关键。这套源码实现时一般在节点流转器里处理条件节点// 节点流转伪代码 public String getNextNodeId(FlowNode node, FlowInstance instance, MapString, Object formData) { if (condition.equals(node.getType())) { ConditionEvaluator evaluator new ConditionEvaluator(); // 把表单字段填充到上下文再执行表达式 boolean result evaluator.evaluate(node.getConditionExpr(), formData); return result ? node.getNext() : node.getOtherwise(); } return node.getNext(); }参数说明formData是审批表单的键值对集合${days}这类占位符从formData里取值。写条件表达式时字段名必须和表单字段的name严格一致很多人就是在这里翻车的。会签所有审批人必须全部同意和或签任一人同意则通过一般通过flow_task表增加一个task_type字段区别。会签实现逻辑是审批人列表全部生成task记录每完成一个task判断是否还有未处理的任务全部完成后节点才算结束或签则是在任一人通过后直接置空其他task。4.3 表单设计与流程绑定表单这块源码通常支持“自定义表单”实现方式是在form_template表存表单的JSON模板包括字段名、类型、是否必填。发起审批时前端读取模板动态渲染表单提交时把表单数据作为JSON存进flow_instance.form_data字段。绑定流程的逻辑一般在流程设计器里加一个“关联表单”选项建流程时选择一个已配置的表单模板建好后的映射关系存在flow_definition.form_template_id字段里。发起审批时前端根据这个ID加载对应表单。如果下载的源码表单是硬编码的表单页面那自定义能力会弱一截但审批流程本身不受影响。5. 避坑指南部署和流程自定义里最常见的六个坑5.1 建好流程点击发布后发起审批时看不到该流程现象流程设计器里明明保存成功了但发起审批的流程列表里没有。原因状态字段没生效。设计器保存时通常有“草稿”和“发布”两种状态很多源码保存时默认草稿必须在列表页点发布。如果发布后仍看不到检查flow_definition.status字段确认SQL查询是否带了WHERE status 1。解决把流程改为发布状态若逻辑里没有发布动作直接手工把status改为1或者找设计器里的发布按钮。5.2 审批提交后任务表里没有任何记录现象发起人点提交系统提示成功但审批人的待办列表是空的flow_task表无数据。原因节点流转的“分配审批人”环节出了问题最常见的是审批人配置类型和值不匹配——比如配置的角色ID在数据库不存在或者当前发起人在用户表里没有leader_id。解决先查flow_instance确认流程实例创建成功再查flow_node看当前节点归属最后用4.2中的解析逻辑手动跑一遍resolveApprovers定位是角色查空还是上级查空。这个坑排查得最多建议在service层加日志。5.3 条件分支永远走默认路线现象请假天数超过3天流程还是直接跳到结束不走总经理审批。原因条件表达式写错最常见的是表单字段名对不上。设计器里字段显示名为“请假天数”但表单name是leave_days表达式写了${days} 3取值时找不到days。解决打开发起审批页面的浏览器F12查看表单提交的JSON字段名确保表达式变量名和表单name一致。如果条件节点支持多个分支检查是否有冲突的otherwise默认出口。5.4 审批通过后下一节点不流转现象当前节点审批通过但流程不进入下一节点实例卡在当前节点状态。原因next指向的节点ID不存在或指向了已删除的节点。这个在流程设计器删除中间节点、只改连线时容易出现。解决查看flow_node表当前节点记录的next字段确认目标节点存在。每条next建议在设计器保存时做一次校验避免手误导致流程死循环。5.5 部署到Linux后中文乱码现象在Windows上开发正常部署到服务器后审批表单和流程名称全部变成问号。原因数据库连接串没有指定characterEncoding或容器默认编码非UTF-8。MySQL的连接串里如果只有useSSL没写characterEncoding中文大概率乱码。解决url参数补全characterEncodingutf8并确认数据库本身字符集是utf8mb4。启动脚本加上-Dfile.encodingUTF-8同时检查JVM默认编码这两个位置都改掉才能彻底解决。5.6 页面能登录但菜单不显示现象admin账号能登录但首页菜单空白接口返回401。原因权限拦截器把菜单接口拦掉了。很多OA的权限拦截器和shiro或spring security绑定admin账号的token过期或者角色缓存没刷新导致认证失败。解决清理token缓存确认admin账号绑定了最高角色检查权限表里菜单和角色的关联数据是否完整。改过数据库里的角色权限后重启服务或清Redis缓存再试。6. 进阶玩法会签、加签与审批超时催办6.1 把单一审批改成会签很多OA系统的节点默认是“一个人通过就OK”但真实场景里经常需要“部门负责人、分管副总都要同意”。改造思路是在流程节点表增加approval_mode字段值为single或countersignpublic void completeTask(FlowTask task, String approveResult) { if (countersign.equals(task.getApprovalMode())) { // 更新当前任务为已审核 flowTaskMapper.updateStatus(task.getId(), approveResult); // 查询同节点下的其他未处理任务 int pending flowTaskMapper.countPendingByNode(task.getInstanceId(), task.getNodeId()); if (pending 0) { return; // 还没全部审批完节点不流转 } // 全部完成节点流转到下一节点 flowEngine.advanceToNext(task.getInstanceId()); } }这里的关键是countPendingByNode的查询条件不仅要过滤nodeId还要过滤task状态是待办的数据否则已处理的和未处理的混在一起会触发提前流转。加了这个字段之后流程设计器里需要预留一个“会签/或签”的下拉选项。6.2 审批转办与加签转办是当前审批人把任务移交给别人加签是当前节点多拉一个人参与审批。实现上需要拆两步转办本质是修改flow_task.assignee字段同时记录操作日志加签本质是新增一条task记录并把原task挂在同一个节点下。这两个功能适合放在待办列表的“更多操作”菜单里和审批按钮并列。6.3 审批超时自动催办生产环境里最常被吐槽的就是“审批卡在某个环节三天没人处理”。可以用一个定时任务扫描超时任务Component public class TimeoutRemindTask { Scheduled(cron 0 0 9 * * ?) public void remind() { ListFlowTask timeoutTasks flowTaskMapper.findTimeoutTasks(24); for (FlowTask task : timeoutTasks) { // 发送站内信或短信提醒 notifyService.sendRemind(task.getAssignee(), task); } } }参数说明findTimeoutTasks(24)表示超过24小时未处理的task这个阈值应该做成系统参数放在sys_config表里不要写死在代码里。定时任务的时间点选在工作日早上9点避免半夜短信轰炸。从那以后我每次部署OA系统都会先走一遍完整的“设计流程→发起审批→条件分支→会签通过→驳回重走”链路确认流程引擎的每个环节都在预期内再让业务部门上手用。这套源码本身不难难点全在细节希望这篇文章里的参数和踩坑记录能帮到你。本文还有配套的精品资源点击获取