EF Core访问PostgreSQL时空闲5分钟首次请求超时问题咨询

这个问题是连接池内的空闲死连接导致的，和查询语句本身无关：

• 你当前网络环境中的防火墙、NAT网关等中间设备，会自动回收超过5分钟无流量的TCP连接，且不会主动通知客户端和服务端连接已断开
• Npgsql驱动默认的连接池空闲连接回收周期是10分钟，远长于中间设备的5分钟超时阈值
• 当空闲满5分钟后，连接池里缓存的连接实际已经被中间设备掐断，第一次请求拿到这条死连接尝试通信时就会触发超时；超时后连接池会剔除死连接、新建可用连接，所以后续请求全部正常，直到下一次满5分钟空闲再次复现。
  从你贴的错误栈也能印证：报错发生在NpgsqlConnector.Open、ConnectorPool.OpenNewConnector阶段，还没进入实际的SQL执行逻辑。

1. 修正DbContext配置笔误
   你贴的配置代码里UseNpgsql(...)的闭合括号后多了无意义的production字符，先删掉这个手误内容，避免配置加载异常：

services.AddDbContext<ApplicationContext>(options =>
    options.UseNpgsql(
        Configuration.GetConnectionString("DefaultConnection"),
        npgslOptions => npgslOptions.MigrationsHistoryTable("__efmigrationshistory", Constants.DB_SCHEMA)
                                    .EnableRetryOnFailure()
        )
    .EnableDetailedErrors(true)
    .EnableSensitiveDataLogging(true)
    .ReplaceService<IHistoryRepository, LoweredCaseMigrationHistoryRepository>()
    .UseSnakeCaseNamingConvention());

2. 调整Npgsql连接字符串参数
   在原有连接字符串中加入连接池生命周期和TCP保活配置，让客户端侧的空闲回收周期短于中间设备的5分钟超时，同时通过心跳维持连接活跃：

"Host=hostname.domain.local;Port=5432;Database=DatabaseName;Username=usrn;Password=pwd;Connection Idle Lifetime=240;Keepalive=30;Command Timeout=30;"

参数说明：

• Connection Idle Lifetime=240：设置池中空闲连接超过4分钟就自动回收，避免拿到被中间设备断开的死连接
• Keepalive=30：每30秒向服务端发送一次保活心跳，阻止中间设备判定连接为空闲状态
• Command Timeout=30：将默认执行超时从15秒调整为30秒，覆盖偶发的冷启动建连耗时

3. 根因验证（可选）
   如果需要快速确认问题来源，可以临时在连接字符串中加入Pooling=false;关闭连接池，此时每次请求都会新建物理连接，如果空闲5分钟后不再出现超时问题，即可100%确认是连接池死连接导致的问题，验证完记得把Pooling改回默认的true（或者直接删掉这个参数），避免频繁建连损耗性能。

如果调整客户端参数后问题仍然存在，可以检查PostgreSQL服务端的tcp_keepalives_idle参数，将其设置为小于300秒（5分钟）的值，从服务端侧主动发送保活包即可，绝大多数场景下只调整客户端参数就可以解决问题。

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