Struct PoolConfig 

pub struct PoolConfig {

    pub max_size: u32,
    pub min_idle: u32,
    pub acquire_timeout: Duration,
    pub idle_timeout: Duration,
    pub max_lifetime: Duration,
    pub connection_timeout: Duration,
    pub tls: Option<TlsConfig>,
    pub query_timeout: Option<Duration>,
    pub max_rows: Option<usize>,
    pub memory_limit: Option<usize>,
    pub on_event: Option<PoolEventCallback>,
    pub test_before_acquire: bool,
    pub prewarm: bool,
}

连接池配置

Fields

max_size: u32

最大连接数

min_idle: u32

最小空闲连接数

acquire_timeout: Duration

获取连接超时时间

idle_timeout: Duration

空闲连接超时时间

max_lifetime: Duration

连接最大存活时间

connection_timeout: Duration

连接建立超时时间

tls: Option<TlsConfig>

TLS 配置

query_timeout: Option<Duration>

SQL 执行超时（默认 30 秒）

max_rows: Option<usize>

单次查询最大返回行数（默认无限制）

memory_limit: Option<usize>

内存使用上限（字节，默认无限制）

on_event: Option<PoolEventCallback>

连接池事件回调

test_before_acquire: bool

acquire 时是否执行 ping 验证连接存活（默认 false）。

开启后，从空闲队列取出的连接会先执行 ping() 验证网络连通性， ping 失败的连接会被丢弃并重新 acquire。

注意：开启此选项会增加每次 acquire 的延迟（一次额外的网络 RTT）。 适用于 DB 可能重启且不能容忍首次查询失败的场景。

prewarm: bool

连接池预热：启用后池创建时立即建立 min_idle 个连接（默认 false）。

预热后首次 acquire 延迟 < 10ms（对比冷启动 < 100ms）。

示例

let config = PoolConfig::default().with_prewarm(true);
let pool = Pool::new(config, factory).await?;
// 此时池中已有 min_idle 个连接

Implementations

impl PoolConfig

pub fn validate(&self) -> Result<(), PoolError>

校验配置合法性

pub fn with_prewarm(self, prewarm: bool) -> Self

设置预热标志（链式调用）

Trait Implementations

impl Clone for PoolConfig

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Default for PoolConfig

fn default() -> Self

Returns the “default value” for a type.