Golang数据库错误处理与sql包分析

在Golang中处理数据库操作错误的关键在于显式检查、类型判断和分层封装。1. 每个error返回值都必须检查，不能忽略，否则可能导致后续操作panic或延迟错误暴露；2. 使用errors.Is()和errors.As()判断错误类型，也可结合类型断言或谨慎使用字符串匹配来识别具体错误；3. 常见错误包括sql.ErrNoRows、连接失败、SQL语法错误等，应根据情况分别处理；4. 错误应分层封装，避免直接log.Fatal，而是返回自定义错误类型供上层统一处理，提高程序健壮性。

在Golang中处理数据库操作错误，特别是使用标准库database/sql时，很多人一开始都会觉得有点“别扭”——因为Go的错误处理机制不像其他语言那样有异常抛出，而是强制你面对每一个可能出错的地方。但这种设计其实也带来了更高的可读性和可控性。

关键点在于：不要忽略任何error返回值；区分不同的错误类型；理解sql包中错误发生的常见场景和检查方式。

1. 错误必须显式检查，不能“跳过”

Go的设计哲学是“显式优于隐含”，所以你在使用sql.DB或*sql.Rows等对象进行查询、执行语句时，几乎每个方法都会返回一个error。比如：

rows, err := db.Query("SELECT name FROM users")
if err != nil {
    log.Fatal(err)
}

如果你不检查这个err，程序就可能在后续操作（比如遍历rows）时panic。更糟糕的是，有些错误不会立刻暴露出来，而是在运行一段时间后才被触发。

建议：

• 每个带有error返回的方法都必须检查。
• 不要用 _ = xxx 忽略错误。
• 如果你确定某个错误可以忽略，也要写注释说明原因。

2. sql包的错误类型比较有限，需要结合上下文判断

database/sql本身并没有提供太多结构化的错误类型，大部分情况下你只能拿到一个error接口。但你可以通过一些技巧来判断错误的具体类型：

常见错误判断方式：

• 使用errors.Is()和errors.As()（推荐）

  Go 1.13之后引入了这两个函数，可以用来匹配特定的错误类型或值。例如：

  var err error
  if errors.Is(err, sql.ErrNoRows) {
      // 处理没有结果的情况
  }

• 类型断言（type assertion）

  有时候你可能需要具体判断底层驱动返回的错误类型，比如MySQL的连接超时：

  if driverErr, ok := err.(*mysql.MySQLError); ok {
      if driverErr.Number == 1045 { // 权限错误
          // 处理权限问题
      }
  }

• 字符串匹配（慎用）

  虽然不推荐，但在某些情况下可以通过err.Error()判断错误信息：

  if strings.Contains(err.Error(), "connection refused") {
      // 处理连接失败
  }

  但这种方式不稳定，不同数据库驱动可能返回不同格式的信息。

3. 理解常见的错误来源和应对策略

- 查询没有结果：sql.ErrNoRows

这是最常遇到的一种情况之一，通常出现在QueryRow()中：

var name string
err := db.QueryRow("SELECT name FROM users WHERE id = ?", 999).Scan(&name)
if err != nil {
    if errors.Is(err, sql.ErrNoRows) {
        fmt.Println("用户不存在")
    } else {
        fmt.Println("其他错误", err)
    }
}

- 连接池耗尽或连接失败

这类错误通常是由于数据库连接配置不合理，或者数据库服务不可达导致的。你可以在日志中看到类似：

dial tcp [::1]:3306: connect: connection refused

解决办法：

• 检查数据库是否正常运行。
• 设置合理的最大连接数和空闲连接数：

db.SetMaxOpenConns(20)
db.SetMaxIdleConns(10)

- SQL语法错误或字段不匹配

这类错误往往发生在开发阶段，比如拼接SQL时字段名写错了，或者Scan()的目标变量类型不匹配：

var age int
err := row.Scan(&age) // 实际字段是VARCHAR，就会报错

这种情况一般会在测试阶段发现，上线后较少出现。

4. 错误处理要分层，避免“裸奔”log.Fatal

虽然log.Fatal()很适合快速调试，但它一旦触发就会直接终止程序，这在生产环境中不是好做法。

更好的方式是：

• 在业务逻辑中封装错误，返回给调用者处理。
• 使用中间件统一捕获并记录错误。
• 对外返回友好的错误提示，而不是原始错误信息。

比如你可以定义自己的错误类型：

type AppError struct {
    Code    int
    Message string
    Err     error
}

func (e *AppError) Error() string {
    return e.Message
}

这样在上层就可以根据Code做不同的处理。

基本上就这些。Go的错误处理看似繁琐，但只要你养成良好的习惯，比如不忽略error、合理分类错误、适当封装，它反而能让你写出更健壮的代码。尤其是涉及数据库操作时，每一步都可能出错，细致的错误检查就是稳定性的保障。