当前位置：

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

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

作者：归人云淡风轻时间：2026-07-18 浏览：2

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

作者最新文章

AO3最新可用链接及中文入口汇总 2026-10-29 13:32

coreldraw怎么插入图片图片导入步骤 2026-10-27 15:37

coreldraw快捷键冲突怎么改自定义按键解决 2026-10-24 08:50

AO3中文界面设置指南与核心功能使用教程 2026-10-14 23:28

解决win10运行3DMAX自动重启的方法 2026-10-13 17:08

编程开发 C#

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

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

相关文章更多

winforms教程自学入门与基础开发步骤详解

新手教程 C#

09.25

谈编程与编程语言

07.21

什么是面向接口编程、面向过程编程、面向对象编程？

JavaScript C#

07.21

我对编程的一些感悟

Java C#

07.21

c#如何使用abstract类_c#abstract类看这一篇就够了_保姆级教程

07.20

c#如何删除文件_c#删除文件的正确用法与注意事项

07.20

c#如何使用EmguCV_c#EmguCV的最佳实践与常见坑点

07.20

C#怎么实现图表生成 C#如何用LiveCharts和OxyPlot绘制柱状图折线图饼图【图表】

07.20

C#怎么实现过滤器Filter_C# ASP.NET Core过滤器详解教程【进阶】

07.20

c#如何实现鼠标钩子_c#鼠标钩子完整教程与实战案例

07.20

c#如何使用Log4Net_c#Log4Net完整教程与代码实例

07.20

c#如何使用Dictionary字典_c#Dictionary字典项目实例附完整源码

07.20

热门文章更多

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

精品专题更多

装机必备

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

Windows

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

PDF教程

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

macOS软件

正软商城macOS软件专区，精选适用于Mac电脑的办公、设计、影音、效率、开发和系统工具，提供软件功能介绍、macOS兼容版本、正版授权及购买下载服务。

IOS软件

正软商城iOS软件专区，精选适用于iPhone和iPad的办公、学习、影音、设计、效率及AI应用，提供功能介绍、适用设备、系统要求和正版获取方式等信息。

正软商城AI软件专区，汇集AI写作、AI绘画、AI视频、AI办公、AI编程、AI翻译、智能客服和数据分析等人工智能工具，提供功能介绍、适用平台、收费方式及正版购买信息。

Mac软件更多

Aperty macOS版

Aperty 是 Skylum 推出的 AI 人像修图软件，支持自然肤质修饰、瑕疵处理、面部与身体调整、预设及批量同步。

批量处理人像修图 AI修图 Aperty

火山引擎网页版

火山引擎是字节跳动旗下企业级云与AI服务平台。聚焦大模型核心能力，依托字节自研豆包多模态大模型，凭借火山方舟一站式平台，提供模型精调、推理部署、智能应用搭建等全链路服务，结合高性能AI算力，助力各行业快速落地大模型数字化与智能化应用。

云服务 AI开发火山引擎

立刻MV 网页版

立刻MV 面向音乐人、内容创作者和品牌团队，帮助用户低成本完成歌曲 MV、歌词视频、AI 分镜、图生视频与最终合成。

AI视频立刻MV

蛙蛙写作网页版

蛙蛙写作 AI 创作工具，覆盖小说、剧本、文案，一键生成文稿，打通文字转视频全流程，高效解决创作难题。

蛙蛙写作本月促销

讯飞智作网页版

讯飞智作是一款基于语音合成技术、虚拟人驱动技术与数字人形象声音构建能力的 AI 数字人音视频创作平台。

AI视频

超级简历WonderCV 网页版

超级简历WonderCV是面向应届生和AI小白的智能求职平台，覆盖简历、面试与职业规划。

超级简历本月促销

音述AI 网页版

音述AI，是一个以“用声音述说故事”为核心的 AI 音乐创作与声音分享社区。

音述AI

AionClaw macOS版

AionClaw 是可在桌面端运行的任务型 AI 助手，通过数字专家与技能市场组合办公、创作、数据和开发能力。

AI助手

Loomy macOS版

Loomy 是科大讯飞推出的桌面 AI 助手，可通过对话、任务与工作目录协助处理办公、内容创作和资料整理。

AI助手

AirBuddy 3 macOS版

AirBuddy 3 是面向 macOS 的蓝牙外设增强工具，可集中查看 AirPods、Beats 与苹果设备电量，提供快速连接、播放控制、电量提醒、桌面小组件和多台 Mac 外设接力等功能。

AirServer macOS版

AirServer macOS版可把 Mac 转换为无线投屏接收端，通过 AirPlay 或 Google Cast 接收手机、平板和电脑画面，并支持多设备同时连接、高清镜像及会话录制，适合家庭娱乐、课堂教学、会议演示和应用展示。

AnyDesk macOS版

AnyDesk macOS版是一款适用于远程办公、设备维护和客户支持的远程桌面工具，可连接并操作异地计算机，支持文件传输、无人值守访问、会话权限控制及跨平台协作。

远程控制 AnyDesk

WINDOWS 更多

讯飞绘文网页版

讯飞绘文网页版是科大讯飞推出的AI图文创作与内容运营工具，覆盖热点选题、文章生成、稿件校对、智能配图、排版发布和数据复盘等环节，适合自媒体创作者及内容团队在线使用。

讯飞绘文

Maya（Autodesk Maya） Windows版

Autodesk Maya 是面向影视、电视、动画和游戏行业的专业三维制作软件，集多边形与 NURBS 建模、角色绑定、关键帧和动作捕捉动画、Bifrost 特效模拟、材质开发及 Arnold 渲染于一体，

动画动画制作视频剪辑三维建模影视后期

Aperty Windows版

Aperty 是 Skylum 推出的 AI 人像修图软件，支持自然肤质修饰、瑕疵处理、面部与身体调整、预设及批量同步。

批量处理人像修图 AI修图 Aperty

火山引擎网页版

云服务 AI开发火山引擎

立刻MV 网页版

立刻MV 面向音乐人、内容创作者和品牌团队，帮助用户低成本完成歌曲 MV、歌词视频、AI 分镜、图生视频与最终合成。

AI视频立刻MV

蛙蛙写作网页版

蛙蛙写作 AI 创作工具，覆盖小说、剧本、文案，一键生成文稿，打通文字转视频全流程，高效解决创作难题。

蛙蛙写作本月促销

讯飞智作网页版

讯飞智作是一款基于语音合成技术、虚拟人驱动技术与数字人形象声音构建能力的 AI 数字人音视频创作平台。

AI视频

超级简历WonderCV 网页版

超级简历WonderCV是面向应届生和AI小白的智能求职平台，覆盖简历、面试与职业规划。

超级简历本月促销

音述AI 网页版

音述AI，是一个以“用声音述说故事”为核心的 AI 音乐创作与声音分享社区。

音述AI

AionClaw Windows版

AionClaw 是可在桌面端运行的任务型 AI 助手，通过数字专家与技能市场组合办公、创作、数据和开发能力。

AI助手

Loomy Windows版

Loomy 是科大讯飞推出的桌面 AI 助手，可通过对话、任务与工作目录协助处理办公、内容创作和资料整理。

AI助手

AirServer Windows版

AirServer Windows版可把电脑变成AirPlay、Google Cast和Miracast无线投屏接收端，适合会议演示、课堂教学及家庭大屏分享。发送设备通常无需另装客户端，并可同时接收和智能排列多个镜像会话。