正确捕获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等上下文，便于定位问题。
建议使用结构化日志库如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数据库操作错误捕获与日志记录的详细内容，更多请关注创想鸟其它相关文章！
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容， 请发送邮件至 chuangxiangniao@163.com 举报，一经查实，本站将立刻删除。
发布者：程序猿，转转请注明出处：https://www.chuangxiangniao.com/p/1406957.html
微信扫一扫 
支付宝扫一扫 
![Go语言接口与切片：如何识别和操作[]interface{}](https://cdn.chuangxiangniao.com/www/2025/12/176369856569294-1.jpg?imageMogr2/crop/480x300/gravity/center)
