C# MediatR使用方法 C#如何实现CQRS模式

发布时间 - 2026-01-25 00:00:00    点击率:
MediatR 初始化必须注册 IMediator 接口,否则注入时抛 InvalidOperationException;ASP.NET Core 6+ 用 AddMediatR(),跨类库需显式传入程序集;IRequest 用于无返回值操作,IRequest 用于需返回值场景;Handler 必须严格匹配泛型参数;CQRS 核心是职责与模型隔离,非仅命名;管道行为适合横切逻辑但需注意执行顺序与异常处理;数据一致性策略才是 CQRS 复杂所在。

MediatR 初始化必须注册 IMediator 接口

不注册 IMediator 就直接注入会报 InvalidOperationException: Unable to resolve service for

type 'MediatR.IMediator'。ASP.NET Core 6+ 默认用 AddMediatR() 扩展方法,但要注意参数——它默认只扫描当前程序集,跨类库时得显式传入程序集:

  • 单项目:直接 services.AddMediatR(cfg => cfg.RegisterServicesFromAssembly(typeof(Program).Assembly));
  • 命令/查询/处理逻辑在独立类库中:必须把对应程序集加进去,比如 AddMediatR(typeof(CreateUserCommandHandler).Assembly)
  • 别漏掉 using MediatR;,否则 AddMediatR 方法不可见

IRequest 和 IRequest 的选择取决于是否需要返回值

写请求类时,用 IRequest 表示“只发不收”(如发送邮件、触发日志),用 IRequest 表示“发完要等结果”(如查用户、生成订单号)。选错会导致编译失败或运行时报 Cannot convert lambda expression 类型错误:

  • 无返回值示例:public record CreateUserCommand(string Name) : IRequest;
  • 有返回值示例:public record GetUserQuery(Guid Id) : IRequest;
  • Handler 类必须严格匹配泛型参数:public class GetUserQueryHandler : IRequestHandler

CQRS 分离的关键不是命名,而是职责和生命周期

很多人以为只要把类名写成 “Query/Command” 就算 CQRS,其实核心是:查询不改状态、命令不返回领域数据、读写模型物理隔离(哪怕一开始共用 EF Core DbContext)。常见踩坑点:

  • IRequestHandler 里调用 _context.SaveChanges() —— 这属于命令逻辑,不该出现在 Query Handler 中
  • Query Handler 返回 Entity 而非 DTO,导致序列化时触发 EF 延迟加载或循环引用
  • 所有 Handler 都用同一个 DbContext 实例(Scoped 生命周期),但没做读写分离配置,缓存/事务行为容易互相干扰

MediatR 管道行为(Pipeline Behavior)适合横切逻辑,但别滥用

比如日志、验证、权限检查,用 IPipelineBehavior 比在每个 Handler 里重复写更干净。但要注意执行顺序和异常传播:

  • 多个 Behavior 按注册顺序“套娃”,先注册的在外层;想让验证最先执行,就第一个 AddTransient
  • 在 Behavior 中 throw 异常会中断后续 Handler,但 ValidationException 不该被吞掉,否则前端拿不到具体错误字段
  • 不要在 Behavior 里 new DbContext 或手动管理事务——它可能跨多个 Handler,而事务应由最外层命令控制
CQRS 的真正复杂点不在 MediatR 怎么配,而在读写模型的数据一致性策略:是用事件总线最终一致,还是同步双写,抑或共享数据库但分 Schema。这些决策会影响 Handler 里要不要发事件、要不要加重试、要不要补偿逻辑——而 MediatR 本身只负责调用链路,不解决这些问题。


# 前端  # c#  # 延迟加载  # .net  # String  # for  # throw  # 循环  # Lambda  # 接口  # using  # class  # public  # 泛型  # 事件  # typeof  # 数据库  # 返回值  # 多个  # 类库  # 会报  # 但要  # 要不要  # 横切  # 第一个  # 才是  # 出现在 


相关栏目: 【 网站优化151355 】 【 网络推广146373 】 【 网络技术251813 】 【 AI营销90571


相关推荐: Laravel怎么调用外部API_Laravel Http Client客户端使用  JS实现鼠标移上去显示图片或微信二维码  西安市网站制作公司,哪个相亲网站比较好?西安比较好的相亲网站?  公司网站制作价格怎么算,公司办个官网需要多少钱?  网易LOFTER官网链接 老福特网页版登录地址  Bootstrap整体框架之CSS12栅格系统  php打包exe后无法访问网络共享_共享权限设置方法【教程】  个人网站制作流程图片大全,个人网站如何注销?  Laravel控制器是什么_Laravel MVC架构中Controller的作用与实践  phpredis提高消息队列的实时性方法(推荐)  大型企业网站制作流程,做网站需要注册公司吗?  bing浏览器学术搜索入口_bing学术文献检索地址  Laravel storage目录权限问题_Laravel文件写入权限设置  如何在 React 中条件性地遍历数组并渲染元素  javascript中对象的定义、使用以及对象和原型链操作小结  Laravel如何生成URL和重定向?(路由助手函数)  高端建站如何打造兼具美学与转化的品牌官网?  清除minerd进程的简单方法  如何基于PHP生成高效IDC网络公司建站源码?  Laravel N+1查询问题如何解决_Eloquent预加载(Eager Loading)优化数据库查询  Laravel怎么进行浏览器测试_Laravel Dusk自动化浏览器测试入门  在centOS 7安装mysql 5.7的详细教程  如何快速搭建高效WAP手机网站?  javascript中的try catch异常捕获机制用法分析  黑客入侵网站服务器的常见手法有哪些?  Laravel如何与Pusher实现实时通信?(WebSocket示例)  Laravel如何使用Contracts(契约)进行编程_Laravel契约接口与依赖反转  Edge浏览器如何截图和滚动截图_微软Edge网页捕获功能使用教程【技巧】  图册素材网站设计制作软件,图册的导出方式有几种?  🚀拖拽式CMS建站能否实现高效与个性化并存?  Laravel Vite是做什么的_Laravel前端资源打包工具Vite配置与使用  如何自己制作一个网站链接,如何制作一个企业网站,建设网站的基本步骤有哪些?  音响网站制作视频教程,隆霸音响官方网站?  Laravel如何实现登录错误次数限制_Laravel自带LoginThrottles限流配置【方法】  jQuery中的100个技巧汇总  HTML透明颜色代码怎么让图片透明_给img元素加透明色的技巧【方法】  简单实现Android文件上传  Laravel模型关联查询教程_Laravel Eloquent一对多关联写法  瓜子二手车官方网站在线入口 瓜子二手车网页版官网通道入口  SQL查询语句优化的实用方法总结  网站制作软件有哪些,制图软件有哪些?  Laravel如何自定义错误页面(404, 500)?(代码示例)  iOS正则表达式验证手机号、邮箱、身份证号等  邀请函制作网站有哪些,有没有做年会邀请函的网站啊?在线制作,模板很多的那种?  canvas 画布在主流浏览器中的尺寸限制详细介绍  三星、SK海力士获美批准:可向中国出口芯片制造设备  详解Android——蓝牙技术 带你实现终端间数据传输  在线ppt制作网站有哪些软件,如何把网页的内容做成ppt?  韩国代理服务器如何选?解析IP设置技巧与跨境访问优化指南  Laravel如何设置定时任务(Cron Job)_Laravel调度器与任务计划配置