0

0

Golang Web如何处理错误_Golang Web错误处理规范

P粉602998670

P粉602998670

发布时间:2026-01-31 13:07:22

|

973人浏览过

|

来源于php中文网

原创

Go Web错误处理需显式传递、分层包装、统一响应;直接return err语法错误,http.Error丢失错误链/码/上下文;应返回(interface{}, error),用fmt.Errorf("%w")包装、errors.Is判断、AppError结构体区分业务错误,中间件统一设Content-Type并按Code映射状态码。

golang web如何处理错误_golang web错误处理规范

Go Web 错误处理不是“捕获异常”,而是显式传递、分层包装、统一响应——不按这个逻辑做,90% 的 panic 和 500 错误都源于错误被忽略或裸返回。

为什么不能直接 return err 在 handler 里?

Go 的 http.HandlerFunc 签名不支持返回 error,写 return err 是语法错误;更常见的是误用 http.Error(w, err.Error(), 500),这会丢失三样关键东西:原始错误链(无法用 errors.Is 判断)、业务错误码(如“用户不存在”该是 404 还是 1002)、上下文信息(比如哪步解析失败)。

  • 正确做法:handler 返回 (interface{}, error),由中间件统一解包并渲染
  • 错误必须带上下文:用 fmt.Errorf("get user %q: %w", id, err),不是 fmt.Errorf("get user: %s", err)
  • 禁止在 handler 里调用 log.Printf——日志应由中间件或 AppError.Error() 统一输出,含 traceID 和路径

如何用 errors.Is 安全判断 sql.ErrNoRows

数据库查不到记录(sql.ErrNoRows)是正常业务流,不是 bug。但很多人写 if err == sql.ErrNoRows,结果一包装就失效——因为 fmt.Errorf("load: %w", err) 后,err 已不是原始指针,而是包装后的错误链。

  • 永远用 errors.Is(err, sql.ErrNoRows),它能穿透任意层数的 %w 包装
  • 不要把 sql.ErrNoRows 再包装成 “not found” 错误向上抛——它本身已是标准、可预测、可测试的信号
  • 其他 DB 错误(如 context.DeadlineExceeded)要单独判断,该重试就重试,不该暴露给前端

中间件怎么同时处理 panic 和业务 error

一个中间件只做一件事:recover panic 是底线,但不能止步于此。真正健壮的错误中间件,要能识别 handler 返回的 *AppError 并映射到对应 HTTP 状态码,而不是一律打成 500。

自学 PHP、MySQL和Apache
自学 PHP、MySQL和Apache

本书将PHP开发与MySQL应用相结合,分别对PHP和MySQL做了深入浅出的分析,不仅介绍PHP和MySQL的一般概念,而且对PHP和MySQL的Web应用做了较全面的阐述,并包括几个经典且实用的例子。 本书是第4版,经过了全面的更新、重写和扩展,包括PHP5.3最新改进的特性(例如,更好的错误和异常处理),MySQL的存储过程和存储引擎,Ajax技术与Web2.0以及Web应用需要注意的安全

下载

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

  • 定义 type AppError struct { Code int; Message string; Err error }Err 字段用 json:"-" 隐藏,避免泄露
  • 中间件中用 errors.As(err, &appErr) 提取业务错误,再按 appErr.Code 设置 w.WriteHeader()
  • 对未识别的 panic 或非 *AppError 错误,统一记日志 + 返回 http.StatusInternalServerError,不暴露堆

writeError 函数为什么必须显式设 Content-Type

很多接口返回错误时出现乱码或前端解析失败,根本原因是没设 header。Go 的 json.NewEncoder 不会自动设 Content-Type,而某些反向代理或浏览器在缺失时会按 text/plain 解析 JSON 字符串。

  • 必须在 writeError 开头加 w.Header().Set("Content-Type", "application/json; charset=utf-8")
  • details 字段要判空:Details: details 若传 nil,JSON 编码后是 "details": null,前端可能崩溃;建议用指针或预处理
  • 状态码顺序不能错:先 w.WriteHeader(),再 json.NewEncoder().Encode(),否则可能写入失败且无提示

最易被忽略的一点:错误包装只应在**职责边界**发生一次——DAO 层返回原始 os.PathError,Service 层包装为 "failed to load config: %w",Handler 层只负责映射和响应,不再二次包装。多包一层,就多一层解析成本和歧义风险。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

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

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

182

2024.02.23

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

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

229

2024.02.23

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

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

343

2024.02.23

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

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

210

2024.03.05

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

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

396

2024.05.21

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

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

240

2025.06.09

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

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

194

2025.06.10

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

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

478

2025.06.17

2026赚钱平台入口大全
2026赚钱平台入口大全

2026年最新赚钱平台入口汇总,涵盖任务众包、内容创作、电商运营、技能变现等多类正规渠道,助你轻松开启副业增收之路。阅读专题下面的文章了解更多详细内容。

30

2026.01.31

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
WEB前端教程【HTML5+CSS3+JS】
WEB前端教程【HTML5+CSS3+JS】

共101课时 | 8.6万人学习

JS进阶与BootStrap学习
JS进阶与BootStrap学习

共39课时 | 3.2万人学习

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

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