0

0

如何在Golang中处理网络错误_Golang net/http 错误处理方法

P粉602998670

P粉602998670

发布时间:2026-01-11 12:14:34

|

355人浏览过

|

来源于php中文网

原创

http.Do失败需同时检查err和resp.StatusCode:err!=nil为网络层错误,err==nil但StatusCode>=400为服务端错误;必须检查状态码并关闭resp.Body。

如何在golang中处理网络错误_golang net/http 错误处理方法

判断 http.Do 是否失败不能只看返回值是否为 nil

很多初学者以为只要 resp 不是 nil 就代表请求成功,其实不然。http.Do 在底层连接失败、DNS 解析失败、TLS 握手失败等情况下会直接返回错误,respnil;但若请求发出去了、服务器返回了非 2xx 状态码(比如 404、500),resp 依然非 nil,而 errnil —— 这时你必须手动检查 resp.StatusCode

  • err != nil:说明网络层或协议层出问题(如超时、拒绝连接、证书错误)
  • err == nil && resp.StatusCode >= 400:说明服务端返回了错误响应,属于业务/语义错误
  • 两者都需处理,缺一不可

net.Error 类型断言能区分超时与拒绝连接

err != nil 时,常见错误类型包括 *url.Error*net.OpErrornet.DNSError 等。其中最实用的是用 net.Error 接口判断是否超时或临时不可达:

if urlErr, ok := err.(*url.Error); ok {
    if netErr, ok := urlErr.Err.(net.Error); ok {
        if netErr.Timeout() {
            log.Println("请求超时")
        }
        if netErr.Temporary() {
            log.Println("临时性网络错误,可重试")
        }
    }
}
  • Timeout() 返回 true 表示超时(含 context.DeadlineExceeded
  • Temporary() 对 DNS 失败、连接被拒、IO timeout 等多数网络抖动场景返回 true,适合做指数退避重试
  • 注意:net.Error 不涵盖 HTTP 协议级错误(如 401),它只管底层连接

使用 context.WithTimeout 控制请求生命周期比设置 Client.Timeout 更灵活

http.Client.Timeout 是全局兜底,一旦设死就无法 per-request 调整;而 context 可在调用链任意位置注入取消信号,更适合真实场景:

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

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

下载
ctx, cancel := context.WithTimeout(context.Background(), 5*time.Second)
defer cancel()

req, _ := http.NewRequestWithContext(ctx, "GET", "https://api.example.com/data", nil)
resp, err := http.DefaultClient.Do(req)
if err != nil {
    // 此处 err 可能是 context.DeadlineExceeded 或 net.OpError
    if errors.Is(err, context.DeadlineExceeded) {
        log.Println("上下文超时,不是网络故障")
    }
    return
}
  • errors.Is(err, context.DeadlineExceeded) 比类型断言更安全(兼容 Go 1.13+)
  • 若请求本身已携带 context(如 HTTP handler 的 r.Context()),直接复用,避免新建
  • Client.Timeout 仅作用于整个请求周期(从 Dial 到读完 body),不覆盖 DNS 查询耗时;而 context 覆盖全部

读取 resp.Body 前必须检查 StatusCode,且务必 Close

即使 err == nil,也要先检查状态码再决定是否读 body,否则可能把 404 页面当成正常数据解析;同时,无论成功失败,resp.Body 都必须关闭,否则连接不会复用,容易触发 too many open files

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

if resp.StatusCode < 200 || resp.StatusCode >= 300 {
    log.Printf("HTTP %d: %s", resp.StatusCode, resp.Status)
    resp.Body.Close() // 必须关!
    return
}

defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
// ... 处理 body
  • 不要在 if err != nil 分支里才 Close():因为 err == nilBody 仍可能非空且需释放
  • defer 放在检查状态码之后,确保不遗漏
  • 如果后续要用 resp.Body 流式处理(如解压、解密),也得自己控制 Close 时机,不能无脑 defer
实际项目中,最容易被忽略的是「服务端返回 5xx 时没做重试」和「忘记关 Body 导致连接池耗尽」——这两点比语法细节更容易拖垮线上服务。

相关专题

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

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

177

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、图像处理库。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

336

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

c++主流开发框架汇总
c++主流开发框架汇总

本专题整合了c++开发框架推荐,阅读专题下面的文章了解更多详细内容。

78

2026.01.09

热门下载

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

精品课程

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

共32课时 | 3.6万人学习

Go语言实战之 GraphQL
Go语言实战之 GraphQL

共10课时 | 0.8万人学习

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

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