Go sql.Conn Raw 回调结束后为什么不能保留 driverConn

sql.Conn.Raw 里的 driverConn 只能在回调执行期间使用。回调返回后，不要把它存进结构体、全局变量、闭包或交给新 goroutine。原因不是 Go 语法限制，而是底层连接的生命周期、串行使用和连接池状态仍由 database/sql 管理；你拿到的只是一次临时借用。

官方文档：https://pkg.go.dev/database/sql#Conn.Raw

Raw 解决的是驱动扩展，不是连接所有权转移

我第一次看到 Raw 时，也容易把它理解成“取出原生连接”。更准确的理解是：database/sql 暂时把当前 *sql.Conn 对应的驱动连接交给回调，让代码调用驱动专属接口。回调结束，借用立即结束。

这类入口适合标准 API 没有覆盖、但驱动明确提供的会话能力。若 ExecContext、QueryContext、PingContext 已能完成任务，就不必绕到 Raw；标准接口更容易保持池化、取消和错误处理的一致性。

为什么回调结束后继续使用会出问题

database/sql 负责协调底层连接的复用、有效性检查和关闭。官方驱动接口还约定，一个 driver.Conn 不会被多个 goroutine 并发使用。把 driverConn 偷带到回调外，相当于绕过这层协调：外层代码可能继续使用 *sql.Conn，而被保存的引用也在访问同一底层对象；连接还可能因为错误、关闭或池策略改变状态。

因此，下面三种写法都不安全：回调内赋给全局变量；返回一个捕获 driverConn 的函数；在回调里启动 goroutine，等回调结束后再调用驱动方法。即使短期测试没报错，也没有获得可依赖的生命周期保证。

安全写法是在回调内做完，只带出结果值

实际项目里，我更愿意把 Raw 包成一个很窄的函数：先取得专用 *sql.Conn，在回调内完成类型断言和驱动调用，把最终结果复制到普通变量，然后关闭外层 Conn 归还连接池。

type sessionInspector interface {
    SessionID(context.Context) (string, error)
}

func readSessionID(ctx context.Context, db *sql.DB) (string, error) {
    conn, err := db.Conn(ctx)
    if err != nil {
        return "", fmt.Errorf("获取专用连接: %w", err)
    }
    defer conn.Close() // 归还由 database/sql 管理的外层连接。

    var sessionID string
    err = conn.Raw(func(driverConn any) error {
        // 类型断言和驱动调用都必须在 Raw 回调内完成。
        inspector, ok := driverConn.(sessionInspector)
        if !ok {
            return fmt.Errorf("当前驱动不支持会话标识查询")
        }
        value, err := inspector.SessionID(ctx)
        if err != nil {
            return fmt.Errorf("读取驱动会话标识: %w", err)
        }
        sessionID = value // 只复制普通字符串，不保存 driverConn。
        return nil
    })
    if err != nil {
        return "", err
    }
    return sessionID, nil
}

sessionInspector 只是演示“驱动专属接口”的结构，真实方法名和支持范围必须以所用驱动文档为准。关键不在接口名称，而在所有底层连接操作都在回调返回前结束。

哪些值可以带出回调

ErrBadConn 不是普通业务错误

官方文档说明，只要回调返回的错误不是 driver.ErrBadConn，外层 *sql.Conn 在 Raw 返回后仍可继续使用，直到 Conn.Close。而 driver.ErrBadConn 用来告诉 database/sql：底层连接已经处于坏状态，应换连接处理。

不要为了“触发重试”随意返回它。驱动文档特别提醒：如果数据库可能已经执行了操作，就不应返回 ErrBadConn，否则重试可能造成重复操作。普通类型不支持、参数错误或业务失败，应返回各自的普通错误。

常见问题

能否在 Raw 回调里启动 goroutine，并在返回前等待它结束？

只有当所有底层连接访问都确定在回调返回前结束，生命周期才没有越界。但这种写法更难审计，通常直接同步调用更清楚。

能否把 driverConn 转成具体驱动类型后再返回？

不能。类型断言不会改变对象的所有权和有效期；具体类型指针仍然是同一个借用的底层连接。

结语

判断是否写对 Raw，可以问一句：回调结束时，所有依赖 driverConn 的工作是否已经完成？如果答案是肯定的，并且回调外只留下独立结果值，这段代码才符合 database/sql 的连接管理边界。