17370845950

Go中处理数据库错误需分三步：先用db.Ping()验证连接，再对每个Query/Exec等操作检查error，最后区分临时错误（如连接超时）与永久错误（如语法错误）并合理重试或返回。

在 Go 中处理数据库操作错误，核心是理解 sql.DB 本身不表示连接状态，而每个具体操作（如 Query、Exec、Prepare）才可能返回 error。不能只检查 sql.Open 的返回值就认为后续操作一定成功。

sql.Open 不等于连接成功

sql.Open 只是初始化连接池配置，并不真正建立数据库连接。它返回的 error 仅表示参数错误（如驱动名不对、DSN 格式非法），不代表数据库是否可达。

正确做法是调用 db.Ping() 主动验证连接：

• err := db.Ping() —— 同步尝试一次连接，失败则返回真实错误（如网络不通、认证失败）
• 建议在服务启动时执行一次 Ping，并重试或记录日志
• 不要忽略 Ping 错误，尤其在关键服务初始化阶段

每条 SQL 操作都要检查 error

sql.DB 的所有执行方法（Query、QueryRow、Exec、Prepare 等）都返回 error，必须显式判断：

• rows, err := db.Query("SELECT * FROM users WHERE id = ?", id) —— 即使语句语法正确，也可能因超时、权限不足、表不存在等失败
• _, err := db.Exec("INSERT INTO logs(...) VALUES (...)", ...) —— 注意检查 err，而非只看影响行数
• 即使 QueryRow.Scan() 成功，也要检查 Scan 返回的 error（例如列类型不匹配、NULL 值扫描到非指针变量）

区分临时错误与永久错误

某些错误（如网络抖动、连接池耗尽）可能是暂时的，适合重试；而语法错误、权限拒绝通常是永久性的。Go 标准库未直接暴露错误类型，但可通过以下方式判断：

• 检查 err 是否为 *pq.Error（PostgreSQL）、*mysql.MySQLError（MySQL）等驱动特有类型，获取 SQLState 或 Number
• 常见可重试错误码：PostgreSQL 的 "08" 类（连接异常）、MySQL 的 1205（死锁）、1040（连接数超限）
• 使用 errors.Is(err, sql.ErrNoRows) 判断“查无结果”，这是正常业务逻辑分支，不是异常

避免 panic，用 error 包装和传播

不要用 log.Fatal 或 panic 处理可预期的数据库错误（如用户 ID 不存在）。应将错误逐层返回，由上层决定如何响应（返回 HTTP 404、重试、降级）：

• 函数签名明确返回 error，例如：func GetUser(id int) (*User, error)
• 必要时用 fmt.Errorf("failed to query user %d: %w", id, err) 包装原始错误，保留调用链
• 对敏感错误（如密码、连接串）做脱敏处理，避免泄露到日志或 API 响应中