在Golang数据库操作中,必须始终检查error返回值以确保程序健壮性。1. 所有数据库操作如Query、Exec等均需判断err,不可忽略;2. 区分错误类型:sql.ErrNoRows表示无数据,属正常逻辑分支;连接错误或约束冲突则需重试或提示用户;3. 使用errors.Is判断语义错误(如errors.Is(err, sql.ErrNoRows)),用errors.As提取底层错误(如*mysql.MySQLError)进行特定处理;4. 通过fmt.Errorf("%w")包装错误并添加上下文,保留调用链便于排查。核心是养成主动处理错误的习惯,结合业务逻辑分类响应,并传递足够调试信息。

在使用Golang进行数据库操作时,错误处理是保证程序健壮性和可维护性的关键环节。Go语言通过返回error类型显式暴露问题,而不是隐藏异常,这要求开发者主动检查并合理响应每一个可能的错误。特别是在数据库交互中,网络中断、连接超时、SQL语法错误、数据约束冲突等问题频繁发生,良好的错误处理机制能有效提升系统稳定性。
1. 始终检查error返回值
几乎所有数据库操作方法都会返回error,忽略它是常见但危险的做法。
说明:无论是执行SQL语句、查询数据还是获取连接,都必须对返回的error进行判断。
建议写法:
立即学习“go语言免费学习笔记(深入)”;
rows, err := db.Query("SELECT name FROM users WHERE age = ?", age)
if err != nil {
log.Printf("查询失败: %v", err)
return err
}
defer rows.Close()
即使后续用rows.Next()遍历结果,也不能省略对Query本身错误的检查。
2. 区分不同类型的数据库错误
并不是所有数据库错误都需要同等对待。例如“记录不存在”和“连接 refused”应有不同的处理策略。
常见场景与处理方式:
-
sql.ErrNoRows:单行查询未找到结果(如
QueryRow)。这不是异常,而是业务逻辑的一部分,可安全忽略或返回默认值。 - 连接类错误:如网络断开、认证失败等,通常需要重试或上报监控。
- 约束冲突:如唯一索引冲突(MySQL的1062错误),适合记录日志并提示用户调整输入。
示例判断ErrNoRows:
使用模板与程序分离的方式构建,依靠专门设计的数据库操作类实现数据库存取,具有专有错误处理模块,通过 Email 实时报告数据库错误,除具有满足购物需要的全部功能外,成新商城购物系统还对购物系统体系做了丰富的扩展,全新设计的搜索功能,自定义成新商城购物系统代码功能代码已经全面优化,杜绝SQL注入漏洞前台测试用户名:admin密码:admin888后台管理员名:admin密码:admin888
var name string
err := db.QueryRow("SELECT name FROM users WHERE id = ?", userID).Scan(&name)
if err != nil {
if errors.Is(err, sql.ErrNoRows) {
return "", fmt.Errorf("用户不存在")
}
return "", fmt.Errorf("数据库查询出错: %w", err)
}
3. 使用errors.Is和errors.As进行错误比较
Go 1.13+ 推荐使用errors.Is和errors.As代替字符串匹配来判断错误类型,更安全可靠。
为什么不用err == sql.ErrNoRows?
因为多层封装后原始错误可能被包装,直接比较会失败。
正确做法:
if errors.Is(err, sql.ErrNoRows) {
// 处理无数据情况
}
若需提取具体错误类型(如*mysql.MySQLError),可用errors.As:
var mysqlErr *mysql.MySQLError
if errors.As(err, &mysqlErr) {
if mysqlErr.Number == 1062 {
log.Println("唯一键冲突")
}
}
4. 统一错误封装与上下文添加
原始错误信息往往缺乏上下文,不利于排查问题。
建议使用%w格式化动词包装错误,保留调用链:
_, err := db.Exec("INSERT INTO users(name) VALUES(?)", name)
if err != nil {
return fmt.Errorf("插入用户%s失败: %w", name, err)
}
这样上层捕获错误时,既能知道发生在哪一步,又能通过errors.Unwrap追溯根本原因。
基本上就这些。关键是养成每步检查error的习惯,结合业务区分处理,并保留足够的调试信息。不复杂但容易忽略细节。









