在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：

法语写作助手

法语助手旗下的AI智能写作平台，支持语法、拼写自动纠错，一键改写、润色你的法语作文。

31

查看详情

 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的习惯，结合业务区分处理，并保留足够的调试信息。不复杂但容易忽略细节。