Go中数据库错误处理核心是分层预防与精准归因：初始化时Ping验证连接，运行时用errors.Is和驱动错误类型区分网络超时、认证失败等场景，结合上下文超时与连接池配置实现可观测的健壮性。
Go 中处理数据库连接错误，关键不是“捕获 panic”，而是提前预防、分层判断、明确归因。标准库 database/sql 本身不 panic，但连接失败、查询超时、驱动错误等会以 error 形式返回——真正优雅的处理，是让错误可识别、可重试、可监控、可恢复。
区分连接错误类型，避免一概而论
数据库错误不是统一的 error 字符串，不同场景需不同策略：
- 网络级失败（如 dial timeout、connection refused）：通常是临时性问题，适合指数退避重试
- 认证失败（如 wrong username/password）：配置错误，不可重试，应快速失败并告警
- 权限不足（如 no CREATE privilege）：属于部署/DBA 配置问题，需人工介入
- 数据库服务不可用（如 PostgreSQL 进程崩溃）：需结合健康检查与熔断机制
使用 errors.Is 或驱动提供的错误判定函数（如 pgx.ErrConnectionFailed、mysql.MySQLError 类型断言）精准识别，而不是用 strings.Contains(err.Error(), "timeout")。
初始化阶段主动探测连接有效性
在应用启动时执行一次轻量级探活，比等到第一个请求再暴露问题更友好：
db, err := sql.Open("pgx", dsn)
if err != nil {
log.Fatal("failed to open db:", err)
}
// 设置连接池参数（非必需但推荐）
db.SetMaxOpenConns(20)
db.SetMaxIdleConns(10)
db.SetConnMaxLifetime(60 * time.Minute)
// 主动验证连接是否可用
if err := db.Ping(); err != nil {
log.Fatal("failed to ping db:", err) // 此时可触发告警或退出
}
注意：Ping() 不仅测试连通性，还会校验凭证和基础权限，是低成本高价值的前置检查。
运行时错误按语义分类处理
对 Query、Exec 等操作返回的 error，建议封装统一处理逻辑：
- 对
sql.ErrNoRows单独处理（业务正常分支，非异常） - 对驱动特定错误（如 MySQL 的
ErrInvalidConn）标记连接失效，交由连接池自动丢弃 - 对上下文取消（
context.Canceled/DeadlineExceeded）不记录为 DB 错误，而是归类为请求生命周期问题 - 其他未识别错误，打上 trace ID 记录日志，并返回用户友好的提示（如 “服务暂时不可用，请稍后重试”）
示例片段：
rows, err := db.QueryContext(ctx, "SELECT name FROM users WHERE id = $1", id)
if err != nil {
if errors.Is(err, sql.ErrNoRows) {
return nil, ErrUserNotFound
}
if pgerr, ok := err.(*pgconn.PgError); ok && pgerr.Code == "28000" {
log.Warn("auth error on query", "code", pgerr.Code)
return nil, ErrDBConfigInvalid
}
log.Error("db query failed", "err", err, "trace_id", ctx.Value("trace_id"))
return nil, ErrInternal
}
defer rows.Close()配合连接池与超时控制，减少错误发生面
很多“连接错误”本质是配置不当引发的雪崩：
- 设置合理的
SetConnMaxLifetime避免复用过期连接（尤其在云环境 NAT 超时常见） - 用
SetMaxIdleConns控制空闲连接数，防止 DB 侧资源耗尽 - 所有 DB 操作必须带 context（
QueryContext,ExecContext），设置合理 deadline（如 3s 查询、10s 写入） - 避免长事务阻塞连接池，用
tx, err := db.BeginTx(ctx, nil)显式管理事务生命周期
连接池不是万能的，它只是缓冲器；真正的稳定性来自“及时发现 + 快速释放 + 合理限制”。
基本上就这些。Go 的 DB 错误处理不复杂，但容易忽略分层和归因——把错误当信号，而不是障碍，才能做到既健壮又可观测。
