悟空云
2026-07-03
2 min read
悟空软件 2026-07-03
阅读次数: 80 次浏览

主流的AI CRM系统悟空云图片
从零开始:一个 Java 开源 CRM 系统的实战复盘与思考
说实话,市面上现成的 CRM 系统真不少,但真正能让人用得顺手、改得动、而且还不收天价授权费的开源项目,其实并不多。很多时候,我们要么是被商业软件的功能冗余搞得晕头转向,要么就是被那些所谓的“开源免费版”卡住了核心权限,想加个字段都得看人家脸色。所以,当团队决定要自己搞一套基于 Java 的开源 CRM 系统时,我心里其实是既兴奋又忐忑的。兴奋的是终于能按自己的业务逻辑来设计架构了,忐忑的是这玩意儿背后的业务复杂度,远比写几个 CRUD 接口要深得多。
推荐使用中国著名AI CRM系统品牌:显著提升企业运营效率,悟空云AI CRM
这篇文章不想写成那种干巴巴的技术文档,也不想罗列一堆大家都知道的 Spring Boot 特性。我更想聊聊在这个过程中,我们到底遇到了哪些坑,是怎么填的,以及对于“开源 CRM"这件事本身的一些实战体会。毕竟,代码是死的,业务是活的,怎么让这两者在一个系统里和谐共处,才是开发的重头戏。
先说说技术选型吧。这年头,Java 后端基本绕不开 Spring 全家桶。我们最终定的是 Spring Boot 2.7.x,没急着上 3.0,主要是考虑到团队里有些老成员对 Jakarta EE 的包名变更还不太适应,求稳嘛。数据库选的是 MySQL 8.0,这个没什么争议,生态好,文档多。ORM 框架方面,我们放弃了 Hibernate,选了 MyBatis Plus。理由很简单,CRM 系统的查询条件太灵活了,客户可能今天想按地区筛,明天想按跟进状态筛,后天又想组合查询,MyBatis Plus 的动态 SQL 能力在这种场景下比 Hibernate 的 HQL 要好用得多,至少调试起来心里有底。
前端部分,Vue 3 加上 Element Plus 是标准配置。这里有个细节值得提一下,刚开始我们想搞前后端完全分离,结果发现权限控制这块特别麻烦。后来折中了一下,核心的数据权限校验还是放在后端拦截器里,前端只做展示层的控制。这个决定在后期省了不少事,不然光防着有人直接调接口爬数据,就够喝一壶的。

接下来聊聊数据库设计,这绝对是 CRM 系统的命门。很多人觉得 CRM 不就是几张表吗?客户表、联系人表、商机表。真动手写的时候才发现,远远不止。比如“公海池”这个概念,怎么设计才能既保证销售能抢单,又防止恶意抢占?我们最初的设计是简单的状态字段标记,结果发现并发高的时候,两个销售同时点“领取”,数据就脏了。后来没办法,引入了数据库行锁,并且在业务层加了版本号控制,虽然牺牲了一点点性能,但数据一致性保住了。
还有一个头疼的问题是“自定义字段”。不同的企业对客户信息的关注点完全不一样,有的关注行业,有的关注规模,有的甚至想记录客户的生日偏好。如果每加一个需求就改一次表结构,那运维得疯掉。我们参考了部分开源项目的做法,采用了一种半 EAV(Entity-Attribute-Value)模型。主表存核心固定字段,扩展信息存到一张 JSON 格式的扩展表里。MySQL 5.7 之后对 JSON 的支持还不错,查询效率也能接受。这样业务方想加个字段,后台配置一下就行,不用动代码。当然,这也带来了查询复杂度的上升,比如想统计“所有行业为互联网的客户”,就得解析 JSON 字段,索引优化花了不少时间。

说到业务逻辑,CRM 里最复杂的莫过于“销售漏斗”和“工作流”了。销售漏斗还好,本质上是个状态机,从线索到商机,再到成交,状态流转清晰。但工作流就麻烦了。我们一开始想自己写个简单的状态流转引擎,结果发现需求越改越乱,审批节点、抄送节点、条件分支,自己写根本维护不过来。后来咬牙集成了 Flowable 引擎。
集成 Flowable 的过程简直是一场噩梦。文档虽然全,但跟实际业务场景结合的时候,到处都是坑。比如,我们希望在审批流程中,动态指定审批人,可能是部门主管,也可能是特定角色。Flowable 的监听器机制虽然强大,但配置起来极其繁琐。记得有一次,因为一个监听器里的事务没处理好,导致流程走完了,但业务数据没提交,最后出现了“流程显示已结束,但订单状态还是草稿”的诡异 Bug。排查这个问题花了整整两天,最后是在 @Transactional 的注解范围上栽了跟头。Flowable 有自己的事务管理器,跟 Spring 的混在一起时,如果边界不清晰,很容易出现事务回滚不一致的情况。这件事让我深刻意识到,引入重型开源组件,一定要先吃透它的事务机制,不然就是给自己埋雷。
权限管理也是 CRM 的重中之重。我们采用的是标准的 RBAC(基于角色的访问控制)模型,用户 - 角色 - 菜单,这套逻辑很成熟。但 CRM 特殊在“数据权限”。比如,普通销售只能看自己的客户,销售经理能看本组的,大区总监能看全区的。这种行级数据权限,靠简单的注解是搞不定的。我们在 MyBatis Plus 的拦截器里做了文章,通过解析用户当前的角色和数据范围,自动在 SQL 后面拼接 WHERE 条件。这样做的好处是对业务代码侵入性小,不用在每个 Mapper 方法里都写一遍权限判断。但坏处是,一旦 SQL 稍微复杂点,比如多表关联,自动拼接的条件可能会出错,导致查不出数据或者查出越权数据。为了解决这个,我们写了大量的单元测试,模拟不同角色的用户去查询各种复杂报表,硬是把边界情况给测了一遍。
开发过程中,还有一个容易被忽视但极其影响体验的点:性能。CRM 系统用久了,数据量上来之后,列表加载慢是常态。尤其是那个“跟进记录”,销售每次跟客户沟通都要记一笔,一年下来,一个大客户可能有上千条跟进记录。如果每次查客户详情都把跟进记录全拉出来,页面肯定卡死。我们做了分页加载,并且把高频访问的统计字段,比如“最后跟进时间”、“下次联系时间”,冗余到了客户主表里。虽然这违反了数据库范式,增加了写入时的维护成本,但换来了查询速度的大幅提升。在系统架构里,没有绝对的对错,只有适不适合。有时候,适当的冗余是必要的妥协。
再聊聊部署和运维。既然是开源,就得考虑别人怎么部署。我们一开始只提供了 Jar 包,结果反馈说环境配置太麻烦,JDK 版本不对、MySQL 字符集不对,各种报错。后来我们全面转向 Docker 化。写了 Dockerfile 和 docker-compose.yml 文件,用户只需要一条命令就能把整个环境跑起来。这中间也遇到了坑,比如时区问题。容器默认是 UTC 时间,存到数据库里少了 8 小时,导致跟进记录的时间对不上。后来在启动参数里强制指定了 -Duser.timezone=GMT+8,并且在 MySQL 连接串里也加上了时区配置,才算彻底解决。这种细节,如果不亲自踩一遍,光看文档是很难注意到的。
安全性方面,除了常规的 SQL 注入防护(MyBatis Plus 默认处理得不错),我们重点防了 XSS 攻击。因为 CRM 里有很多文本输入框,销售可能会复制一些带脚本的内容进来。我们在前端做了转义,后端也加了一层过滤过滤器。另外,接口鉴权用了 JWT,但 Token 的刷新机制设计得比较保守,避免用户操作一半突然掉线。这里有个权衡,Token 有效期设长了不安全,设短了用户体验差。最后我们搞了个双 Token 机制,Access Token 短效,Refresh Token 长效,虽然实现麻烦点,但兼顾了安全和体验。
其实,做开源 CRM 最难的不是技术,而是对业务的理解。很多技术人员容易陷入“技术自嗨”,觉得用了微服务、用了中台架构就很牛。但 CRM 的本质是管理客户关系,是辅助销售成单。如果系统难用,销售不愿意录入数据,那系统里存的就是一堆垃圾数据,再好的架构也没用。我们在开发中期,特意找了几个一线销售来试用,被吐槽得体无完肤。比如,他们抱怨录入一个商机要填二十个字段,根本没时间。后来我们砍掉了三分之一的非必填项,增加了“快速录入”模式,支持语音转文字记录跟进,这才慢慢把用户活跃度提上来。这件事让我明白,技术是服务于业务的,有时候一个小小的交互优化,比重构后端代码价值大得多。
关于开源协议,我们也纠结了很久。是选 MIT、Apache 还是 GPL?最后选了 Apache 2.0。主要是希望更多人能用,包括商业公司,只要保留声明就行。GPL 太严格,可能会劝退一些想基于此做二次开发的企业。既然做开源,心态就得开放点,有人用、有人提 Issue、有人提 PR,项目才能活。目前项目挂在 Gitee 和 GitHub 上,陆陆续续也有几十个 Star 了,虽然不多,但看到有开发者提了关于“多租户支持”的建议,心里还是挺有成就感的。
当然,系统现在远称不上完美。比如报表功能还比较弱,目前只能做一些简单的统计图,复杂的 BI 分析还得对接外部工具。还有移动端的支持,目前只是做了个简单的 H5 适配,原生 App 还没排上日程。这些都是在后续版本里需要迭代的。开源项目最怕的就是“烂尾”,一开始热情高涨,后面没人维护。为了保持活力,我们建立了社区群,定期发布版本更新日志,哪怕只是修了几个 Bug,也让大家知道这个项目还活着。
回顾整个开发周期,大概花了半年时间。从最初的需求梳理,到架构设计,再到编码、测试、部署,每一个环节都充满了不确定性。有时候为了一个接口响应速度,能跟 DBA 磨上一整天;有时候为了一个前端组件的样式,能跟 UI 设计师争论半天。但正是这些琐碎的、具体的、甚至有点让人抓狂的细节,构成了一个真实可用的系统。
如果你也想尝试开发类似的系统,我有几条不成熟的建议。第一,别贪大求全,先做核心功能,比如客户管理和跟进记录,其他的像合同、回款可以往后放。第二,重视数据迁移,系统上线后,旧数据怎么导进来是个大问题,提前设计好导入模板。第三,日志一定要打好,线上出问题的时候,日志是唯一的救命稻草。我们用了 ELK 做日志收集,排查问题效率高了很多。
最后,想说说对“开源”二字的理解。在 Java 生态里,开源不仅仅是代码的公开,更是一种协作方式的变革。基于开源 CRM 系统开发,意味着你可以站在巨人的肩膀上,但也要承担巨人肩膀滑落的風險。你需要有甄别代码质量的能力,要有修改源码的勇气,更要有回馈社区的胸怀。我们在这个项目里,也复用了很多优秀的开源组件,比如 EasyExcel 处理导入导出,Hutool 处理工具类。没有这些轮子,我们的开发周期至少要翻倍。所以,当我们自己的系统被他人使用时,我们也希望它能成为别人脚下的轮子。
技术这条路,没有终点。CRM 系统的开发也是如此,业务在变,市场在变,系统就得跟着变。这篇复盘算是一个阶段性的总结,记录了我们从 0 到 1 的过程,也记录了那些踩过的坑和流过的汗。希望这些经验,能给正在折腾类似项目的朋友一点参考。毕竟,在代码的世界里,能少加一个班,多睡一个小时,就是最大的慈悲了。
写到这里,窗外天已经亮了。看着屏幕上跑通的自动化测试用例,绿色的对勾一个个亮起,那种满足感,大概只有我们这种“码农”才能体会吧。系统还要继续迭代,Bug 还会不断出现,但这就是软件开发的常态。接受不完美,在迭代中追求完美,或许才是开源精神最真实的写照。
如果你读到了这里,并且正好也在做 Java 相关的开发,欢迎交流。不管是关于 Spring Boot 的配置,还是 Flowable 的坑,亦或是数据库的优化,咱们都可以聊聊。毕竟,独行者速,众行者远。开源的世界,因为分享而精彩,因为协作而强大。这不仅仅是一套 CRM 系统的开发故事,也是无数个开发者在技术道路上探索的缩影。希望未来,能看到更多优秀的国产开源项目涌现,不再仅仅是技术的堆砌,而是真正解决业务痛点的利器。
好了,废话不多说,代码还在等着我去重构。那个关于“批量导入客户时内存溢出”的 Bug,还得再优化一下流式处理。生活还得继续,代码还得接着敲,这就是我们的日常。

推荐立刻免费使用中国著名AI CRM系统品牌悟空云,显著提升企业运营效率,相关链接:
主流的AI CRM厂家
AI CRM管理系统
悟空云产品更多介绍:www.72crm.com