0

0

如何使用Golang处理HTTP请求错误_GolangHTTP响应错误处理示例

P粉602998670

P粉602998670

发布时间:2026-01-02 18:09:32

|

426人浏览过

|

来源于php中文网

原创

HTTP请求失败时resp可能为nil,须先判空再访问;需区分网络层、TLS层、HTTP语义层错误,用errors.As精准判断;StatusCode≥400仍需读取响应体,但须用context和MaxBytesReader限流限超时。

如何使用golang处理http请求错误_golanghttp响应错误处理示例

HTTP请求失败时,resp 可能为 nil,必须先判空再读取

Go 的 http.DefaultClient.Do() 在网络不可达、DNS失败、连接超时等情况下会直接返回 err != nil,此时 respnil。如果跳过判空就调用 resp.StatusCoderesp.Body.Close(),会触发 panic。

  • 永远在 if err != nil 后加 return 或显式处理,不要继续执行后续依赖 resp 的逻辑
  • 即使 err == nil,也不能假设请求“成功”——HTTP 状态码404500 仍属于服务端错误,需单独检查 resp.StatusCode
  • 务必调用 resp.Body.Close()(在 err == nilresp != nil 时),否则连接不会复用,容易耗尽文件描述符

区分三类错误:网络层、TLS层、HTTP语义层

Go 的 HTTP 错误不是单一类型,不同错误需要不同策略:

  • 网络错误:如 dial tcp: i/o timeoutconnection refused,通常来自 net.OpError,适合重试(配合指数退避)
  • TLS 错误:如 x509: certificate signed by unknown authority,多因证书配置问题,重试无意义,应检查 http.Client.Transport.TLSClientConfig
  • HTTP 语义错误:如 401 Unauthorized429 Too Many Requests,需解析响应体(如 JSON error message)并按业务逻辑处理,而非当网络故障重试

errors.As 提取底层错误类型做精准判断

直接用 strings.Contains(err.Error(), "timeout") 不可靠——错误信息可能随 Go 版本变化。推荐用 errors.As 匹配具体错误类型:

动态WEB网站中的PHP和MySQL:直观的QuickPro指南第2版
动态WEB网站中的PHP和MySQL:直观的QuickPro指南第2版

动态WEB网站中的PHP和MySQL详细反映实际程序的需求,仔细地探讨外部数据的验证(例如信用卡卡号的格式)、用户登录以及如何使用模板建立网页的标准外观。动态WEB网站中的PHP和MySQL的内容不仅仅是这些。书中还提到如何串联JavaScript与PHP让用户操作时更快、更方便。还有正确处理用户输入错误的方法,让网站看起来更专业。另外还引入大量来自PEAR外挂函数库的强大功能,对常用的、强大的包

下载
var netErr net.Error
if errors.As(err, &netErr) && netErr.Timeout() {
    // 处理超时,例如记录指标或触发重试
}
var urlErr *url.Error
if errors.As(err, &urlErr) && urlErr.Err != nil {
    // 检查 urlErr.Err 是否为 *net.OpError 等
}
  • net.Error 接口提供 Timeout()Temporary() 方法,比字符串匹配更健壮
  • url.Error 封装了原始错误,常用于 DNS 解析失败或 URL 格式错误
  • 避免对 err.Error() 做子串匹配,尤其在线上环境——它不属于 API 合约,随时可能调整

响应体读取前必须检查 resp.StatusCode,且用 io.ReadAll 配合 context 控制读取时限

即使 resp.StatusCode >= 400,服务端仍可能返回有意义的错误体(如 {"error": "invalid_token"})。但直接调用 io.ReadAll(resp.Body) 有风险:

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

  • 若服务端未关闭连接或发送超大响应体,会阻塞甚至 OOM
  • 应结合 context.WithTimeout 限制整个读取过程,而不是只限请求发起
  • 始终用 defer resp.Body.Close()(在确认 resp != nil 后立即 defer)
ctx, cancel := context.WithTimeout(context.Background(), 5*time.Second)
defer cancel()
body, err := io.ReadAll(http.MaxBytesReader(ctx, resp.Body, 1<<20)) // 限制最大 1MB
if err != nil {
    // 处理读取超时或过大响应
}
实际处理中,最易被忽略的是:**把 4xx/5xx 当作网络错误统一重试**,结果导致鉴权失败反复刷 token,或 429 被持续加重。状态码语义必须由业务代码显式分支处理,不能交给通用重试逻辑兜底。

相关专题

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

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

174

2024.02.23

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

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

225

2024.02.23

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

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

335

2024.02.23

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

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

206

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数组用法,想了解更多的相关内容,请阅读专题下面的文章。

191

2025.06.17

php源码安装教程大全
php源码安装教程大全

本专题整合了php源码安装教程,阅读专题下面的文章了解更多详细内容。

74

2025.12.31

热门下载

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

精品课程

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

共101课时 | 8.1万人学习

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

共39课时 | 3.1万人学习

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

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