.NET中的CQRS和MediatR模式：构建清晰、可维护的应用架构

新闻中心 NEWS CENTER

您当前位置：首页 > 新闻中心 > 网络学院

.NET中的CQRS和MediatR模式：构建清晰、可维护的应用架构

2025-12-02

浏览次数：次

返回列表

CQRS 将读写操作分离，Commands 负责修改状态，Queries 仅获取数据，结合 MediatR 实现松耦合消息处理，通过定义独立的 Command/Query 消息与 Handler，控制器依赖 IMediator 发送请求，提升代码可维护性与扩展性，适用于业务复杂的中大型项目。

.net中的cqrs和mediatr模式：构建清晰、可维护的应用架构

在现代 .NET 应用开发中，随着业务逻辑日益复杂，如何保持代码的清晰性和可维护性成为关键挑战。CQRS（Command Query Responsibility Segregation）与 MediatR 模式结合使用，提供了一种解耦请求处理流程、提升系统可读性与扩展性的有效方案。这种架构方式将“读取数据”和“修改数据”的操作彻底分离，配合中介者模式实现关注点分离。

什么是 CQRS？

CQRS 的核心思想是将应用程序的读操作（Queries）与写操作（Commands）分开处理：

Commands（命令）：用于修改状态的操作，例如创建订单、更新用户信息。这类操作应返回 void 或结果状态，不应直接返回数据。
Queries（查询）：仅用于获取数据，不产生副作用，例如列出所有用户、查找某个订单详情。

通过这种分离，可以为读写两端设计不同的模型、数据库甚至技术栈。比如写模型使用事务性强的关系库，读模型使用优化过的视图或 NoSQL 存储。

MediatR 如何协助实现 CQRS？

MediatR 是一个轻量级的 .NET 库，实现了中介者（Mediator）模式，允许你以松耦合的方式发送和处理请求。它非常适合配合 CQRS 使用：

每个 Command 或 Query 被定义为一个独立的消息对象。
对应的 Handler 负责处理该消息，实现具体逻辑。
控制器或其他入口只需依赖 IMediator 接口调用 Send 或 SendAsync，无需知道内部如何处理。

这种方式显著降低了模块间的依赖，提升了测试性和可维护性。

实际应用示例

以下是一个简单的用户注册场景实现：

定义 Command：

微信源码微趣能Weiqn

产品介绍微趣能 Weiqn 开源免费的微信公共账号接口系统。MVC框架框架结构清晰、易维护、模块化、扩展性好，性能稳定强大核心－梦有多大核心就有多大，轻松应对各种场景！微趣能系统以关键字应答为中心与内容素材库文本如图片语音视频和应用各类信息整体汇集并且与第三方应用完美结合，强大的前后台管理；人性化的界面设计。开放API接口－灵活多动的API，万名开发者召集中。Weiqn 系统开发者AP

1 查看详情微信源码微趣能Weiqn

public class CreateUserCommand : IRequest<Guid>
{
    public string Name { get; set; }
    public string Email { get; set; }
}

public class CreateUserCommandHandler : IRequestHandler<CreateUserCommand, Guid>
{
    private readonly AppDbContext _context;

    public CreateUserCommandHandler(AppDbContext context)
    {
        _context = context;
    }

    public async Task<Guid> Handle(CreateUserCommand request, CancellationToken ct)
    {
        var user = new User(request.Name, request.Email);
        await _context.Users.AddAsync(user, ct);
        await _context.S*eChangesAsync(ct);
        return user.Id;
    }
}

定义 Query：

public class GetUserByIdQuery : IRequest<UserDto>
{
    public Guid Id { get; set; }
}

public class GetUserByIdQueryHandler : IRequestHandler<GetUserByIdQuery, UserDto>
{
    private readonly AppDbContext _context;

    public GetUserByIdQueryHandler(AppDbContext context)
    {
        _context = context;
    }

    public async Task<UserDto> Handle(GetUserByIdQuery request, CancellationToken ct)
    {
        return await _context.Users
            .Where(u => u.Id == request.Id)
            .Select(u => new UserDto(u.Id, u.Name, u.Email))
            .FirstOrDefaultAsync(ct);
    }
}

在控制器中使用：

[ApiController]
[Route("[controller]")]
public class UsersController : ControllerBase
{
    private readonly IMediator _mediator;

    public UsersController(IMediator mediator)
    {
        _mediator = mediator;
    }

    [HttpPost]
    public async Task<ActionResult<Guid>> Create([FromBody] CreateUserCommand command)
    {
        var id = await _mediator.Send(command);
        return CreatedAtAction(nameof(Get), new { id }, id);
    }

    [HttpGet("{id:guid}")]
    public async Task<ActionResult<UserDto>> Get(Guid id)
    {
        var query = new GetUserByIdQuery { Id = id };
        var user = await _mediator.Send(query);
        if (user == null) return NotFound();
        return Ok(user);
    }
}

整个流程清晰明了，职责分明，新增功能只需添加新的消息和处理器，不影响现有代码。

优势与适用场景

采用 CQRS + MediatR 架构的主要好处包括：

逻辑分层清晰，易于理解与维护。
便于实施横切关注点（如日志、验证、事务），可通过行为管道（Pipeline Beh*iors）统一处理。
支持未来演进，比如引入事件溯源、缓存读模型、分布式处理等。

适合中大型项目或预期会持续增长的系统。对于简单 CRUD 应用，可能引入额外复杂度，需权衡使用。

基本上就这些。合理运用 CQRS 与 MediatR，能让 .NET 项目的结构更整洁，团队协作更顺畅。

以上就是.NET中的CQRS和MediatR模式：构建清晰、可维护的应用架构的详细内容，更多请关注其它相关文章！

# cqrs # 处理器 # mediatr # 天台台州网站建设 # 小麦种子网站建设 # seo网络营销课程 # 网站推广与网站优化实验 # 上饶哪家网站推广好用啊 # seo优化技巧和好处 # 烤乳猪营销推广方案设计 # 苏州抖音营销推广哪靠谱 # SEO监控宠物猫 # 南通网站建设官网推荐 # 相关文章 # 适用于 # 就有 # 文档 # 如何实现 # 何为 # 注册表 # 只需 # 是一个 # .net # 用户注册 # 应用开发 # ai # 栈 # app

相关栏目：【科技资讯46185 】【网络学院92790 】

上一篇：J*aScript插件开发_j*ascript扩展功能

下一篇：Win10怎么开启高性能模式 Win10电源计划设置详解

首页

关于我们

产品展示

咨询研究

新闻中心

留言板

联系我们

新闻中心 NEWS CENTER

.NET中的CQRS和MediatR模式：构建清晰、可维护的应用架构

什么是 CQRS？

MediatR 如何协助实现 CQRS？

实际应用示例

优势与适用场景