.NET Docker化项目连接MongoDB无响应问题求助

核心问题定位 #

你的问题大概率由以下几个关键问题导致：

1. Docker容器间连接错误：API容器内用localhost:27017无法访问MongoDB容器，因为容器的localhost指向自身，而非宿主机或其他容器。
2. MongoClient生命周期错误：每次请求都创建新的MongoClient，会耗尽连接池，导致请求无响应或异常。
3. 异常捕获范围过窄：仅捕获MongoException，无法捕获空引用等其他类型异常，且缺少日志记录，无法定位问题根源。

具体修复步骤 #

1. 修正MongoDB连接字符串 #

修改appsettings.json中的连接字符串，使用Docker Compose服务名mongodb代替localhost：

{
  "MongoConnection": {
    "ConnectionString": "mongodb://mongodb:27017",
    "DatabaseName": "EventAppDb",
    "EventsCollectionName": "Events"
  }
}

容器间通信通过服务名直接访问，无需依赖宿主机端口映射（端口映射仅用于外部访问）。

2. 单例注册MongoClient #

MongoClient是线程安全的，且内置连接池，应全局单例注册，避免重复创建导致的连接耗尽问题。修改Program.cs：

var builder = WebApplication.CreateBuilder(args);

// 注册MongoClient为单例
builder.Services.AddSingleton<IMongoClient>(sp =>
{
    var dbConfig = sp.GetRequiredService<IOptions<DatabaseSettings>>().Value;
    return new MongoClient(dbConfig.ConnectionString);
});

// 其他服务注册保持不变
builder.Services.AddControllers();
builder.Services.AddEndpointsApiExplorer();
builder.Services.AddSwaggerGen();
builder.Services.AddSingleton<IEventRepository, EventRepository>();
builder.Services.Configure<DatabaseSettings>(builder.Configuration.GetSection("MongoConnection"));
builder.Services.AddSingleton<IEventService, EventService>();

然后修改EventRepository构造函数，注入IMongoClient：

public class EventRepository : IEventRepository 
{
    private readonly IMongoCollection<Event> _events;
    private readonly ILogger<EventRepository> _logger;

    // 注入IMongoClient和ILogger
    public EventRepository(IOptions<DatabaseSettings> dbConfig, IMongoClient mongoClient, ILogger<EventRepository> logger) 
    {
        _logger = logger;
        var database = mongoClient.GetDatabase(dbConfig.Value.DatabaseName);
        _events = database.GetCollection<Event>(dbConfig.Value.EventsCollectionName); 
    }

    public async Task<List<Event>> GetEventListAsync() 
    {
        try 
        {
            return await _events.Find(_ => true).ToListAsync();
        }
        catch (Exception ex) 
        {
            _logger.LogError(ex, "获取事件列表失败");
            throw;
        }
    }
}

3. 增强日志与异常捕获 #

• 扩大异常捕获范围到Exception，确保所有异常都能被记录。
• 添加ILogger注入，记录异常详情，便于排查问题。
• 调整日志级别，开启MongoDB驱动的调试日志，查看连接和查询细节：

{
  "Logging": {
    "LogLevel": {
      "Default": "Information",
      "Microsoft.AspNetCore": "Warning",
      "MongoDB.Driver": "Debug",
      "MongoDB.Driver.Core": "Debug"
    }
  }
}

4. 配置MongoClient连接池参数 #

添加连接超时、连接池大小配置，避免请求无响应：

builder.Services.AddSingleton<IMongoClient>(sp =>
{
    var dbConfig = sp.GetRequiredService<IOptions<DatabaseSettings>>().Value;
    var settings = MongoClientSettings.FromConnectionString(dbConfig.ConnectionString);
    
    // 配置连接超时与连接池
    settings.ConnectTimeout = TimeSpan.FromSeconds(10);
    settings.ServerSelectionTimeout = TimeSpan.FromSeconds(10);
    settings.ClusterConfigurator = cb =>
    {
        cb.ConfigureConnectionPool(pool =>
        {
            pool.MaxConnectionPoolSize = 100; // 根据业务并发量调整
            pool.MinConnectionPoolSize = 10;
        });
    };
    
    return new MongoClient(settings);
});

5. 验证容器状态 #

• 查看MongoDB容器日志：docker logs event-db，检查是否有连接错误或启动异常。
• 进入API容器测试连通性：docker exec -it <api容器名称> ping mongodb，确认能正常访问MongoDB服务。

内容的提问来源于stack exchange，提问作者Astro