打开连接
连接到数据库
打开连接 是 CoddyKit 上的免费 Go Academy 课时。 这是第 1 节课，共 4 节。 你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。 这是 Go Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 Go Academy 课程共包含 4 节课。
database/sql 包
Go 的标准 database/sql 包提供了通用且与数据库无关的 API。您需要将它与特定数据库的驱动程序配合使用，例如 PostgreSQL 或 MySQL。
- 一个 API，支持多个数据库
- 内置连接池
- 安全的参数化查询
导入驱动程序
驱动程序通过空白导入完成注册。下划线表示您导入它只是为了执行注册这一副作用，而不是直接调用它。
import (
"database/sql"
_ "github.com/lib/pq"
)sql.Open
sql.Open 接收驱动程序名称和数据源名称（DSN）。它实际上还不会建立连接，而只是准备连接池。
db, err := sql.Open("postgres", "postgres://user:pass@localhost/mydb?sslmode=disable")
if err != nil {
log.Fatal(err)
}db 是连接池
返回的 *sql.DB 不是单个连接，而是一个连接池，可以安全地供多个 goroutine 并发使用。请只打开一次，并在整个应用中共享它。
使用 Ping 验证
由于 Open 采用延迟连接，请使用 Ping 实际建立连接，并确认数据库可访问且凭据有效。
if err := db.Ping(); err != nil {
log.Fatal("cannot reach db:", err)
}关闭连接池
请在 main 函数或设置函数中使用 defer 调用 db.Close()。您很少需要针对每次查询关闭连接，通常只在整个应用关闭时关闭连接池。
defer db.Close()连接池调优
请使用 SetMaxOpenConns、SetMaxIdleConns 和 SetConnMaxLifetime 控制连接池。这些设置可以防止耗尽数据库资源，并回收过期连接。
db.SetMaxOpenConns(25)
db.SetMaxIdleConns(5)
db.SetConnMaxLifetime(5 * time.Minute)可运行的内存示例
真实驱动程序需要网络数据库，因此这个可运行示例只使用标准库类型，通过模拟打开和 Ping 来展示相同的生命周期。
package main
import (
"errors"
"fmt"
)
type DB struct{ dsn string }
func Open(driver, dsn string) (*DB, error) {
if dsn == "" {
return nil, errors.New("empty dsn")
}
return &DB{dsn: dsn}, nil
}
func (db *DB) Ping() error { return nil }
func (db *DB) Close() error { return nil }
func main() {
db, err := Open("postgres", "postgres://localhost/mydb")
if err != nil {
fmt.Println("open error:", err)
return
}
defer db.Close()
if err := db.Ping(); err != nil {
fmt.Println("ping error:", err)
return
}
fmt.Println("connected to", db.dsn)
}支持上下文的变体
请优先使用 PingContext、QueryContext 和 ExecContext，这样调用就会遵循截止时间和取消信号。传入上下文可以限制无响应的数据库调用最长阻塞时间。
ctx, cancel := context.WithTimeout(context.Background(), 3*time.Second)
defer cancel()
err := db.PingContext(ctx)DSN 格式
每个驱动程序都会定义自己的 DSN 格式。PostgreSQL 接受 URL，MySQL 使用 user:pass@tcp(host:3306)/dbname。请始终查阅驱动程序文档，并避免将凭据硬编码。
一个连接池，长期复用
一个常见错误是每次请求都调用 sql.Open。这样会破坏连接池的作用并耗尽连接。请在启动时打开一次，保存 *sql.DB，并在各处复用它。
快速检查
请测试您对连接的了解。
总结
您学会了打开连接：
- 空白导入驱动程序，并使用驱动程序和 DSN 调用 sql.Open
- *sql.DB 是支持并发的连接池，只需打开一次
- Ping 会验证实际连接
- 调整连接池，并使用支持上下文的方法
- 在关闭时执行 defer db.Close()
常见问题解答
「打开连接」课时是免费的吗？
是的 — 「打开连接」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 Go Academy 课程的其余内容，请升级到 CoddyKit PRO。 Go Academy 课程共包含 4 节课。
「打开连接」这节课中我会学到什么？
连接到数据库 你通过在浏览器中直接运行的动手代码来练习 Go Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。
学习 Go Academy 需要有经验吗？
无需任何先前经验。CoddyKit 上的 Go Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。 这是第 1 节课，共 4 节。
「打开连接」课时需要多长时间？
大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。
我能在这节 Go Academy 课中编写并运行代码吗？
能。每节 Go Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。