Golang数据库操作错误捕获与日志记录

正确捕获Golang数据库错误并记录结构化日志是保障系统稳定的关键。应每次操作后检查err，区分错误类型如sql.ErrNoRows并针对性处理，避免忽略rows.Err()等细节。日志需包含操作类型、SQL语句（脱敏）、参数、用户ID等上下文，推荐使用slog或zap输出JSON格式。通过封装通用函数统一处理错误与日志，减少重复代码，确保敏感信息不泄露，提升可维护性。

在使用Golang进行数据库操作时，错误捕获与日志记录是保障系统稳定性和可维护性的关键环节。很多开发者在处理数据库调用时容易忽略细节，导致问题难以排查。正确的做法是：每次数据库操作后立即检查错误，并结合结构化日志记录上下文信息。

错误捕获：不要忽略err

Go语言通过返回error类型表示操作失败，数据库操作尤其需要严谨处理。常见操作如查询、插入、更新都可能因连接问题、SQL语法错误、超时或数据约束失败而返回错误。

示例：

rows, err := db.Query("SELECT name FROM users WHERE id = ?", userID)
if err != nil {
  log.Printf("查询用户失败: %v", err)
  return err
}
defer rows.Close()

注意：即使Query成功，后续遍历rows.Next()也可能出错，应通过rows.Err()检查迭代过程是否正常结束。

立即学习“go语言免费学习笔记（深入）”；

区分错误类型并做针对性处理

不是所有数据库错误都需要同等对待。例如，记录不存在（sql.ErrNoRows）在某些场景下是正常逻辑分支，不应作为严重错误记录。

示例：

err := db.QueryRow("SELECT name FROM users WHERE id = ?", 999).Scan(&name)
if err != nil {
  if errors.Is(err, sql.ErrNoRows) {
    log.Printf("用户不存在: %d", 999)
    return nil // 业务上可接受
  }
  log.Printf("数据库查询出错: %v", err)
  return err
}

日志记录应包含上下文信息

单纯记录“数据库错误”意义不大。应包含操作类型、SQL语句（脱敏）、参数、影响行数、用户ID等上下文，便于定位问题。

10分钟内自己学会PHP

10分钟内自己学会PHP其中，第1篇为入门篇，主要包括了解PHP、PHP开发环境搭建、PHP开发基础、PHP流程控制语句、函数、字符串操作、正则表达式、PHP数组、PHP与Web页面交互、日期和时间等内容；第2篇为提高篇，主要包括MySQL数据库设计、PHP操作MySQL数据库、Cookie和Session、图形图像处理技术、文件和目录处理技术、面向对象、PDO数据库抽象层、程序调试与错误处理、A

524

查看详情

建议使用结构化日志库如log/slog或zap，输出JSON格式日志。

示例（使用slog）：

slog.Error("数据库插入失败",
  "query", "INSERT INTO orders (user_id, amount) VALUES (?, ?)",
  "user_id", userID,
  "amount", amount,
  "error", err.Error())

避免直接打印敏感数据如密码、身份证号。可用占位符代替。

使用中间件或封装统一处理错误

为减少重复代码，可将常见数据库操作封装成函数，内置错误捕获和日志记录。

例如定义一个通用查询函数：

func queryWithLog(db *sql.DB, query string, args ...interface{}) (*sql.Rows, error) {
  rows, err := db.Query(query, args...)
  if err != nil {
    slog.Error("SQL执行失败", "query", query, "args", args, "error", err)
    return nil, err
  }
  return rows, nil
}

这样在业务代码中调用更简洁，同时保证错误被统一记录。

基本上就这些。关键是养成每次操作后检查err的习惯，并让日志足够详细又不泄露敏感信息。不复杂但容易忽略。

以上就是Golang数据库操作错误捕获与日志记录的详细内容，更多请关注php中文网其它相关文章！