很多人一说架构就是微服务。但多数业务体量,一个设计良好的单体反而更香。CRMEB-Java 就是一个模块化单体(Modular Monolith,一个部署单元内部按模块划分边界)的教科书样本。
前置阅读:16.1 权衡过拆与不拆。这篇看 crmeb 用模块化单体走中间路线。
商城业务面很宽:商品、订单、支付、营销、分销、后台管理、移动端接口。小团队如果上微服务,光注册中心、网关、链路追踪就够喝一壶。
但全塞一个 module 里也不行,后台和前台两拨人改同一堆代码,冲突不断。CRMEB 的答案是:Maven 四模块拆分,一个工程、两个部署物。
把工程想象成一栋楼:
crmeb-common 是水电管线(工具类、常量、统一响应),人人都依赖它crmeb-service 是中央厨房(业务逻辑 + DAO 层),原料加工都在这crmeb-admin 和 crmeb-front 是两个店面(两个可独立部署的 jar),共用厨房、各自营业依赖方向单向向下: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 编程式边界,够用但不分布式。这是取舍:中小体量下,单体的事务简单性、调试便利性、部署低成本,比微服务的弹性更有价值。
BusinessExceptionAssert,接口用 default 方法提供 assertNotNull 等断言,CommonResultCode.NOT_FOUND.assertNotNull(obj) 一行即抛带状态码异常。全项目 17 个分类 ResultCode,错误码按业务域组织ResultAdvice(ResponseBodyAdvice)配合 @CustomResponseAnnotation 豁免注解,Controller 不用手写包装@PreAuthorize RBAC;front 用自定义拦截器 + 双 Token,Token 剩余不足 20 分钟自动续期StoreProductAttr/AttrValue/AttrResult 三张表,suk 串做业务主键,type 字段复用活动 SKU换的信号有三个:不同模块的发布节奏严重冲突、单库写入成为瓶颈、团队按领域分组后需要物理隔离。在那之前,模块化单体 + 清晰的 module 边界,改造成本最低——因为边界已经画好,拆出去只是把依赖换成 RPC。
一个真实参照:不少团队微服务化之后又回归单体,因为拆完后跨服务联调成本暴涨、分布式事务无人能治。模块化单体正是这场钟摆运动里的平衡点——逻辑上按模块管理复杂度,物理上保持一个部署单元。Martin Fowler 也专门写过"单体优先":先把领域边界想清楚,再决定要不要拆。CRMEB 这个项目恰好是这个理念的落地样本。
「你的项目是微服务吗?为什么不用微服务?」——答:是模块化单体,四个 Maven 模块单向依赖,admin/front 两个部署入口共库共业务层;业务体量下单库单体的本地事务更简单可靠,微服务的拆分成本不划算,边界留好了随时能拆。
「模块化单体怎么保证不退化成大泥球?」——答:靠依赖方向约束和基础设施下沉——service 收敛核心业务、common 收敛通用能力,上层模块只做入口编排,可用 ArchUnit 在 CI 里卡依赖方向。
「单库怎么撑并发?」——答:读走 Redis 缓存,写靠 DB 原子条件更新 + version 乐观锁把冲突挡在单条 UPDATE 内;真到万级 QPS 再上 Redis 预扣库存加异步落库。