0

0

如何在Golang中处理数据库操作错误_Golang数据层错误处理方案

P粉602998670

P粉602998670

发布时间:2026-01-13 12:48:52

|

798人浏览过

|

来源于php中文网

原创

Go数据库错误需分层处理:先判sql.ErrNoRows,再用errors.As识别驱动错误(如pq.Error码“23505”),网络错误需重试,事务须显式Rollback并防panic,超时需应用层与数据库级协同配置。

如何在golang中处理数据库操作错误_golang数据层错误处理方案

Go 的 database/sql 错误不是一次性判空就完事的

很多刚写 Go 数据库代码的人会直接写 if err != nil 然后 panic 或 log 后返回,但这在生产环境极不可靠。因为 database/sqlerr 可能是连接中断、事务已提交失败、SQL 语法错、主键冲突、超时、甚至 driver 自定义错误(如 pq.Error),它们的处理策略完全不同。

真正该做的是:先判断是否为 sql.ErrNoRows 这类预期错误;再用类型断言识别 driver 特定错误;最后才兜底处理其他非预期错误。

  • sql.ErrNoRows 是常见且安全的“查不到”,通常不需报警,业务可按默认值或空结构体继续
  • PostgreSQL 驱动(github.com/lib/pq)的错误需断言为 *pq.Error,再检查 Code 字段(如 "23505" 表示唯一约束冲突)
  • MySQL 驱动(github.com/go-sql-driver/mysql)错误要断言为 *mysql.MySQLError,看 Number(如 1062 是重复键)
  • 网络类错误(如 net.OpErrordriver.ErrBadConn)往往意味着连接池需重建或重试

errors.As 判断驱动错误比类型断言更健壮

Go 1.13+ 推荐用 errors.As 而非直接类型断言,因为它能穿透多层包装错误(比如 fmt.Errorf("query failed: %w", pqErr))。直接断言会失败,而 errors.As 可以递归解包。

var pqErr *pq.Error
if errors.As(err, &pqErr) {
    switch pqErr.Code {
    case "23505": // unique_violation
        return fmt.Errorf("用户名已被注册:%w", err)
    case "23503": // foreign_key_violation
        return fmt.Errorf("关联资源不存在:%w", err)
    default:
        return fmt.Errorf("数据库操作异常:%w", err)
    }
}

注意:必须传入指针地址 &pqErr,否则 errors.As 无法赋值;若使用 MySQL,对应换成 *mysql.MySQLError 即可。

立即学习go语言免费学习笔记(深入)”;

成新网络商城购物系统
成新网络商城购物系统

使用模板与程序分离的方式构建,依靠专门设计的数据库操作类实现数据库存取,具有专有错误处理模块,通过 Email 实时报告数据库错误,除具有满足购物需要的全部功能外,成新商城购物系统还对购物系统体系做了丰富的扩展,全新设计的搜索功能,自定义成新商城购物系统代码功能代码已经全面优化,杜绝SQL注入漏洞前台测试用户名:admin密码:admin888后台管理员名:admin密码:admin888

下载

事务中出错必须显式 tx.Rollback(),且要检查 Rollback 错误

很多人只记得 tx.Commit() 成功与否,却忽略 tx.Rollback() 也可能失败(比如连接已断)。一旦 Commit 失败后没 Rollback,连接可能卡在“in transaction”状态,后续从连接池取到该连接的请求会直接报 pq: current transaction is aborted

  • 所有事务函数结尾必须有 defer func() { if r := recover(); r != nil { tx.Rollback() } }() 防 panic 导致漏 rollback
  • Commit 失败后立即 Rollback,并检查其返回的 err —— 若 rollback 也失败,说明连接已不可用,应记录并标记连接池需刷新
  • 不要在 Rollback 后继续用该 tx 对象,它已失效
tx, err := db.Begin()
if err != nil {
    return err
}
defer func() {
    if p := recover(); p != nil {
        tx.Rollback()
        panic(p)
    }
}()
_, err = tx.Exec("INSERT INTO users(name) VALUES($1)", name)
if err != nil {
    tx.Rollback() // 必须立刻回滚
    return err
}
return tx.Commit()

超时和上下文取消不能只靠 context.WithTimeout

仅给 db.QueryContext 传带超时的 ctx 不够。底层 driver 可能仍卡在 socket read,或数据库端执行未中断(尤其 PostgreSQL 的 long-running query)。必须配合数据库级 timeout 设置:

  • PostgreSQL:在连接字符串加 connect_timeout=5statement_timeout=30000(单位毫秒)
  • MySQL:连接参数设 timeout=5s&readTimeout=30s&writeTimeout=30s
  • 应用层 context.WithTimeout 应略短于数据库 timeout(比如设 25s),留出网络往返和 driver 处理余量
  • db.PingContext 也要设超时,避免健康检查阻塞整个服务启动

最易被忽略的一点:sql.DBSetConnMaxLifetimeSetMaxOpenConns 配置不当,会导致大量 “connection refused” 或 “too many connections”,这类错误不会出现在单条 SQL 的 err 中,而是在 db.Ping 或连接获取阶段暴露。

相关专题

更多
golang如何定义变量
golang如何定义变量

golang定义变量的方法:1、声明变量并赋予初始值“var age int =值”;2、声明变量但不赋初始值“var age int”;3、使用短变量声明“age :=值”等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

178

2024.02.23

golang有哪些数据转换方法
golang有哪些数据转换方法

golang数据转换方法:1、类型转换操作符;2、类型断言;3、字符串和数字之间的转换;4、JSON序列化和反序列化;5、使用标准库进行数据转换;6、使用第三方库进行数据转换;7、自定义数据转换函数。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

226

2024.02.23

golang常用库有哪些
golang常用库有哪些

golang常用库有:1、标准库;2、字符串处理库;3、网络库;4、加密库;5、压缩库;6、xml和json解析库;7、日期和时间库;8、数据库操作库;9、文件操作库;10、图像处理库。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

337

2024.02.23

golang和python的区别是什么
golang和python的区别是什么

golang和python的区别是:1、golang是一种编译型语言,而python是一种解释型语言;2、golang天生支持并发编程,而python对并发与并行的支持相对较弱等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

208

2024.03.05

golang是免费的吗
golang是免费的吗

golang是免费的。golang是google开发的一种静态强类型、编译型、并发型,并具有垃圾回收功能的开源编程语言,采用bsd开源协议。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

388

2024.05.21

golang结构体相关大全
golang结构体相关大全

本专题整合了golang结构体相关大全,想了解更多内容,请阅读专题下面的文章。

194

2025.06.09

golang相关判断方法
golang相关判断方法

本专题整合了golang相关判断方法,想了解更详细的相关内容,请阅读下面的文章。

189

2025.06.10

golang数组使用方法
golang数组使用方法

本专题整合了golang数组用法,想了解更多的相关内容,请阅读专题下面的文章。

192

2025.06.17

PHP 表单处理与文件上传安全实战
PHP 表单处理与文件上传安全实战

本专题聚焦 PHP 在表单处理与文件上传场景中的实战与安全问题,系统讲解表单数据获取与校验、XSS 与 CSRF 防护、文件类型与大小限制、上传目录安全配置、恶意文件识别以及常见安全漏洞的防范策略。通过贴近真实业务的案例,帮助学习者掌握 安全、规范地处理用户输入与文件上传的完整开发流程。

5

2026.01.13

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
MySQL 教程
MySQL 教程

共48课时 | 1.7万人学习

MySQL 初学入门(mosh老师)
MySQL 初学入门(mosh老师)

共3课时 | 0.3万人学习

简单聊聊mysql8与网络通信
简单聊聊mysql8与网络通信

共1课时 | 787人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号