Golangerrors.New使用方法详解
时间:2026-01-31 18:46:32 120浏览 收藏
哈喽!大家好,很高兴又见面了,我是golang学习网的一名作者,今天由我给大家带来一篇《Golang errors.New用法详解》,本文主要会讲到等等知识点,希望大家一起学习进步,也欢迎大家关注、点赞、收藏、转发! 下面就一起来看看吧!
errors.New返回的错误不能直接比较相等,因其每次调用都创建新指针实例,故err == errors.New("x")恒为false;应使用errors.Is、自定义类型或谨慎用err.Error()。

errors.New 为什么返回的错误不能直接比较相等?
errors.New 返回的是一个私有结构体指针,每次调用都生成新实例,所以用 == 或 == nil 判断是否为某个特定错误会失败。常见误写:
if err == errors.New("timeout") { ... } 这永远为 false —— 因为左右两边是两个独立分配的错误对象。
正确做法是用 errors.Is(Go 1.13+)或自定义错误类型 + errors.As。若只需简单字符串匹配,可用 err.Error() == "timeout",但不推荐用于生产环境,因易受消息变更影响。
什么时候该用 errors.New 而不是 fmt.Errorf?
errors.New 适合创建无参数、固定文本的静态错误,比如 errors.New("connection refused");fmt.Errorf 更适合带变量插值的场景,例如 fmt.Errorf("failed to read file %q: %w", filename, io.ErrUnexpectedEOF)。
关键区别在于:
errors.New不支持格式化,也不支持错误链(%w)fmt.Errorf支持%w实现嵌套,便于后续用errors.Unwrap或errors.Is检查底层原因- 两者返回的都是
error接口,可互换使用,但语义不同
如何让 errors.New 创建的错误支持 Is 和 As?
原生 errors.New 返回的错误不实现 Unwrap() 方法,因此无法参与错误链判断。若需让它被 errors.Is 识别,必须包装或自定义类型:
type MyError struct{ msg string }
func (e *MyError) Error() string { return e.msg }
func (e *MyError) Is(target error) bool {
return target == ErrTimeout || target == e
}
var ErrTimeout = &MyError{"timeout occurred"}
或者更轻量地用 fmt.Errorf 配合 %w 包装:
var ErrTimeout = fmt.Errorf("timeout occurred") // 不带 %w,行为类似 errors.New
// 若需链式,应显式定义:
var ErrTimeout = fmt.Errorf("timeout occurred: %w", context.DeadlineExceeded)
errors.New 在 HTTP handler 中直接返回是否安全?
不安全。直接把 errors.New("invalid ID") 返回给前端,容易暴露内部逻辑或调试信息。实际 Web 服务中应做转换:
- 用中间件统一拦截
error并转成 JSON 响应(如{"error": "Bad Request"}) - 区分用户错误与系统错误:用户错误用预定义变量(
ErrNotFound = errors.New("not found")),系统错误加日志后转为 500 - 避免在错误消息中拼接用户输入,防止注入或信息泄露
典型反例:
http.Error(w, errors.New("user " + r.URL.Query().Get("id") + " not found").Error(), http.StatusNotFound) —— 用户可控输入进了错误消息,风险高。
错误链支持和语义明确性比“一行创建”更重要;别为了省一个 fmt. 前缀而放弃可诊断性。终于介绍完啦!小伙伴们,这篇关于《Golangerrors.New使用方法详解》的介绍应该让你收获多多了吧!欢迎大家收藏或分享给更多需要学习的朋友吧~golang学习网公众号也会发布Golang相关知识,快来关注吧!
-
860 收藏
-
843 收藏
-
826 收藏
-
809 收藏
-
792 收藏
-
Golang · Go教程 | 17小时前 | 并发 · 闭包 · for range · 迁移 · Go教程 · Go 1.22 · Goroutine 闭包 循环变量 Go教程 Go 1.22 for range113 收藏
-
331 收藏
-
Golang · Go教程 | 18小时前 | 单元测试 · 错误处理 · Go教程 · errors.Join · errors.Is · errors.Is Go错误处理 Go教程 errors.Join 多错误返回 批量校验352 收藏
-
Golang · Go教程 | 19小时前 | Context · 超时控制 · Go教程 · http.Client · Transport · Go context 请求超时 Transport http.Client Client.Timeout ResponseHeaderTimeout218 收藏
-
Golang · Go教程 | 20小时前 | 文件下载 · Go教程 · 审计日志 · 接口安全 · 路径穿越 · Go 文件下载 审计日志 HTTP接口 filepath.Clean 安全下载 路径穿越362 收藏
-
Golang · Go教程 | 21小时前 | Go教程 · HMAC · API安全 · 接口签名 · 防重放 · timestamp Go 中间件 API安全 HMAC 接口签名 nonce 防重放273 收藏
-
Golang · Go教程 | 21小时前 | CI/CD · gitHub actions · Go教程 · 自托管 Runner · 持续集成 · Go 持续集成 CI Go test GitHub Actions self-hosted runner 自托管 runner340 收藏
-
124 收藏
-
Golang · Go教程 | 1天前 | HTTP · 文件下载 · Go教程 · Range请求 · ServeContent · 断点续传 Content-Range Go教程 HTTP Range ServeContent 206 Partial Content 视频拖动250 收藏
-
Golang · Go教程 | 1天前 | csv · Go教程 · 后端架构 · 流式响应 · 大文件导出 · 大文件下载 FLUSH CSV导出 Go教程 流式写出 csv.Writer rows.Next251 收藏
-
Golang · Go教程 | 1天前 | HTTP服务 · Go教程 · 后端开发 · 超时配置 · 服务稳定性 · net/http WriteTimeout HTTP超时 Go教程 ReadHeaderTimeout IdleTimeout140 收藏
-
Golang · Go教程 | 1天前 | 错误处理 · Context · 并发控制 · Go教程 · 并发控制 Go教程 context取消 context.WithCancelCause context.Cause342 收藏
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
- 立即学习 543次学习
-
- GO语言核心编程课程
- 本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
- 立即学习 516次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
- 立即学习 500次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 立即学习 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
- 立即学习 485次学习