如何设置NpgsqlConnection超时值？附配置代码及报错说明

你配置的Timeout=1200不符合Npgsql的参数校验规则，本质是混淆了两类超时参数的作用域和取值限制：

• 连接字符串里的Timeout（别名Connection Timeout）是连接建立阶段的超时控制参数，单位为秒，合法取值范围是0~1024，你填的1200超出上限，直接触发参数校验异常，就是你看到的Couldn't set timeout (Parameter 'timeout')报错。
• 从你的代码逻辑看，你大概率是想延长SQL查询执行的等待时间，而不是连接建立的等待时间，用错了参数。

根据实际超时需求选对应配置即可：

配置连接建立超时 #

如果要调整应用和PostgreSQL建立连接、完成身份认证的最长等待时间，将Timeout值设为1024以内的合法值即可，单位为秒，一般生产环境设10~30秒足够，没必要设太大，避免网络故障时应用长时间阻塞。
配置示例：

Server=你的数据库地址;Port=5432;Database=目标库名;Username=登录账号;Password=登录密码;Timeout=30

配置SQL命令执行超时 #

如果是要延长慢SQL的执行等待时间（比如你要设1200秒也就是20分钟的执行等待上限），不要用Timeout参数，以下三种写法任选其一即可：

1. 全局配置：在连接字符串中添加Command Timeout参数，单位为秒，1200为合法取值，所有用该连接字符串创建的连接执行命令时默认继承这个超时时间：

Server=你的数据库地址;Port=5432;Database=目标库名;Username=登录账号;Password=登录密码;Command Timeout=1200

2. 单次调用配置（Dapper场景）：你代码里用的是Dapper的ExecuteScalar方法，可以直接在调用时传入commandTimeout参数，仅对当前这次SQL生效，优先级最高：

using (IDbConnection dbConnection = Connection)
{                
    return dbConnection.ExecuteScalar<int>(query, new { OP = op }, commandTimeout: 1200) > 0;
}

3. 原生ADO.NET场景配置：如果不用Dapper，手动创建DbCommand对象时给CommandTimeout属性赋值即可：

using (IDbConnection dbConnection = Connection)
{
    dbConnection.Open();
    var cmd = dbConnection.CreateCommand();
    cmd.CommandText = query;
    cmd.CommandTimeout = 1200;
    // 参数绑定、执行逻辑省略
    return (int)cmd.ExecuteScalar() > 0;
}

• 连接超时不建议设置超过30秒，正常网络环境下PG连接建立耗时通常在1秒内，过大的连接超时会在网络故障、数据库不可达时导致应用请求长时间挂起。
• 命令超时根据实际慢SQL的优化进度调整即可，不建议长期设置过大的命令超时，避免慢SQL占满数据库连接池。

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