正确捕获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其中，第1篇为入门篇，主要包括了解PHP、PHP开发环境搭建、PHP开发基础、PHP流程控制语句、函数、字符串操作、正则表达式、PHP数组、PHP与Web页面交互、日期和时间等内容；第2篇为提高篇，主要包括MySQL数据库设计、PHP操作MySQL数据库、Cookie和Session、图形图像处理技术、文件和目录处理技术、面向对象、PDO数据库抽象层、程序调试与错误处理、A
建议使用结构化日志库如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的习惯，并让日志足够详细又不泄露敏感信息。不复杂但容易忽略。
