基于 ABP vNext + CQRS + MediatR 构建高可用与高性能微服务系统：从架构设计到落地实战

Kookoos2025-05-22 8:49

🧠 基于 ABP vNext + CQRS + MediatR 构建高可用与高性能微服务系统：从架构设计到落地实战

目录

  • [🧠 基于 ABP vNext + CQRS + MediatR 构建高可用与高性能微服务系统：从架构设计到落地实战](#🧠 基于 ABP vNext + CQRS + MediatR 构建高可用与高性能微服务系统：从架构设计到落地实战)
    • [🧰 模块结构概览](#🧰 模块结构概览)
    • [📦 各模块注册代码示例](#📦 各模块注册代码示例)
    • [🧱 架构图 & 概念说明](#🧱 架构图 & 概念说明)
    • [✍️ 核心代码实践](#✍️ 核心代码实践)
      • [1. 聚合根 & 仓储接口](#1. 聚合根 & 仓储接口)
      • [2. CacheKeys 常量](#2. CacheKeys 常量)
      • [3. 命令 + 验证器 + 幂等处理](#3. 命令 + 验证器 + 幂等处理)
      • [4. Pipeline 行为示意图](#4. Pipeline 行为示意图)
      • [5. ValidationBehavior + LoggingBehavior](#5. ValidationBehavior + LoggingBehavior)
      • [6. 查询缓存 + 布隆过滤器](#6. 查询缓存 + 布隆过滤器)
      • 部署架构示意图
    • [🧪 自动化测试示例（Testcontainers）](#🧪 自动化测试示例（Testcontainers）)
    • [📦 Docker Compose](#📦 Docker Compose)

🧰 模块结构概览

复制代码 
Abp.CqrsDemo
├── src
│   ├── Abp.CqrsDemo.Domain
│   ├── Abp.CqrsDemo.Application
│   ├── Abp.CqrsDemo.HttpApi
│   └── Abp.CqrsDemo.DbMigrator
└── tests
    └── Abp.CqrsDemo.Tests
  • Domain：实体、聚合根、领域事件、仓储接口
  • Application：命令、查询、MediatR 处理器、DTO、Pipeline Behaviors、CacheKeys
  • HttpApi：控制器、外部配置绑定
  • DbMigrator：数据库初始化与迁移工具

📦 各模块注册代码示例

DomainModule

csharp 复制代码 
[DependsOn(typeof(AbpDddDomainModule))]
public class CqrsDemoDomainModule : AbpModule
{
}

ApplicationModule

csharp 复制代码 
[DependsOn(typeof(CqrsDemoDomainModule))]
public class CqrsDemoApplicationModule : AbpModule
{
    public override void ConfigureServices(ServiceConfigurationContext context)
    {
        // CQRS & Validation
        context.Services.AddMediatR(typeof(CqrsDemoApplicationModule).Assembly);
        context.Services.AddValidatorsFromAssembly(typeof(CqrsDemoApplicationModule).Assembly);

        // Pipeline Behaviors
        context.Services.AddTransient(typeof(IPipelineBehavior<,>), typeof(ValidationBehavior<,>));
        context.Services.AddTransient(typeof(IPipelineBehavior<,>), typeof(LoggingBehavior<,>));

        // 分布式缓存注册（Application 层即可依赖）
        context.Services.AddDistributedCache<OrderDto>();
    }
}

HttpApiModule

csharp 复制代码 
[DependsOn(typeof(CqrsDemoApplicationModule))]
public class CqrsDemoHttpApiModule : AbpModule
{
    public override void ConfigureServices(ServiceConfigurationContext context)
    {
        var configuration = context.Services.GetConfiguration();

        // Redis 连接与缓存
        context.Services.AddStackExchangeRedisCache(options =>
        {
            options.Configuration = configuration["Redis:Connection"];
        });

        // 控制器托管
        context.Services.AddControllers();
    }
}

DbMigratorModule

csharp 复制代码 
[DependsOn(typeof(AbpEntityFrameworkCoreModule))]
public class CqrsDemoDbMigratorModule : AbpModule
{
    public override void ConfigureServices(ServiceConfigurationContext context)
    {
        context.Services.AddAbpDbContext<CqrsDemoDbContext>(options =>
        {
            options.AddDefaultRepositories(includeAllEntities: true);
        });

        // 设置 EF Core 数据库提供者
        Configure<AbpDbContextOptions>(options =>
        {
            options.UseSqlServer(); // 或 UseNpgsql()
        });
    }
}

🧱 架构图 & 概念说明

Command/Query API 控制器 MediatR Dispatcher CommandHandler QueryHandler EFCore 写库 Redis 查询缓存

  • 命令 负责状态更改
  • 查询 可接入 Redis 或 读库
  • Pipeline：Validation → Logging → Handler

✍️ 核心代码实践

1. 聚合根 & 仓储接口

csharp 复制代码 
public class Order : AggregateRoot<Guid>
{
    public string ProductId { get; private set; }
    public int Quantity { get; private set; }

    protected Order() { } // EF Core 兼容

    public Order(Guid id, string productId, int quantity)
    {
        Id = id;
        ProductId = productId;
        Quantity = quantity;
    }

    // 业务规则示例
    public void ChangeQuantity(int newQty)
    {
        if (newQty <= 0) throw new BusinessException("Quantity must be positive");
        Quantity = newQty;
    }
}

public interface IOrderRepository : IRepository<Order, Guid>
{
}

2. CacheKeys 常量

csharp 复制代码 
public static class CacheKeys
{
    public const string OrderById = "order:{0}";
}

3. 命令 + 验证器 + 幂等处理

csharp 复制代码 
public record CreateOrderCommand(Guid OrderId, string ProductId, int Quantity) : IRequest<Guid>;

public class CreateOrderValidator : AbstractValidator<CreateOrderCommand>
{
    public CreateOrderValidator()
    {
        RuleFor(x => x.ProductId).NotEmpty();
        RuleFor(x => x.Quantity).GreaterThan(0);
    }
}

public class CreateOrderHandler : IRequestHandler<CreateOrderCommand, Guid>
{
    private readonly IOrderRepository _repo;
    private readonly IDistributedIdempotencyService _idempotency;

    public CreateOrderHandler(IOrderRepository repo, IDistributedIdempotencyService idempotency)
    {
        _repo = repo;
        _idempotency = idempotency;
    }

    public async Task<Guid> Handle(CreateOrderCommand request, CancellationToken ct)
    {
        return await _idempotency.ExecuteAsync(request.OrderId.ToString(), async () =>
        {
            var order = new Order(request.OrderId, request.ProductId, request.Quantity);
            await _repo.InsertAsync(order, cancellationToken: ct);
            return order.Id;
        });
    }
}

4. Pipeline 行为示意图

Client PipelineBehaviors Handler Send Request ValidationBehavior LoggingBehavior Handle Command/Query Return Response Client PipelineBehaviors Handler

5. ValidationBehavior + LoggingBehavior

csharp 复制代码 
public class ValidationBehavior<TRequest, TResponse> : IPipelineBehavior<TRequest, TResponse>
    where TRequest : notnull
{
    private readonly IEnumerable<IValidator<TRequest>> _validators;
    public ValidationBehavior(IEnumerable<IValidator<TRequest>> validators) => _validators = validators;

    public async Task<TResponse> Handle(TRequest request, RequestHandlerDelegate<TResponse> next, CancellationToken ct)
    {
        var context = new ValidationContext<TRequest>(request);
        var results = await Task.WhenAll(
            _validators.Select(v => v.ValidateAsync(context, ct))
        );
        var failures = results.SelectMany(r => r.Errors).Where(f => f != null).ToList();
        if (failures.Any()) throw new ValidationException(failures);
        return await next();
    }
}

public class LoggingBehavior<TRequest, TResponse> : IPipelineBehavior<TRequest, TResponse>
{
    private readonly ILogger<LoggingBehavior<TRequest, TResponse>> _logger;
    public LoggingBehavior(ILogger<LoggingBehavior<TRequest, TResponse>> logger) => _logger = logger;

    public async Task<TResponse> Handle(TRequest request, RequestHandlerDelegate<TResponse> next, CancellationToken ct)
    {
        _logger.LogInformation("Handling {Request} with payload: {@Payload}", typeof(TRequest).Name, request);
        var sw = Stopwatch.StartNew();
        var response = await next();
        sw.Stop();
        _logger.LogInformation("Handled {Request} in {Elapsed}ms with response: {@Response}", typeof(TRequest).Name, sw.ElapsedMilliseconds, response);
        return response;
    }
}

6. 查询缓存 + 布隆过滤器

csharp 复制代码 
public class GetOrderByIdHandler : IRequestHandler<GetOrderByIdQuery, OrderDto>
{
    private readonly IOrderRepository _repo;
    private readonly IDistributedCache<OrderDto> _cache;
    private readonly IBloomFilter _bloomFilter;

    public GetOrderByIdHandler(
        IOrderRepository repo,
        IDistributedCache<OrderDto> cache,
        IBloomFilter bloomFilter)
    {
        _repo = repo;
        _cache = cache;
        _bloomFilter = bloomFilter;
    }

    public async Task<OrderDto> Handle(GetOrderByIdQuery request, CancellationToken ct)
    {
        if (!_bloomFilter.Contains(request.OrderId))
            throw new EntityNotFoundException(typeof(Order), request.OrderId);

        var cacheKey = string.Format(CacheKeys.OrderById, request.OrderId);
        return await _cache.GetOrAddAsync(
            cacheKey,
            async () =>
            {
                var order = await _repo.FindAsync(request.OrderId, ct);
                if (order == null) throw new EntityNotFoundException(typeof(Order), request.OrderId);
                return new OrderDto(order.Id, order.ProductId, order.Quantity);
            },
            options =>
            {
                options.SlidingExpiration = TimeSpan.FromMinutes(5);
                options.AbsoluteExpirationRelativeToNow = TimeSpan.FromHours(1);
            }
        );
    }
}

```markdown

---

## 🚀 部署与运行（Program.cs）

```csharp
var builder = WebApplication.CreateBuilder(args);
var config = builder.Configuration;

// 外部化配置
builder.Host.ConfigureAppConfiguration((ctx, cfg) =>
{
    cfg.AddJsonFile("appsettings.json", optional: false, reloadOnChange: true)
       .AddEnvironmentVariables();
});

// EF Core & DbContext
builder.Services.AddAbpDbContext<CqrsDemoDbContext>(options =>
{
    options.AddDefaultRepositories();
});
builder.Services.Configure<AbpDbContextOptions>(options =>
    options.UseSqlServer(config.GetConnectionString("Default")));

// Redis 缓存 & 布隆过滤器
builder.Services.AddStackExchangeRedisCache(opts =>
    opts.Configuration = config["Redis:Connection"]);
builder.Services.AddSingleton<IBloomFilter>(_ =>
    new BloomFilter(expectedItemCount: 10000, falsePositiveRate: 0.01));

// Health Checks
builder.Services.AddHealthChecks()
    .AddDbContextCheck<CqrsDemoDbContext>("Database")
    .AddRedis(config["Redis:Connection"], name: "Redis");

// Polly HTTP 客户端
builder.Services.AddHttpClient("order")
    .AddTransientHttpErrorPolicy(p => p.WaitAndRetryAsync(3, i => TimeSpan.FromSeconds(Math.Pow(2, i))))
    .AddTransientHttpErrorPolicy(p => p.CircuitBreakerAsync(5, TimeSpan.FromSeconds(30)));

var app = builder.Build();
app.MapHealthChecks("/health/live", new HealthCheckOptions { Predicate = _ => false });
app.MapHealthChecks("/health/ready");

app.MapControllers();
app.Run();

部署架构示意图

HTTP Route Read/Write Cache Client Ingress/Nginx API Pods PostgreSQL Redis

🧪 自动化测试示例（Testcontainers）

csharp 复制代码 
using DotNet.Testcontainers.Builders;
using DotNet.Testcontainers.Containers;

public class CustomWebAppFactory : WebApplicationFactory<Program>, IAsyncLifetime
{
    private readonly PostgreSqlTestcontainer _postgres;

    public CustomWebAppFactory()
    {
        _postgres = new TestcontainersBuilder<PostgreSqlTestcontainer>()
            .WithDatabase(new PostgreSqlTestcontainerConfiguration
            {
                Database = "demo",
                Username = "sa",
                Password = "sa"
            }).Build();
    }

    public async Task InitializeAsync() => await _postgres.StartAsync();
    public async Task DisposeAsync() => await _postgres.DisposeAsync();

    protected override void ConfigureWebHost(IWebHostBuilder builder)
    {
        builder.ConfigureAppConfiguration((ctx, cfg) =>
        {
            cfg.AddInMemoryCollection(new Dictionary<string, string>
            {
                ["ConnectionStrings:Default"] = _postgres.ConnectionString
            });
        });
    }
}

public class OrderApiTests : IClassFixture<CustomWebAppFactory>
{
    private readonly HttpClient _client;
    public OrderApiTests(CustomWebAppFactory factory) => _client = factory.CreateClient();

    [Fact]
    public async Task Should_Create_Order_Successfully()
    {
        var command = new { orderId = Guid.NewGuid(), productId = "A001", quantity = 1 };
        var response = await _client.PostAsJsonAsync("/api/orders", command);
        response.EnsureSuccessStatusCode();
    }
}

测试流程图

Test 初始化 启动 Postgres 容器 配置 WebHost 运行集成测试 销毁容器

📦 Docker Compose

yaml 复制代码 
version: "3.9"
services:
  api:
    build: .
    ports:
      - "5000:80"
  db:
    image: postgres
    environment:
      POSTGRES_DB: demo
      POSTGRES_USER: sa
      POSTGRES_PASSWORD: sa
  redis:
    image: redis
相关推荐
Ultipa2 小时前
云计算与大数据进阶 | 28、存储系统如何突破容量天花板？可扩展架构的核心技术与实践—— 分布式、弹性扩展、高可用的底层逻辑（下）
大数据·架构·云计算
码观天工2 小时前
C#线程池核心技术：从原理到高效调优的实用指南
性能优化·c#·.net·线程·线程池·多线程·异步
0xCC说逆向3 小时前
Windows逆向工程提升之IMAGE_OPTIONAL_HEADER
汇编·windows·安全·架构·逆向·pe结构·pe文件
爱喝水的鱼丶3 小时前
SAP-ABAP:ABAP异常处理与SAP现代技术融合—— 面向云原生、微服务与低代码场景的创新实践
开发语言·低代码·微服务·云原生·sap·abap
安顾里3 小时前
k8s-ServiceAccount 配置
云原生·容器·kubernetes
hnlucky4 小时前
使用docker——10分钟内 完成一个高可用的 MongoDB 副本集部署
数据库·mongodb·docker·云原生·容器
福大大架构师每日一题4 小时前
hertz v0.10.0 重磅发布！全新SSE支持、请求竞态检测与协议优化，开启更高效的云端微服务新时代！
微服务·云原生·架构
Dovis(誓平步青云）5 小时前
华为云Flexus+DeepSeek征文｜Flexus云服务器Dify-LLM资源部署极致体验Agent
服务器·经验分享·云原生·华为云
WineMonk5 小时前
ArcGIS Pro 3.4 二次开发 - Arcade
arcgis·c#·.net
热门推荐
01从零安装 LLaMA-Factory 微调 Qwen 大模型成功及所有的坑02KGG转MP3工具|非KGM文件|解密音频03YOLOv8入门 | 重要性能衡量指标、训练结果评价及分析及影响mAP的因素【发论文关注的指标】04【SpeedAI科研小助手】2分钟极速解决知网维普重复率、AIGC率过高，一键全文降！文件格式不变，公式都保留的！05组基轨迹建模 GBTM的介绍与实现（Stata 或 R）06DeepSeek各版本说明与优缺点分析07VMware虚拟机安装Win7专业版保姆级教程（附镜像包）08YOLOv5改进 | 添加CA注意力机制 + 增加预测层 + 更换损失函数之GIoU09Coze扣子平台完整体验和实践（附国内和国际版对比）10Windows下Qt5.14.2连接华为IoTDA平台