c#如何使用MediatR_c#MediatR的正确用法与注意事项
C#中MediatR的正确用法与核心注意事项
免费影视、动漫、音乐、游戏、小说资源长期稳定更新！ 👉 点此立即查看 👈
在C#项目里引入MediatR，本意是让代码更清晰、更解耦。但实际操作中，不少开发者第一步就卡住了——如果没正确注册IMediator，或者注册方式有偏差，那么后续所有的Send操作都会直接抛出InvalidOperationException，让你寸步难行。
Program.cs 里怎么注册才不报错
问题的根源往往在服务注册这一步。必须调用AddMediatR，但仅仅写builder.Services.AddMediatR()是远远不够的（尤其是在.NET 6+的默认参数下，很容易漏掉跨程序集的Handler）。一个常见的坑是只传入了当前入口程序集，而Handler实际却定义在另一个类库中。
- 场景一：Handler和请求类都在主项目（比如一个Web API）。这时应该用
AddMediatR(cfg => cfg.RegisterServicesFromAssembly(typeof(Program).Assembly))，明确指定从当前程序集加载。 - 场景二：Handler单独放在
Application或Handlers类库中。这就必须显式传入那个类库的程序集，例如AddMediatR(typeof(CreateUserCommandHandler).Assembly)。 - 别忘了
using MediatR;——少了这个命名空间，AddMediatR扩展方法压根不会出现在智能提示里。 - 生命周期配置是关键。通常需要加上
.AsScoped()（或者确保默认就是Scoped）。因为MediatR内部依赖IServiceProvider来解析Handler，而Handler往往需要注入像DbContext这类Scoped服务。生命周期不匹配，程序运行起来很容易“炸”。
IRequest 和 IRequest 怎么选
选错接口类型，轻则编译失败，出现Cannot convert lambda expression这类错误；重则运行时逻辑混乱，比如Send一个本该返回void的请求，却试图去接收返回值。
- 纯触发动作，不关心结果：比如发送邮件、记录日志。直接用
IRequest，对应的Handler签名是Task Handle(...)。 - 需要返回数据：比如创建实体后返回ID，或者查询后返回一个DTO。那就必须用
IRequest、IRequest这类泛型接口，Handler签名相应是Task。Handle(...) - 有一个绝对要避免的写法：不要用
void作为泛型参数。IRequest是不合法的，编译直接通不过。 - 另外，命令类（Command）里最好别塞
[Required]这类数据注解属性来做验证。验证逻辑应该交给IRequestPreProcessor或者专门的验证库（如FluentValidation）来处理，这样职责更清晰。
Handler 里为什么不能混读写逻辑
想象一下，在一个GetUserQueryHandler里，你顺手调用了_context.Sa veChangesAsync()。代码可能能跑起来，但这实际上破坏了CQRS（命令查询职责分离）的隔离前提，会引发一系列连锁问题：缓存失效、事务锁表，甚至导致本该快速的读接口变得异常缓慢。
- Query Handler 只负责读：应该使用
IUserReadRepository这类只读仓储，或者至少用DbSet.AsNoTracking()来确保不跟踪变更。严格禁止任何形式的Sa veChangesAsync调用。 - Command Handler 只负责改状态：它的职责是改变领域状态，通常不应该返回完整的Entity对象（这容易意外触发EF Core的延迟加载或序列化时的循环引用问题）。更合适的做法是返回ID、精简的DTO，或者直接返回
Unit.Value。 - 从设计上就避免混淆：不要让一个Handler类同时实现
IRequestHandler和IRequestHandler。类型系统虽然允许，但这在语义上已经违背了CQRS的核心思想。 - 当然，读写操作可以共用同一个
DbContext实例（只要Scoped生命周期配置合理）。但关键在于，读写逻辑必须在代码层面严格分层，不能仅仅依靠开发者的“自觉”来隔离。
领域事件该用 IPublisher 还是 IMediator
如果你用IMediator.Publish()来发布领域事件，很可能会遇到事务一致性问题。因为IMediator并不感知EF Core的Unit of Work（工作单元），事件可能在数据库事务提交之前就被发出去了，导致数据状态不一致。
- 正确的选择是
IPublisher：这是MediatR专门提供的接口。它与EF Core的事务拦截器可以协同工作，确保事件只在Sa veChangesAsync成功执行后才真正发布出去。 IPublisher本身也是Scoped生命周期，直接从依赖注入容器中获取即可，千万不要自己去new实例。- 注意事件类的定义：它必须继承
INotification，而不是IRequest。对应的Handler则需要实现INotificationHandler。 - 还有一个实践细节：不建议在Command Handler里直接
await _publisher.Publish(...)之后再return。因为事件发布的失败不应该阻塞主业务流程。更稳健的做法是采用fire-and-forget（触发后不管）模式，或者用后台队列来兜底。
最后，需要时刻牢记一点：CQRS的区分，靠的不是类名，而是Handler的实际行为。哪怕你给类起名叫GetUserQuery，只要它在里面调用了Sa veChanges，那它本质上就已经不是一个Query了。这才是理解MediatR和CQRS模式的关键所在。
相关攻略
C ReadOnlySpan 使用指南：高性能只读内存切片优化技巧【高级教程】 在 NET 高性能编程实践中，尤其是在字符串处理场景，一个公认的高效策略是：直接采用 ReadOnlySpan 来替代传统的 string 参数以及中间的 Substring 调用。这是目前实现零分配、低开销处理的最
SQL Server分页首选OFFSET-FETCH，需配合ORDER BY且参数化传值；EF Core用Skip Take自动翻译，避免内存分页；大数据量时应改用游标分页。 SQL Server 中用 OFFSET-FETCH 做分页最直接 说到在SQL Server里做分页，2012及以上版本提
C 万级数据批量插入：SqlBulkCopy 实战精要 在C 中进行大规模数据插入，性能是首要考量。当数据量达到万级甚至更高时，常规的逐条插入方法会迅速成为性能瓶颈。那么，有没有一种既高效又稳定的解决方案呢？答案是肯定的。 用 SqlBulkCopy 实现高速批量插入 开门见山地说，在C 生态中，
C 中使用TestContainers进行集成测试：最佳实践与常见坑点 想在 NET 里玩转 TestContainers？这事儿说简单也简单，说麻烦也麻烦。简单在于，它确实能让你用几行代码就拉起一个数据库或中间件进行测试；麻烦在于，从环境配置到代码编写，每一步都有几个“经典”的坑在等着你。今天，
C WPF Canvas画布绘图完全指南：代码动态绘制图形与连线详解 Canvas直接添加子元素导致错位或不显示的解决方案 许多C 开发者在初次使用WPF Canvas控件进行动态绘图时，常会遇到一个典型问题：为何通过代码添加的Rectangle矩形或Line线条无法正常显示，或者出现位置偏移？
热门专题
热门推荐
iPhone 17：为何成为苹果史上最长寿的爆款？ 最近科技圈有个消息传得挺热：iPhone 17标准版的生产周期被大幅拉长了。这可不是简单的产能调整，背后是苹果近期完成的大规模产能扩展。看来，这款热门机型已经瞄准了今年下半年的双11战场，准备再掀一波销售热潮。 消息一出，不少网友都在猜测原因。矛头
在快节奏的都市生活中，一款兼具便携性与环保特性的出行工具正成为越来越多人的选择 城市通勤的“最后一公里”难题，催生了对灵活出行方案的持续探索。近期，小米有品推出的mini智能电动平衡车，以其独特的设计理念和深度智能化功能，迅速吸引了市场的目光。它不仅仅是一款酷玩装备，更切实地为青少年和上班族提供了高
在数字化教育蓬勃发展的当下，家长们为孩子挑选学习设备时，既希望设备具备护眼功能，又期望能满足多样化的学习需求。传统平板电脑功能虽丰富，但长时间使用易引发视力疲劳；普通学习机功能又相对单一，难以契合现代教育的发展趋势。在此背景下，科大讯飞AI学习机系列凭借先进的护眼技术与智能学习系统，成为众多家长和学
目录 ethzilla是谁？ ETHZilla独特其他ETH DAT之处 1、Peter Thiel持股ETHZilla近30% 2、Vitalik和以太坊基金会入局 3、聚焦DeFi和链上策略 结语 以太坊财库概念的热度，最近真是肉眼可见。伴随着这股热潮，ETH价格也强势突破了4700美元，距离历
全球彩电市场：存量博弈下的冰与火之歌 最近，行业调研机构奥维睿沃（A VC Revo）发布了一份引人关注的报告，揭示了2025年全球彩电市场的真实图景。数据显示，全球彩电整体出货量达到2 64亿台，同比仅微跌0 1%，市场基本盘看似稳固。 然而，拆开来看，内部结构正在发生深刻变化。LCD液晶电视依然