C# 领域事件发布方法 C#如何使用MediatR实现领域事件

浅静大大_2079

浅静大大_2079

2026-02-03

451人浏览

原创

MediatR领域事件发布的核心机制是通过IPublisher.Publish()分发INotification实现,需在事务提交前调用、处理器注册为transient、事件为不可变DTO。

c# 领域事件发布方法 c#如何使用mediatr实现领域事件

MediatR 领域事件发布的核心机制是什么

MediatR 本身不直接提供“领域事件”抽象,它只负责消息(IRequest、INotification)的同步/异步分发。所谓“领域事件”,是业务建模概念,需靠 INotification 及其处理器(IHandleNotification)来模拟实现——关键在于:事件发布必须走 IPublisher.Publish(),而不是直接 new + 调用。

常见错误是把领域事件当普通类直接触发逻辑,绕过 MediatR 管道,导致事务一致性丢失、日志/重试/装饰器失效。

  • INotification 必须是无返回值、不可变的 DTO(如 OrderCreatedEvent),不能带业务方法
  • 所有处理器必须注册为 transient(每次发布新建实例),避免状态污染
  • 发布点应在领域层完成业务变更后、事务提交前(如 EF Core 的 SaveChangesAsync 后立即 Publish)

如何在 C# 中正确发布一个领域事件

以订单创建为例,发布 OrderCreatedEvent 的典型流程如下:

// 1. 定义事件(纯数据)
public record OrderCreatedEvent(Guid OrderId, decimal Total) : INotification;
<p>// 2. 在应用服务中完成业务逻辑后发布
public class OrderService
{
private readonly IPublisher _publisher;
private readonly AppDbContext _context;</p><pre class="brush:php;toolbar:false;">public OrderService(IPublisher publisher, AppDbContext context)
{
    _publisher = publisher;
    _context = context;
}

public async Task<guid> CreateOrderAsync(CreateOrderCommand cmd)
{
    var order = new Order(cmd.Items);
    _context.Orders.Add(order);
    await _context.SaveChangesAsync(); // 事务已持久化

    // ✅ 正确:发布事件(此时可被事务拦截器捕获)
    await _publisher.Publish(new OrderCreatedEvent(order.Id, order.Total));

    return order.Id;
}</guid>

}

注意:IPublisher 是 MediatR 提供的接口,由 DI 容器注入;不要用 IMediator 发布领域事件(它是为请求响应设计的)。

中文PDF处理器(免费版)
中文PDF处理器(免费版)

针对中文PDF优化的处理工具,支持中文OCR、版面分析、表格提取与智能分块。

下载

为什么领域事件处理器不自动执行或执行两次

常见现象是 IHandleNotification 没触发,或在并发下重复执行。根本原因多出在注册和生命周期上:

  • 未调用 services.AddMediatR(cfg => cfg.RegisterServicesFromAssemblyContaining()),导致处理器未被扫描注册
  • 处理器类未实现 IHandleNotification,或泛型参数写错(如用了 INotification 基类)
  • 使用了 singleton 生命周期注册处理器(AddSingleton, Handler>()),引发状态共享和并发问题
  • EF Core 中启用了延迟加载代理,且事件处理器里又访问了未加载的导航属性,触发额外查询并卡住管道

验证方式:在处理器构造函数加日志,看是否被实例化;检查 DI 容器中 IHandleNotification 的注册数量是否为 1。

事务一致性怎么保障

MediatR 默认同步执行通知,但数据库事务已提交,无法回滚处理器中的异常。要真正实现“发布即一致”,必须引入事务钩子或外部补偿:

  • 用 EF Core 的 DbContext.SaveChanges 后的 Transaction.Commit 事件,在提交成功后再调用 Publish(需自定义 SaveChangesAsync 包装)
  • 更推荐方案:改用 Outbox Pattern,把事件先写入本地 outbox 表(同事务),再由后台轮询投递——MediatR 不参与事务,只负责最终消费
  • 若坚持用 MediatR 内联发布,至少让所有处理器标记为 [Transactional](需自定义行为),并在处理器抛异常时手动回滚(不推荐,耦合太重)

别忽略这个细节:领域事件不是“发出去就完事”,它的语义是“某件事已确定发生”,不是“我打算让它发生”。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

处理器 c#

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
硬盘接口类型介绍
硬盘接口类型介绍

硬盘接口类型有IDE、SATA、SCSI、Fibre Channel、USB、eSATA、mSATA、PCIe等等。详细介绍:1、IDE接口是一种并行接口,主要用于连接硬盘和光驱等设备,它主要有两种类型:ATA和ATAPI,IDE接口已经逐渐被SATA接口;2、SATA接口是一种串行接口,相较于IDE接口,它具有更高的传输速度、更低的功耗和更小的体积;3、SCSI接口等等。

2023.10.19

3248

3

PHP接口编写教程
PHP接口编写教程

本专题整合了PHP接口编写教程,阅读专题下面的文章了解更多详细内容。

2025.10.17

5549

12

php8.4实现接口限流的教程
php8.4实现接口限流的教程

PHP8.4本身不内置限流功能,需借助Redis(令牌桶)或Swoole(漏桶)实现;文件锁因I/O瓶颈、无跨机共享、秒级精度等缺陷不适用高并发场景。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2025.12.29

3909

9

java接口相关教程
java接口相关教程

本专题整合了java接口相关内容,阅读专题下面的文章了解更多详细内容。

2026.01.19

506

15

TypeScript类型系统进阶与大型前端项目实践
TypeScript类型系统进阶与大型前端项目实践

本专题围绕 TypeScript 在大型前端项目中的应用展开,深入讲解类型系统设计与工程化开发方法。内容包括泛型与高级类型、类型推断机制、声明文件编写、模块化结构设计以及代码规范管理。通过真实项目案例分析,帮助开发者构建类型安全、结构清晰、易维护的前端工程体系,提高团队协作效率与代码质量。

2026.03.13

411

19

数据库三范式
数据库三范式

数据库三范式是一种设计规范,用于规范化关系型数据库中的数据结构,它通过消除冗余数据、提高数据库性能和数据一致性,提供了一种有效的数据库设计方法。本专题提供数据库三范式相关的文章、下载和课程。

2023.06.29

3245

3

如何删除数据库
如何删除数据库

删除数据库是指在MySQL中完全移除一个数据库及其所包含的所有数据和结构,作用包括:1、释放存储空间;2、确保数据的安全性;3、提高数据库的整体性能,加速查询和操作的执行速度。尽管删除数据库具有一些好处,但在执行任何删除操作之前,务必谨慎操作,并备份重要的数据。删除数据库将永久性地删除所有相关数据和结构,无法回滚。

2023.08.14

4261

10

vb怎么连接数据库
vb怎么连接数据库

在VB中,连接数据库通常使用ADO(ActiveX 数据对象)或 DAO(Data Access Objects)这两个技术来实现:1、引入ADO库;2、创建ADO连接对象;3、配置连接字符串;4、打开连接;5、执行SQL语句;6、处理查询结果;7、关闭连接即可。

2023.08.31

3651

3

MySQL恢复数据库
MySQL恢复数据库

MySQL恢复数据库的方法有使用物理备份恢复、使用逻辑备份恢复、使用二进制日志恢复和使用数据库复制进行恢复等。本专题为大家提供MySQL数据库相关的文章、下载、课程内容,供大家免费下载体验。

2023.09.05

1127

5

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Sass 教程
Sass 教程

共14课时 | 1.6万人学习

PHP入门速学(台湾同胞版)
PHP入门速学(台湾同胞版)

共10课时 | 1.6万人学习

韩顺平 2016年 最新PHP基础视频教程
韩顺平 2016年 最新PHP基础视频教程

共47课时 | 12.2万人学习