ABP VNext + MongoDB 数据存储：多模型支持与 NoSQL 扩展

🚀 ABP VNext + MongoDB 数据存储：多模型支持与 NoSQL 扩展（生产级实践）

---

---

🎯 引言

在高并发、快速迭代的业务环境中，传统 RDBMS 因结构僵硬、事务开销大而难以应对。MongoDB 以其灵活文档模型、高吞吐与分布式能力，成为 ABP 应用的理想补充。本文将示范如何在 ABP VNext 中生产级地集成 MongoDB——从配置、DI、仓储，到事务、多模型设计与监控全覆盖。

💬 业务痛点

• 频繁迭代导致表结构变更成本高
• 大规模写入时事务与锁竞争瓶颈明显
• 多租户隔离需高扩展性

---

🧰 环境与依赖

• 🖥️ .NET 8
• 📦 ABP v6+
• 🌐 MongoDB Server 6.x（Replica Set / Sharded Cluster）
• 📦 NuGet 包
  • MongoDB.Driver
  • Volo.Abp.MongoDB

⚙️ appsettings.json

{
   
   
  "ConnectionStrings": {
   
   
    "MongoDb": "mongodb://localhost:27017/?maxPoolSize=200&minPoolSize=50"
  },
  "MongoDb": {
   
   
    "DatabaseName": "MyProjectDb"
  }
}

---

🏗️ 架构概述

---

🤖 集成与配置

📑 模块注册

public override void PreConfigureServices(ServiceConfigurationContext context)
{
   
   
    Configure<AbpMongoDbContextOptions>(options =>
    {
   
   
        options.ConnectionStringName = "MongoDb";
    });
}

public override void ConfigureServices(ServiceConfigurationContext context)
{
   
   
    context.Services.AddMongoDbContext<MyMongoDbContext>(builder =>
    {
   
   
        // includeAllEntities: false 仅为聚合根生成仓储
        builder.AddDefaultRepositories(includeAllEntities: false);
    });
}

💡 可根据项目需要，将 includeAllEntities 设置为 true 或 false。

📘 DbContext 定义

[ConnectionStringName("MongoDb")]
[MultiTenant]
public class MyMongoDbContext : AbpMongoDbContext
{
   
   
    public IMongoCollection<Order> Orders => Database.GetCollection<Order>("Orders");
    public IMongoCollection<Address> Addresses => Database.GetCollection<Address>("Addresses");

    public MyMongoDbContext(IAbpMongoDbContextOptions<MyMongoDbContext> options)
        : base(options) {
   
    }
}

• 建议：在模块 PreConfigureServices 注入 ICurrentTenant 控制数据库路由。

---

📦 自定义仓储实现

public interface IMongoRepository<TEntity, TKey> : IRepository<TEntity, TKey>
    where TEntity : class, IEntity<TKey>
{
   
   
    Task BulkInsertAsync(IEnumerable<TEntity> entities, bool isOrdered = false