ABP VNext + Cosmos DB Change Feed：搭建实时数据变更流服务

ABP VNext + Cosmos DB Change Feed：搭建实时数据变更流服务 🚀

📚 目录

ABP VNext + Cosmos DB Change Feed：搭建实时数据变更流服务 🚀

TL;DR ✨🚀

全托管 DI：CosmosClient 由容器单例管理，HostedService 构造注入，优雅释放。
作用域与事务：回调内创建新 Scope，结合 IUnitOfWorkManager 实现事务一致性🛡️。
Exactly-Once：通过（DocumentId, ETag）唯一索引 + 手动 Checkpoint，确保不漏不重✅。
容错重试：Polly 指数退避重试与熔断，处理启动与回调中的网络抖动🔄。
监控可扩展：日志、指标、Dead-Letter 容错，中控告警 + 多实例自动分片，助力弹性伸缩📊。

1. 环境与依赖 🏗️

.NET 平台：.NET 6 + / ABP VNext 6.x
Azure 资源：Cosmos DB Core API（Source 容器 + Lease 容器）

主要 NuGet 包

dotnet add package Microsoft.Azure.Cosmos
dotnet add package Volo.Abp.EventBus.MassTransit
dotnet add package Streamiz.Kafka.Net.Stream        # 可选
dotnet add package Volo.Abp.EntityFrameworkCore
dotnet add package Polly

appsettings.json 配置

{
  "Cosmos": {
    "ConnectionString": "<your-connection-string>",
    "Database": "MyAppDb",
    "SourceContainer": "Docs",
    "LeaseContainer": "Leases"
  },
  "RabbitMq": { "Host": "rabbitmq://localhost" },
  "Kafka":   { "BootstrapServers": "localhost:9092" }
}

2. 服务注册与依赖注入 🔌

在 MyAppModule 的 ConfigureServices 中：

public override void ConfigureServices(ServiceConfigurationContext context)
{
   
   
    var configuration = context.Services.GetConfiguration();

    // CosmosClient 单例托管
    context.Services.AddSingleton(sp =>
        new CosmosClient(configuration["Cosmos:ConnectionString"]));

    // Polly 重试策略：3 次指数退避
    context.Services.AddSingleton(sp => Policy
        .Handle<Exception>()
        .WaitAndRetryAsync(
            retryCount: 3,
            sleepDurationProvider: attempt => TimeSpan.FromSeconds(Math.Pow(2, attempt)),
            onRetry: (ex, ts, retryCount, ctx) =>
            {
   
   
                var logger = sp.GetRequiredService<ILogger<ChangeFeedHostedService>>();
                logger.LogWarning(ex, "⚠️ ChangeFeed 启动重试，第 {RetryCount} 次", retryCount);
            }));

    // 注册 HostedService
    context.Services.AddHostedService<ChangeFeedHostedService>();
}