Go中处理数据库错误需分三步：先用db.Ping()验证连接，再对每个Query/Exec等操作检查error，最后区分临时错误（如连接超时）与永久错误（如语法错误）并合理重试或返回。
在 Go 中处理数据库操作错误，核心是理解 sql.DB 本身不表示连接状态，而每个具体操作（如 Query、Exec、Prepare）才可能返回 error。不能只检查 sql.Open 的返回值就认为后续操作一定成功。
sql.Open 不等于连接成功
sql.Open 只是初始化连接池配置，并不真正建立数据库连接。它返回的 error 仅表示参数错误（如驱动名不对、DSN 格式非法），不代表数据库是否可达。
正确做法是调用 db.Ping() 主动验证连接：
-
err := db.Ping()—— 同步尝试一次连接，失败则返回真实错误（如网络不通、认证失败） - 建议在服务启动时执行一次
Ping，并重试或记录日志 - 不要忽略
Ping错误，尤其在关键服务初始化阶段
每条 SQL 操作都要检查 error
sql.DB 的所有执行方法（Query、QueryRow、Exec、Prepare 等）都返回 error，必须显式判断：
立即学习“go语言免费学习笔记（深入）”；
-
rows, err := db.Query("SELECT * FROM users WHERE id = ?", id)—— 即使语句语法正确，也可能因超时、权限不足、表不存在等失败 -
_, err := db.Exec("INSERT INTO logs(...) VALUES (...)", ...)—— 注意检查err，而非只看影响行数 - 即使
QueryRow.Scan()成功，也要检查Scan返回的error（例如列类型不匹配、NULL 值扫描到非指针变量）
区分临时错误与永久错误
某些错误（如网络抖动、连接池耗尽）可能是暂时的，适合重试；而语法错误、权限拒绝通常是永久性的。Go 标准库未直接暴露错误类型，但可通过以下方式判断：
- 检查
err是否为*pq.Error（PostgreSQL）、*mysql.MySQLError（MySQL）等驱动特有类型，获取SQLState或Number - 常见可重试错误码：PostgreSQL 的
"08"类（连接异常）、MySQL 的1205（死锁）、1040（连接数超限） - 使用
errors.Is(err, sql.ErrNoRows)判断“查无结果”，这是正常业务逻辑分支，不是异常
避免 panic，用 error 包装和传播
不要用 log.Fatal 或 panic 处理可预期的数据库错误（如用户 ID 不存在）。应将错误逐层返回，由上层决定如何响应（返回 HTTP 404、重试、降级）：
- 函数签名明确返回
error，例如：func GetUser(id int) (*User, error) - 必要时用
fmt.Errorf("failed to query user %d: %w", id, err)包装原始错误，保留调用链 - 对敏感错误（如密码、连接串）做脱敏处理，避免泄露到日志或 API 响应中
