开源oa系统二次开发：从踩坑到成功的完整经历

分类： 开源oa办公系统

tags： 开源oa,二次开发,定制开发,开源系统,技术栈,开发经验,代码修改

字数： 约5600字

---

今天不讲理论，讲一个真实经历。

去年我帮一家制造企业做了一次开源oa的二次开发项目，从选型到上线整整8个月，中间踩了很多坑，也摸索出了一些经验。

希望这篇文章能让你在做类似项目时少走弯路。

项目背景

客户是一家做精密零件的制造企业，大约300人，主要问题：

- 采购审批全靠纸质单据，领导出差就卡死

- 员工请假、出差记录分散在各个excel表

- 没有统一的合同台账，合同快到期了没人知道

- 生产工单没有系统管理，全靠班组长手工记录

预算15万，不想买标准oa产品（觉得太贵了），想用开源oa二次开发，"既省钱又能定制"。

我当时评估了一下，这个预算和需求，用开源oa二次开发是可行的，就接了这个项目。

第一个坑：选型没有做充分测评

我们最初选了一款国产开源oa，看了文档觉得功能挺全，社区也比较活跃，就开始了。

开发了大概三周后，我们发现：

它的流程引擎底层是activiti 5.x，而我们的项目依赖spring boot 3.x，两者有兼容性问题。

activiti 5.x对java 17的支持有问题，我们花了整整一周时间处理这个依赖冲突。最终是降回了java 11，但这给后续的某些新特性使用带来了限制。

教训一：选型时必须搭一个完整的技术栈验证环境，把核心依赖全部跑通，再开始正式开发。

第二个坑：对代码架构理解不够就动手

开源oa系统的代码通常有几年到十几年的历史，代码风格不一致，有历史包袱。

我们的新手开发工程师刚开始直接在原有代码里加功能，把自定义代码和原版代码混在一起。

结果：

- 上游版本升级时，我们的修改和官方更新产生了大量冲突

- 找一个功能的代码位置要翻很久，因为不清楚原来的架构分层

- 一个功能可能在3个不同的文件里都有修改，维护起来很乱

后来我们重新梳理，用了一个更清晰的策略：

教训二：二次开发要建立明确的分层规范

- 原版代码：尽量不动，只读

- 扩展点：在指定的扩展目录里添加，不混入原版代码

- 配置：通过配置文件控制，而不是硬编码

- 自定义流程/表单：在系统管理界面配置，而不是写代码

这样，当需要升级原版时，合并冲突要小得多。

第三个坑：生产工单需求理解不足

制造业的生产工单，看起来只是"创建一个任务，分配给工人"，但实际上涉及到：

- 物料清单（bom）——每个工单需要什么原材料

- 工序顺序——工单里有多道工序，必须按顺序完成

- 工时计算——每道工序的标准工时和实际工时

- 质检节点——某些工序完成后需要质检员签字才能继续

第一个版本我们做了一个简单的任务派发，客户看了之后说"这根本不够用"。

然后改需求，加工序，加物料关联，加质检审批……整整多了6周的开发时间。

教训三：制造业的业务需求特别复杂，一定要在项目启动前做详细的业务访谈，把每个业务场景走一遍，而不是凭理解猜需求。

我们后来安排了2天专门和工厂车间主任、生产计划员坐在一起，用白板把整个生产流程画出来，这次访谈节省了后来至少3周的返工。

第四个坑：性能测试太晚

我们在开发的大部分时间里，用的是50条测试数据。

上线前2周，客户要求我们用真实数据量测试（生产记录3年积累的10万+条数据），结果发现：

- 某个报表查询，有全表扫描，在10万条数据下要40秒才返回

- 工单列表页，一次加载全部数据，没有分页，前端卡成ppt

这两个问题花了我们将近2周时间修复（加索引、改查询逻辑、加分页），直接压缩了测试时间。

教训四：从开发开始就用接近生产量级的数据量测试，不要等到上线前才发现性能问题。

一般原则：开发环境至少用1万条数据，压力测试用10万+。

第五个坑：用户培训没有计划好

系统开发完了，上线那周，我们给员工做了一次2小时的培训。

结果？

大多数员工记住了20%，真正用的时候不会操作，打电话给行政问，行政打电话问我们，我们每天被各种小问题占满。

最后的解决方案是：

1. 给每个关键功能录一个2-3分钟的操作视频，发给员工

2. 行政部门指定一个"系统负责人"，专门负责内部培训和答疑

3. 在系统里加了"帮助文档"入口，常见问题都有文字说明

这些工作最好在上线前一个月就开始准备，而不是上线后再补救。

最终成果

8个月之后，系统正式稳定运行。实际效果：

- 采购审批从平均3.5天降到0.8天

- 所有纸质记录全部数字化，找合同从"翻柜子"变成"搜索关键词"

- 生产工单实时追踪，生产主管不用再每天喊话问"x号工单做到哪了"

- 合同到期自动提醒，再没有出现合同过期了才发现的情况

客户满意，但他说：如果重来一次，他会在项目前期多花时间在需求梳理上，而不是急着开工。

这也是我最大的感受。

给想做开源oa二次开发的企业几点建议

1. 不要低估二次开发的复杂度

开源oa的代码量通常在10万行以上，理解这些代码需要时间。"用开源省钱"是真的，但"省时间"不一定。

2. 找有该开源产品经验的团队

做过这个开源产品的团队，踩过的坑都踩过了，做起来效率是没做过的团队的2-3倍。

3. 明确边界

开源oa能做什么、不能做什么，和客户说清楚。不要把它当成erp来用，它不是。

4. 保留扩展能力

二次开发时要考虑：未来如果要加新功能，怎么加最方便？别为了当前快速实现把架构搞死了。

5. 做好文档

每次的代码修改都要写注释，说明为什么这样修改。6个月后你可能已经忘了当时的思路，注释能救命。

---

8个月，15万，300人的企业，一次从纸质到数字化的转变。结果是好的，过程是痛苦的，经验是宝贵的。

---

发布时间：2026-04-21

关键词：开源oa,二次开发,定制开发,开源系统,技术栈,开发经验