spring

　　在Spring Modulith的设计里，模块之间更推荐用事件来协作，而不是直接注入对方模块的Spring Bean形成强依赖。这样做的目标很明确，就是让模块边界更清晰、集成测试更容易写，同时把批量的二级业务处理从主事务里拆出去，减少事务边界被越拉越宽的风险。

　　一、Spring Modulith的事件驱动机制是什么

　　它的事件机制是建立在Spring Framework的Application Event之上，再额外加上一层可追踪、可重投、可外部化的基础设施，让事件从发布到消费具备更强的生产可用性。

　　1、用Application Event作为模块间主通道

　　发布方通过ApplicationEventPublisher发布领域事件，消费方只关心自己订阅的事件类型，发布方不需要知道有哪些模块会处理它，从结构上避免模块之间互相牵连。

　　2、默认同步发布保持简单一致性语义

　　文档强调事件发布默认是同步的，这意味着发布事件仍在同一事务语义里运行，优点是一致性模型简单，缺点是相关功能越加越多，事务边界会变宽。

　　3、把消费移到事务提交后并异步执行

　　如果你把监听器做成异步的事务性事件监听，默认会在原事务提交后再执行，从而把二级功能从主事务中拆出来，但也会引入事件丢失风险，因为监听器失败或进程在调用前崩溃时，事件本身可能已经无法补救。

　　4、用 ApplicationModuleListener作为默认的跨模块监听写法

　　Spring Modulith提供 ApplicationModuleListener作为快捷方式，用来表达模块间通过事件集成的推荐形态，避免每次都手工堆叠多组注解与传播级别。

　　5、用Event Publication Registry给事务性监听加可靠性

　　它会在事件发布时识别将接收事件的事务性监听器，并在原业务事务内为每个监听器写入发布日志条目；监听成功则标记完成，失败则保留未完成条目，为后续重试与补投留出抓手。

　　6、通过配置与管理API支撑重投与清理

　　文档给出可以用spring.modulith.events.republish-outstanding-events-on-restart开启重启自动重投，同时也提供对未完成与已完成发布记录的管理能力，便于做补投与定期清理。

　　二、Spring Modulith的事件机制有什么作用

　　如果只把它当成Application Event的包装层，价值会被低估，它真正解决的是模块解耦与可靠交付这两类工程问题，同时给外部化与测试提供了可复用的工具链。

　　1、减少模块之间的直接依赖与连锁改动

　　发布方只发布事件，不再直接调用别的模块服务，后续新增订阅方时通常不需要回头修改发布方代码，模块间的演进阻力会更小。

　　2、让模块集成测试更可控

　　事件作为模块契约的一部分，可以用PublishedEvents一类能力在测试里筛选与断言事件是否发生，从而把跨模块协作变成可验证的行为。

　　3、把事件消费做成可追踪、可补偿的交付链路

　　Event Publication Registry的发布日志相当于把事务性监听的交付过程落到了可查询的状态机里，监听失败不会悄悄吞掉事件，后续可以按未完成条目做重试与运营处理。

　　4、支持事件外部化到消息系统

　　在需要把内部事件对接到消息中间件时，可以通过标注事件类型触发透明外部化，并结合路由目标与路由键完成投递，把对broker的交互从业务事务里拆开。

　　5、让事件持久化方式可选并贴近你的技术栈

　　事件发布日志可以基于不同持久化技术落地，文档列出了面向JPA、JDBC、MongoDB、Neo4j等的starter，方便你按现有存储体系选择实现路径。

　　三、如何在项目里用好Spring Modulith的事件机制

　　落地时建议把事件当成模块契约来设计，而不是把任何方法调用都改成发事件，这样既能享受解耦与可靠交付，又不至于把链路拆得过碎。

　　1、先把事件类型定义成稳定的领域语义

　　优先围绕聚合的状态变化定义事件，让事件表达业务事实而不是技术动作，这样订阅方更容易长期复用。

　　2、跨模块监听优先用 ApplicationModuleListener

　　把跨模块消费统一到推荐的监听形式上，既减少配置碎片，也更容易与发布日志机制协同，避免出现有的监听可重投、有的监听不可重投的口径不一致。

　　3、监听器实现幂等与可重试

　　因为失败条目可能会被后续重投，消费逻辑要能识别重复事件，至少做到同一事件重复执行不会造成数据越写越乱。

　　4、按你的存储选对事件发布日志starter

　　如果你希望发布日志持久化，就按JPA或JDBC或MongoDB或Neo4j选择对应starter，把它当作批处理作业的基础设施来对待，部署与备份策略要跟上。

　　5、根据运维需求启用重启补投与清理机制

　　需要自动补投就开启spring.modulith.events.republish-outstanding-events-on-restart，不需要自动补投也至少要定期巡检未完成条目并制定处理流程，同时规划已完成记录的清理与归档。

　　6、需要对外发消息时再引入外部化能力

　　仅在确实要对接消息系统时再做事件外部化，通过事件标注与路由配置把发布与投递解耦，并把失败投递交给发布日志的未完成条目来兜底。

　　总结

　　Spring Modulith的事件驱动机制以Spring Application Event为基础，强调用事件来完成模块间集成，并通过Event Publication Registry把事务性监听的交付过程记录到发布日志里，实现监听成功才完成、失败可保留待补投的可靠链路，同时还能把内部事件外部化到消息系统并提升模块集成测试的可验证性。