解决 .NET Core 6.0 + PostgreSQL 网站首次连接缓慢问题

解决 .NET Core 6.0 + PostgreSQL 网站首次连接缓慢问题

当网站长期不连接数据库后首次连接缓慢，这通常是由于数据库连接池中的连接已经过期或被回收导致的。以下是几种解决方案：

1. 配置连接池保持活动

在 .NET Core 中配置 Npgsql (PostgreSQL 的 .NET 驱动程序) 的连接池设置：

services.AddDbContext<YourDbContext>(options =>
    options.UseNpgsql(Configuration.GetConnectionString("DefaultConnection"),
    npgsqlOptions => 
    {
        npgsqlOptions.EnableRetryOnFailure();
        npgsqlOptions.UseNodaTime(); // 如果使用NodaTime
        npgsqlOptions.SetPostgresVersion(Version.Parse("12")); // 你的PostgreSQL版本
        
        // 配置连接池保持活动
        npgsqlOptions.ConnectionPruningInterval = TimeSpan.FromMinutes(5); // 定期检查空闲连接
        npgsqlOptions.Keepalive = 30; // 发送TCP保持活动包(秒)
        npgsqlOptions.TcpKeepalive = true;
    }));

2. 实现预热策略

在应用启动时主动建立数据库连接：

// Program.cs 或 Startup.cs
app.Lifetime.ApplicationStarted.Register(() =>
{
    using var scope = app.Services.CreateScope();
    var dbContext = scope.ServiceProvider.GetRequiredService<YourDbContext>();
    dbContext.Database.OpenConnection();
    dbContext.Database.CloseConnection();
});

3. 使用后台服务保持连接活跃

创建一个后台服务定期执行简单查询：

public class DatabaseKeepAliveService : BackgroundService
{
    private readonly IServiceScopeFactory _scopeFactory;
    private readonly ILogger<DatabaseKeepAliveService> _logger;

    public DatabaseKeepAliveService(IServiceScopeFactory scopeFactory, ILogger<DatabaseKeepAliveService> logger)
    {
        _scopeFactory = scopeFactory;
        _logger = logger;
    }

    protected override async Task ExecuteAsync(CancellationToken stoppingToken)
    {
        while (!stoppingToken.IsCancellationRequested)
        {
            await Task.Delay(TimeSpan.FromMinutes(5), stoppingToken); // 每5分钟执行一次
            
            try
            {
                using var scope = _scopeFactory.CreateScope();
                var dbContext = scope.ServiceProvider.GetRequiredService<YourDbContext>();
                await dbContext.Database.ExecuteSqlRawAsync("SELECT 1", stoppingToken);
            }
            catch (Exception ex)
            {
                _logger.LogError(ex, "Database keep-alive failed");
            }
        }
    }
}

// 在Program.cs中注册
builder.Services.AddHostedService<DatabaseKeepAliveService>();

4. PostgreSQL 服务器端配置优化

检查并调整 PostgreSQL 服务器的以下配置(postgresql.conf)：

tcp_keepalives_idle = 60           # TCP保持活动空闲时间(秒)
tcp_keepalives_interval = 10       # TCP保持活动间隔(秒)
tcp_keepalives_count = 3           # TCP保持活动次数

# 连接超时设置
idle_in_transaction_session_timeout = 0  # 禁用空闲事务超时(或设置为较大值)

5. 前端处理策略

在 Vue3 前端，可以添加加载状态处理首次请求缓慢的情况：

// 在API调用处添加加载状态
const isLoading = ref(false);
const data = ref(null);

const fetchData = async () => {
  isLoading.value = true;
  try {
    const response = await axios.get('/api/your-endpoint');
    data.value = response.data;
  } catch (error) {
    console.error('Error fetching data:', error);
  } finally {
    isLoading.value = false;
  }
};

6. 连接字符串参数优化

在连接字符串中添加以下参数：

Server=your_server;Database=your_db;User Id=your_user;Password=your_pwd;
Pooling=true;
Minimum Pool Size=5;
Maximum Pool Size=100;
Connection Idle Lifetime=300;
Connection Pruning Interval=5;
Timeout=15;
Command Timeout=30;

通过以上方法的组合，应该能有效解决长期不连接数据库后首次连接缓慢的问题。根据你的具体环境和需求选择最适合的方案或组合多个方案。