当前位置：

首页 > 编程开发 > C#怎么实现CQRS模式_C# MediatR命令查询分离教程【高级】

C#怎么实现CQRS模式_C# MediatR命令查询分离教程【高级】

作者：归人云淡风轻时间：2026-07-18 来源：正软商城浏览：0

MediatR实现CQRS时，命令继承无泛型IRequest，查询继承IRequest；事务手动管理，DbContext用Scoped注入；INotification仅用于非关键异步通知；查询Handler通过构造函数注入DbContext并启用AsNoTracking()，避免直接new。

MediatR中命令与查询须严格分离：命令继承`IRequest`（无泛型），用`IRequestHandler`；查询继承`IRequest`，用`IRequestHandler`；事务需手动管理，`DbContext`必须Scoped注入；`INotification`仅用于非关键异步通知；查询严禁`new DbContext`，须构造注入并`AsNoTracking()`。

CQRS的落地实践中，MediatR是最常用的工具之一。但工具越顺手，越容易踩坑——很多人写着写着，命令和查询就开始“暧昧不清”，事务也管得稀里糊涂。今天就把几个最核心的陷阱和应对方案掰开揉碎了说清楚。

接口签名：命令和查询的“身份边界”

MediatR里，`IRequestHandler`和`IRequestHandler`是两个截然不同的接口，用错了不会编译报错，但运行时的行为会让你摸不着头脑。比如一个本该无返回的命令（例如删除操作），你随手给它写了`Task`的处理器，MediatR会尝试序列化这个返回值，而调用方很可能忽略它——逻辑上的错觉就埋下了。实操上怎么区分？ - **命令（Command）**：继承`IRequest`（不带泛型），处理器实现`IRequestHandler`。返回类型推荐用`Task`，比`Task`语义更清晰，一看就知道“这事儿干完了，没数据要回”。 - **查询（Query）**：继承`IRequest`，处理器必须实现`IRequestHandler`。这里的`TResponse`绝对不能是`void`。 - 别为了“统一API风格”而强行让所有请求都带上返回类型。CQRS的核心是职责分离，不是形式上的统一。命令就是命令，查询就是查询，各走各的道。

事务管理：别指望Send()自带原子性

一个常见的误解是：用了MediatR的`Send()`，命令执行和数据库提交就天然有了原子性。醒醒，`Send()`只是个管道调度器，事务得自己动手管。最容易翻车的地方有两个：一是在Handler里直接`new DbContext()`，二是依赖注入的上下文没配对生命周期，导致事务跨Handler泄露或失效。正确的做法并不复杂： - 注册`DbContext`时，老老实实用`AddDbContext(ServiceLifetime.Scoped)`，确保每个请求周期内是同一个实例。 - 事务的控制权放在Web API层——比如Controller或Minimal API的endpoint里。用`context.Database.BeginTransaction()`包住`mediator.Send()`调用，而不是在Handler内部开事务。 - 如果多个Handler需要协同完成一个事务（典型场景：创建订单 + 扣库存），它们必须共享同一个`DbContext`实例。这依赖DI容器的Scoped生命周期正确传递，而不是每个Handler各自去解析一个新实例。

INotification：是“广播”不是“命令通道”

新手容易把领域事件（比如`OrderCreatedNotification`）当成查询结果或命令副作用的标配通道，甚至幻想它能保证执行顺序或参与事务。但`INotification`本质上是个发布-订阅机制——无返回值、不保证顺序、默认异步fire-and-forget，典型的一次性通知。所以它的适用范围很窄：非关键路径的衍生操作。比如发邮件、写日志、更新搜索索引。这些事情晚几秒甚至丢一两条，系统都能容忍。有几个绝对不能做的事情： - 不要在`INotificationHandler`里修改聚合根或触发另一条命令。一旦这么干，流程就变得不可控，测试也成了噩梦，CQRS的边界形同虚设。 - 如果有强一致性的需求（比如“扣款成功后必须同步更新余额视图”），那应该由主命令的Handler显式调用写入服务，或者用事务性发件箱（Outbox pattern）来处理。依赖`MediatR.Publish()`是想多了。

查询Handler里的new DbContext：隐蔽的性能冲击波

有人图省事，在查询Handler里直接写`using var context = new AppDbContext(...)`。看起来简单安全，实际上这是性能雷区——绕过DI生命周期管理，连接池滥用、上下文释放不及时、并发下状态污染，问题一串串。更隐蔽的是，它让查询享受不到EF Core的变更跟踪优化。比如同一请求内多次查同一个实体，Scoped上下文本来可以复用实例，结果每次都重新创建，白白浪费。解决方案很直接： - 所有Handler一律通过构造函数注入`DbContext`，确保和请求生命周期一致。 - 查询类Handler要显式标记`AsNoTracking()`——除非你真的打算后续再Update。这一行代码能省掉大量内存和性能开销。 - 还有个常见低级错误：先`.ToList()`或`.Count()`拉数据到内存，再在内存里做LINQ过滤。EF Core没办法把后续操作转成SQL，最终全量加载，性能直接拉胯。说到底，CQRS真正难的不是写几个Handler，而是守住命令与查询的物理隔离。数据库连接、缓存策略、异常处理粒度、监控指标埋点——通通要按角色区分对待。一旦在查询Handler里写了`Sa veChangesAsync()`，或者让命令返回DTO给前端渲染，CQRS就已经退化成普通分层架构了。

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

作者最新文章

NetLimiter安装配置方法及详细操作步骤教程 2026-10-09 15:54

win10怎么只关闭大版本升级保留安全更新推送 2026-10-06 12:00

3ds Max修改器堆栈顺序对模型的影响及调整技巧 2026-10-04 12:33

荣耀MagicOS 11发布计划与Agent Harness架构解析 2026-09-08 19:23

AI重构企业业务架构：超聚变“智企”范式核心解析 2026-09-08 18:39

编程开发 C#

上一篇： c#如何将时间戳转为日期_c#时间戳转为日期看这一篇就够了

下一篇： C#怎么实现忽略大小写的字符串比较_C#如何设置比较规则【必备】

相关文章更多

codex安装windows教程桌面版完整安装步骤指南

详解如何在 Windows 电脑上通过 Microsoft Store 安装 Codex 桌面应用，包括启动登录、切换 Codex 模式、关联本地代码项目及终端环境配置的界面操作指引。

2026-10-12 1 别着急山茶

Windows Windows安装

github配置ssh key windows

本文详解如何在Windows环境中使用PowerShell生成SSH密钥对，配置ssh-agent自动加载私钥，并将公钥安全添加至GitHub账户，最后通过git remote set-url切换为SSH地址，解决每次操作需输入账号密码的问题。

2026-10-12 2 咖啡加糖

Windows

backdrop和background区别

深入解析backdrop与background在网页开发及视觉设计中的区别。通过CSS代码示例，展示如何正确使用background设置元素背景，以及利用backdrop-filter创建弹窗遮罩模糊效果，避免概念混用。

2026-10-12 0 故里林间听风

windsurf ide download Windows版安装教程

详解 Windsurf IDE 在 Windows 系统的下载来源、安装步骤及首次启动界面。指导用户如何导入编辑器设置、打开项目文件夹及使用终端与 AI 功能，适合初次接触该工具的开发者阅读。

2026-10-11 1 CalmTime

Windows

ServBay安装配置详细教程与操作指南

新手入门 ServBay 本地开发环境，详解安装包下载、Dashboard 状态监控、Packages 组件安装、Services 服务控制及 Websites 项目配置。掌握 .servbay.config 版本管理与日志排查技巧，快速搭建稳定的 PHP、Node.js 等多语言开发环境。

2026-10-10 1 SimplePath

codekit环境配置指南从安装到环境搭建完整教程

详解 CodeKit 在 macOS 下的安装步骤、项目导入方法、Sass与JavaScript编译设置及浏览器自动刷新功能，助您快速搭建高效的前端开发环境。

2026-10-09 2 SoftHope

codex安装windows 命令行完整操作教程

详解Windows环境下安装OpenAI Codex CLI的步骤，包括WSL环境检查、Node.js/npm配置、npm全局安装命令及首次启动验证，适合开发者快速上手。

2026-10-08 6 沐风冬青

Windows Windows安装

NativeRest环境配置要求与完整操作教程

学习如何配置 NativeRest REST API 客户端。涵盖 Windows/macOS/Linux 安装后的工作区创建、环境变量管理、请求编辑及响应查看步骤，帮助开发者快速完成基础环境搭建与连通性测试。

2026-10-08 5 山青青路漫漫

CSS设置透明度的注意事项有哪些？opacity属性详解

深入解析CSS中设置透明度的核心属性opacity，剖析子元素继承、事件穿透、层叠上下文等关键注意事项，并提供与rgba、hsla的实用选型对比。

2026-10-08 4 归人

flutter页面传值到后台的方法及示例代码

flutter页面传值到后台的完整实现方法及示例代码，帮助读者快速掌握相关技术要点。

2026-10-08 6 SimpleMoon

Flutter 后台

热门文章更多

Photoshop蒙版换证件照背景颜色怎么改？实用操作步骤详解 AutoCAD绘制机械零件三维实体详细教程 AE教程书籍挑选指南：零基础、动效与合成方向实战标准 Photoshop图层合并快捷键是什么？合并盖印及分开图层方法 Photoshop日系调色教程：小清新风格参数与思路

精品专题更多

装机必备

正软商城装机必备专区，精选办公、浏览器、安全防护、影音播放、压缩解压、设计创作和系统工具等电脑常用正版软件，帮助用户快速完成新电脑软件配置。

Windows

正软商城Windows软件专区，汇集适用于Windows电脑的办公、设计、安全防护、影音播放、开发工具和系统优化软件，提供软件介绍、系统要求、正版授权及购买下载服务。

PDF教程

正软商城PDF教程频道提供PDF编辑、转换、合并、拆分、压缩及格式处理方法，同时介绍常用PDF软件和工具的使用技巧。

Mac软件更多

WPS Office macOS版

macOS

WPS Office是一款面向macOS用户的综合办公套件，将文字处理、电子表格、演示文稿、PDF工具、模板与云协作整合在同一应用中。它兼容常见Microsoft Office格式，支持Intel及Apple芯片Mac，基础功能可免费使用，

Shapr3D macOS版

Mac

Shapr3D是一款面向工业设计、机械工程、建筑概念和三维打印工作流的CAD软件。Mac版采用Parasolid建模内核，支持草图约束、实体建模、工程图、可视化渲染及常见CAD格式交换，并可通过账户在多台设备之间同步项目。

REAPER macOS版

Mac

REAPER是Cockos开发的数字音频工作站，提供多轨音频与MIDI录制、剪辑、处理、混音和母带制作工具。Mac版兼容Intel与Apple芯片，支持AU、VST、VST3、CLAP等插件格式，并提供高度可定制的工作流程。

WINDOWS 更多

Adobe Photoshop Windows版

Windows

Adobe Photoshop 是面向摄影师、设计师和内容创作者的专业图像处理工具，可在 Windows 上完成照片修饰、选区抠图、图层合成、文字排版、绘画及生成式编辑。软件采用订阅授权，由 Creative Cloud 管理安装、更新与许

Adobe InDesign Windows版

Windows

Adobe InDesign 是面向印刷与数字出版的专业页面排版工具，可制作书籍、杂志、宣传册、海报、交互式 PDF 和电子书。它提供精细的文字样式、多页面管理、印前检查及多格式输出能力，并能与 Photoshop、Illustrator

Adobe Illustrator Windows版

Windows

Adobe Illustrator 是用于绘制矢量图形、插画、图标、徽标和版式的专业设计工具。它以路径和锚点为核心，作品放大后仍能保持清晰，并提供画板、文字、渐变、图像描摹及精确变换等功能，适合品牌视觉、印刷物料、数字界面和商业插画创作。