登录
推荐 文章 Go 技术 课程 下载 专题 AI
首页 >  Golang >  Go问答

Go database/sql.Conn.Close 后连接怎样回到连接池

来源:17golang原创

时间:2026-11-19 08:47:10 426浏览 收藏

先说结论:database/sql.Conn 是从 *sql.DB 连接池中暂时取出的一条专用会话连接。成功调用 db.Conn(ctx) 后,应尽快安排 defer conn.Close();Close 会等待已有操作结束,再把连接归还连接池。关闭后的 Conn 不应继续使用,后续操作会返回 sql.ErrConnDone。

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

这个问题的关键不是“调用 Close 会不会把数据库断开”,而是分清三层对象:长期共享的 DB、短期占用的 Conn,以及由 DB 管理的连接池。下面按获取、使用、归还和并发收尾四个阶段说明。

先分清 DB、Conn 与连接池

*sql.DB 本身是连接池句柄,适合被多个 goroutine 共享;DB.Conn 返回的是一条专用连接,后续查询会在同一个数据库会话中执行。它适合需要保持会话状态的场景,例如连续操作临时表或会话变量,但普通查询优先直接使用 DB.QueryContext、DB.ExecContext。

package main

import (
    "context"
    "database/sql"
    "log"
)

func useSession(ctx context.Context, db *sql.DB) error {
    // Conn 成功后立刻登记归还动作,避免中途返回时泄漏池中的连接。
    conn, err := db.Conn(ctx)
    if err != nil {
        return err
    }
    defer conn.Close()

    // 同一 Conn 上的查询共享数据库会话,而不是重新随机取一条连接。
    _, err = conn.ExecContext(ctx, "SELECT 1")
    return err
}

func main() {
    // 示例只展示生命周期;真实项目应使用驱动返回的 *sql.DB。
    _ = log.Print
}

DB.Conn 可能返回新连接,也可能从池中取出现有空闲连接;如果池暂时没有可用连接,它会等待,直到有连接归还或上下文取消。Conn.Close 的作用是结束这次专用占用并把连接交回池,不等同于关闭整个 *sql.DB。

DB 连接池、专用 Conn、固定数据库会话与 Conn.Close 归还关系说明图
图1:结构说明图,展示 DB、专用 Conn 与连接池的所有权边界;这是 API 结构示意,不是运行结果截图。

获取 Conn 后为什么要立刻安排 Close

最稳妥的顺序是“获取成功后立刻 defer,之后再做查询”。这样即使后续准备语句、读取结果或业务判断提前返回,归还动作仍然会执行。不要把 Close 只放在某个成功分支里,也不要期待垃圾回收替你管理连接池占用。

如果只是执行一次普通 SQL,直接使用 DB 往往更简单:

func queryOnce(ctx context.Context, db *sql.DB) error {
    // 普通查询让 DB 自己从池中选择连接,不必手动占用专用 Conn。
    rows, err := db.QueryContext(ctx, "SELECT id, name FROM users")
    if err != nil {
        return err
    }
    defer rows.Close()

    for rows.Next() {
        // 示例省略 Scan 目标;真实代码仍要在循环后检查 rows.Err。
    }
    // 读取阶段的驱动错误不能只靠 Next 的 false 判断。
    return rows.Err()
}

只有当“同一会话”本身是需求时,才显式调用 DB.Conn。可以把这条规则记成:DB 负责共享和调度,Conn 负责短时间的会话连续性,Close 负责释放这次占用。

理解 Close 的并发与阻塞语义

官方契约允许 Conn.Close 与其他操作并发调用,但它不会粗暴地中断正在执行的查询。Close 会等待已有操作完成;如果查询可能长时间等待,应该先取消它使用的 Context,再关闭连接。

import "time"

func runWithDeadline(parent context.Context, db *sql.DB) error {
    ctx, cancel := context.WithTimeout(parent, 2*time.Second)
    defer cancel()

    // 获取成功后登记 Close;超时会先让查询收到取消信号。
    conn, err := db.Conn(ctx)
    if err != nil {
        return err
    }
    defer conn.Close()

    _, err = conn.ExecContext(ctx, "SELECT 1")
    return err
}

上面的示例需要额外导入 time。重点是资源顺序:Context 负责让操作有机会结束,Close 负责等待并归还 Conn。若把一个没有截止时间的长查询交给 Close 等待,调用方可能误以为“关闭卡住了”,实际是已有操作还没有完成。

QueryContext、Context、Conn.Close 等待已有操作与关闭后错误关系说明图
图2:并发边界说明图,展示 Close 等待已有操作结束、取消上下文和关闭后不可复用的关系;不是运行结果截图。

关闭后不要复用 Conn:识别 ErrConnDone

Conn 归还连接池后,原来的对象就不再是可用会话。继续调用查询、执行或准备方法,通常会得到 sql.ErrConnDone。这不是连接池故障,而是调用方已经结束了该 Conn 的生命周期。

func closeOnce(ctx context.Context, db *sql.DB) error {
    conn, err := db.Conn(ctx)
    if err != nil {
        return err
    }

    // 第一次 Close 完成本次归还;defer 适合保证异常路径也能释放。
    defer conn.Close()

    if err := conn.Close(); err != nil {
        return err
    }
    // 关闭后的 Conn 不再交给其他业务函数继续使用。
    return nil
}

这里不应把 Conn.Close 和 DB.Close 混为一谈:前者归还一条专用连接,后者关闭数据库句柄并阻止新的查询启动,通常只在应用退出时调用。工程上最常见的检查点有三个:

  • 获取失败:不要执行 defer conn.Close(),因为此时没有有效 Conn。
  • 查询较慢:给查询使用可取消的 Context,避免 Close 长时间等待。
  • 关闭之后:不要把 Conn 放回共享结构或交给其他 goroutine 复用。

速查表:什么时候用哪个对象

需求推荐对象生命周期动作
普通独立查询*sql.DB让连接池自动选择
同一会话连续操作*sql.Conn获取成功后 defer Close
长时间等待的操作Conn + Context先取消 Context,再等待 Close 收尾
应用退出*sql.DB统一调用 DB.Close

相关问题:

  • Conn.Close 会立刻断开数据库 TCP 连接吗?不一定;它首先表达的是把专用连接归还给连接池,池和驱动再决定后续复用或回收。
  • Close 可以和查询并发调用吗?可以,但 Close 会等待已有操作结束,长查询应配合可取消的 Context。
  • 为什么关闭后还是能看到 Conn 对象?Go 对象仍可能存在,但它已经结束可用生命周期,继续操作会返回 ErrConnDone。
声明:本文转载于:17golang原创 如有侵犯,请联系study_golang@163.com删除
相关阅读
更多>
最新阅读
更多>
课程推荐
更多>