← 课程目录 🚀 从零到一
📐 学习维度 阶段7 · 第28章 开源项目源码精读 🚀 从零到一 📚 课程目录 🏠 首页 🛤️ 学习路径

28.13.1 CRMEB-Java 模块化单体架构:多 module 拆分与单体演进

审校 2026-09-26 · 素材来源:zcode会话《分析项目亮点:分布式与架构设计》(项目源码分析)
📑 本篇章节导航 (共8节,点击直达)
场景:小团队扛一个完整商城类比:一栋楼里的两家店面可跑示例原理:拆分背后的四条设计决策单体内还有这些可抠的细节单体 vs 微服务:什么时候换踩坑清单面试怎么问

很多人一说架构就是微服务。但多数业务体量,一个设计良好的单体反而更香。CRMEB-Java 就是一个模块化单体(Modular Monolith,一个部署单元内部按模块划分边界)的教科书样本。

前置阅读:16.1 权衡过拆与不拆。这篇看 crmeb 用模块化单体走中间路线。

场景:小团队扛一个完整商城

商城业务面很宽:商品、订单、支付、营销、分销、后台管理、移动端接口。小团队如果上微服务,光注册中心、网关、链路追踪就够喝一壶。

但全塞一个 module 里也不行,后台和前台两拨人改同一堆代码,冲突不断。CRMEB 的答案是:Maven 四模块拆分,一个工程、两个部署物。

类比:一栋楼里的两家店面

把工程想象成一栋楼:

依赖方向单向向下:admin/front → service → common。这就是单体内的高内聚低耦合。

可跑示例


# 源码结构(D:\\ideaProject\\crmeb_java\\crmeb)
crmeb
├── crmeb-common    # 基础:工具类、异常体系、统一响应、常量
├── crmeb-service   # 业务:Service 实现 + MyBatis Plus DAO
├── crmeb-admin     # 管理后台 API(打成 jar 部署)
└── crmeb-front     # 移动端/用户侧 API(打成 jar 部署)

# 构建:根目录一次打包,产出两个可部署 jar
mvn clean package -DskipTests
# 产物:crmeb-admin/target/*.jar 和 crmeb-front/target/*.jar

两个 jar 可以部署在同一台机器,也可以拆开。它们连的是同一个 MySQL 单库,靠同一套 service 层保证业务逻辑不分裂。

原理:拆分背后的四条设计决策

第一,按部署面拆,不按领域拆。 admin 和 front 是两类流量、两类鉴权体系(后台走 Spring Security + RBAC,前台走自定义拦截器 + 双 Token)。拆成两个入口后,各自的安全策略、限流、发布节奏互不干扰。

第二,业务收敛在 service 层。 订单防超卖、价格计算这些核心逻辑全在 crmeb-service 里,比如 StoreProductAttrValueServiceImpl.operationStock 用 stock - N >= 0 的原子条件更新防超卖。两个入口调用同一份扣库存代码,不会出现后台改库存和前台下单各写一套的分裂。

第三,基础设施全部下沉 common。 断言式异常体系(CommonResultCode.NOT_FOUND.assertNotNull(obj) 一行抛业务异常)、ResultAdvice 统一响应包装、GlobalExceptionHandler 全局异常落库,都放在 common,上层模块零成本复用。

第四,两阶段下单吃满本地事务红利。 下单分两步:preOrder() 预下单校验商品、库存、会员价,把订单快照 JSON 存 Redis 并带过期时间;createOrder() 正式下单时取快照、复核库存、重算价格,再批量入库。

秒杀、砍价、拼团下单时一次要扣四张表:主商品表、主商品 SKU、活动 SKU、活动主表。全部包在同一个本地事务里,任一失败整体回滚。这在微服务里要引入 Seata 或消息最终一致性,而单库里只是一个方法的提交回滚。本地事务的简单可靠,是模块化单体最大的隐性红利。

事务边界也讲究:用 TransactionTemplate 编程式而非 @Transactional 声明式,因为"扣库存 + 写订单 + 锁优惠券 + 清购物车"必须精确包进事务,发短信、写延迟队列等外部 IO 必须放事务外,避免长事务(事务持有过久,拖住连接和行锁)。声明式注解的方法粒度裁不了这么细。

单体的诚实边界:这个项目没有 Spring Cloud、Nacos、Seata、MQ,单库 MySQL 无分库分表。事务靠本地事务 + TransactionTemplate 编程式边界,够用但不分布式。这是取舍:中小体量下,单体的事务简单性、调试便利性、部署低成本,比微服务的弹性更有价值。

单体内还有这些可抠的细节

单体 vs 微服务:什么时候换

换的信号有三个:不同模块的发布节奏严重冲突、单库写入成为瓶颈、团队按领域分组后需要物理隔离。在那之前,模块化单体 + 清晰的 module 边界,改造成本最低——因为边界已经画好,拆出去只是把依赖换成 RPC。

一个真实参照:不少团队微服务化之后又回归单体,因为拆完后跨服务联调成本暴涨、分布式事务无人能治。模块化单体正是这场钟摆运动里的平衡点——逻辑上按模块管理复杂度,物理上保持一个部署单元。Martin Fowler 也专门写过"单体优先":先把领域边界想清楚,再决定要不要拆。CRMEB 这个项目恰好是这个理念的落地样本。

踩坑清单

面试怎么问

「你的项目是微服务吗?为什么不用微服务?」——答:是模块化单体,四个 Maven 模块单向依赖,admin/front 两个部署入口共库共业务层;业务体量下单库单体的本地事务更简单可靠,微服务的拆分成本不划算,边界留好了随时能拆。

「模块化单体怎么保证不退化成大泥球?」——答:靠依赖方向约束和基础设施下沉——service 收敛核心业务、common 收敛通用能力,上层模块只做入口编排,可用 ArchUnit 在 CI 里卡依赖方向。

「单库怎么撑并发?」——答:读走 Redis 缓存,写靠 DB 原子条件更新 + version 乐观锁把冲突挡在单条 UPDATE 内;真到万级 QPS 再上 Redis 预扣库存加异步落库。