正确处理Go数据库错误需区分sql.ErrNoRows与驱动特定错误，使用errors.Is和errors.As进行精准判断，结合自定义错误封装与日志记录，提升程序健壮性。
在 Go 语言开发中，数据库操作是常见且关键的部分。正确处理数据库错误不仅能提升程序的稳定性，还能帮助开发者快速定位问题。Go 的错误处理机制强调显式判断和逐层传递，因此在使用 database/sql 或第三方 ORM（如 GORM）时，合理地捕获、判断和响应数据库错误尤为重要。
理解 database/sql 中的错误类型
标准库 database/sql 在执行查询或操作时会返回 error 类型。这些错误通常来源于连接
失败、SQL 语法错误、约束冲突（如唯一键冲突）、超时等。常见的错误场景包括：
- sql.ErrNoRows：查询没有返回任何行，常出现在 QueryRow() 中
- 连接相关错误：如网络中断、认证失败，这类错误通常为底层驱动抛出的具体错误
- 约束违反：例如插入重复主键、外键约束失败等
需要注意的是，sql.ErrNoRows 是一个预定义错误，但它属于“预期情况”而非严重错误。因此不建议将其作为异常处理，而应通过逻辑判断来应对。
正确处理 sql.ErrNoRows
当使用 db.QueryRow() 查询单行数据时，如果结果为空，Go 不会返回 nil 指针，而是将 err 设为 sql.ErrNoRows。此时应明确处理该情况：
var name string
err := db.QueryRow("SELECT name FROM users WHERE id = ?", userID).Scan(&name)
if err != nil {
if errors.Is(err, sql.ErrNoRows) {
// 用户不存在，业务上可接受的情况
log.Printf("用户 %d 不存在", userID)
return nil
}
// 其他错误，如 SQL 错误、连接问题
log.Printf("查询出错: %v", err)
return err
}
这里使用 errors.Is() 判断是否为 sql.ErrNoRows，避免直接比较错误字符串。
处理驱动特定错误（如 MySQL 唯一键冲突）
某些错误需要依赖数据库驱动的具体实现。例如 MySQL 插入重复唯一键时会返回特定错误码。以官方 MySQL 驱动为例：
_, err := db.Exec("INSERT INTO users (email) VALUES (?)", email)
if err != nil {
var mysqlErr *mysql.MySQLError
if errors.As(err, &mysqlErr) {
if mysqlErr.Number == 1062 {
log.Printf("邮箱已存在: %s", email)
return &DuplicateEmailError{Email: email}
}
}
return fmt.Errorf("插入失败: %w", err)
}
利用 errors.As() 可以提取底层驱动错误，进而根据错误码进行精细化处理。这种方式适用于需要区分不同数据库异常的场景。
统一错误封装与日志记录
在实际项目中，建议对数据库错误进行封装，便于上层服务识别和处理。可以定义自定义错误类型：
type DBError struct {
Op string // 操作类型，如 "create_user"
Err error // 底层错误
}
func (e *DBError) Error() string {
return fmt.Sprintf("数据库操作 %s 失败: %v", e.Op, e.Err)
}
在 DAO 层捕获原始错误后，包装上下文信息再向上抛出：
_, err := db.Exec(query, args...)
if err != nil {
return &DBError{Op: "insert_user", Err: err}
}
结合日志系统，在关键节点记录错误详情，有助于排查生产环境问题。
基本上就这些。Go 的数据库错误处理重在清晰判断和分层处理。掌握 errors.Is 和 errors.As 的使用，能有效提升代码健壮性。对于常见错误如记录不存在或唯一键冲突，应设计合理的业务响应逻辑，而不是简单地将所有 error 视为致命问题。
