Go database/sql Conn.Raw 如何访问驱动连接

如果只需要执行 SQL，*sql.DB 和 *sql.Conn 已经足够；只有在驱动提供了 database/sql 没有暴露的能力时，才需要 Conn.Raw。它的关键不是“把连接拿出来长期保存”，而是把底层连接交给一个短生命周期回调：在回调里判断类型、完成一次操作，回调返回后立即放弃底层对象。

先拿到可控的单连接，再进入 Raw 回调

Conn.Raw 的接收者是 *sql.Conn，不是 *sql.DB。通常先用带超时的上下文从连接池获取一条连接，并把 Close 放到同一作用域中。这样既能保证驱动操作落在固定会话上，也能在错误路径把连接归还池中。

ctx, cancel := context.WithTimeout(context.Background(), 2*time.Second)
defer cancel()

conn, err := db.Conn(ctx)
if err != nil {
    return err
}
defer conn.Close() // 使用结束后把单连接归还连接池

err = conn.Raw(func(driverConn any) error {
    // driverConn 只在这个回调中有效，不要把它交给异步任务。
    pinger, ok := driverConn.(driver.Pinger)
    if !ok {
        return errors.New("driver does not expose driver.Pinger")
    }
    // 这是一个短生命周期的驱动层探测，仍然沿用调用方的超时。
    return pinger.Ping(ctx)
})

这里的 any 并不意味着可以随便调用方法。不同驱动的底层类型不同，能否使用某项能力要通过驱动公开的接口做类型断言。driver.Pinger 只是示例：它是可选扩展，不支持时应当返回清楚的错误，而不是强制转换后触发 panic。

驱动能力判断要放在回调里完成

Raw 的回调接收到的是驱动连接的动态值。推荐先断言一个小而明确的接口，再执行一次必要操作；不要依赖某个驱动的私有具体类型，也不要把“断言成功”误当成“所有数据库能力都可用”。

最容易忽略的坑是异步调用：即使回调内部启动 goroutine，goroutine 也可能在回调返回后才真正访问 driverConn。这种写法破坏了 Raw 的生命周期约定，应该把必要数据在回调内转换成普通值，再把普通值交给后续任务。

回调错误决定当前连接还能不能复用

Raw 会把回调返回的错误传回调用方。普通驱动错误通常可以按业务需要记录或返回；但 driver.ErrBadConn 是一个特殊信号，表示这条底层连接已经不适合继续使用。此时不要在同一个 *sql.Conn 上继续尝试下一次驱动调用。

err = conn.Raw(func(driverConn any) error {
    // 只使用回调参数，避免把底层连接逃逸到回调之外。
    pinger, ok := driverConn.(driver.Pinger)
    if !ok {
        return errors.New("driver does not implement Pinger")
    }
    return pinger.Ping(ctx)
})
if err != nil {
    // ErrBadConn 不是普通业务失败，当前底层连接不应再被复用。
    if errors.Is(err, driver.ErrBadConn) {
        return fmt.Errorf("driver connection is unusable: %w", err)
    }
    return fmt.Errorf("raw driver operation failed: %w", err)
}
return nil

错误处理的重点不是手动创建一条新驱动连接，而是结束当前 sql.Conn 的使用，让 database/sql 按自己的连接池策略处理后续请求。若你的任务只是执行 SQL、事务或 Ping，优先使用 Conn.ExecContext、BeginTx 和 PingContext，不要为了“更底层”而绕过标准抽象。

延伸问答：什么时候该用 Conn.Raw

Raw 能不能直接拿到某个具体驱动类型？

可以尝试类型断言，但不应把具体类型写成通用库的前提。优先依赖驱动公开的可选接口，并准备不支持时的分支。

Raw 回调里能不能保存连接供下次使用？

不能。可以保存查询结果、标识或错误，但底层 driverConn 只能在回调期间使用。

拿到的 Conn 为什么还要 Close？

DB.Conn 取得的是池中专用连接，Close 的作用是归还连接池；忘记关闭会让可用连接减少，最终让后续获取连接等待或超时。

记住一个边界就够了：database/sql 负责连接池生命周期，Conn.Raw 只提供一次受控的驱动层访问窗口。把驱动调用收进回调、把结果带出来，通常比保存底层连接更稳妥。