0

0

Go错误处理如何记录日志_Go错误日志最佳实践

P粉602998670

P粉602998670

发布时间:2026-01-23 13:04:41

|

211人浏览过

|

来源于php中文网

原创

不会。log.Fatal 调用 os.Exit(1) 直接终止程序,不捕获 panic,defer 中的 recover 也因强制退出而失效;正确做法是用 log.Error 或 zap.Error 记录可恢复错误并返回,仅在不可恢复时才 os.Exit 或让 panic 冒泡。

go错误处理如何记录日志_go错误日志最佳实践

Go 中 panic 会被 log.Fatal 捕获吗

不会。log.Fatal 本身会调用 os.Exit(1),它不捕获 panic,而是直接终止程序;panic 也不会被普通 log.Print 系列函数拦截。如果你在 defer 中 recover,但又用了 log.Fatal,recover 就失效了——因为 log.Fatal 强制退出,defer 都来不及执行完。

正确做法是:遇到可恢复错误,用 log.Error(如 zap 或 logrus)或 log.Printf 记录,再显式返回错误;真正不可恢复时,才考虑 os.Exit 或让 panic 向上冒泡。

  • log.Fatal = log.Print + os.Exit(1),无 recover 机会
  • 想记录 panic 日志?必须配合 recover() + 自定义日志写入(比如写到文件或 sentry)
  • 标准库 log 不区分 error/info/warn 级别,建议换用 zapzerolog

用 zap 记录错误时要不要带 stacktrace

要看错误类型。业务校验失败(如 email format invalid)通常不需要 stacktrace;而未预期的 panic、空指针、接口断言失败等,必须带 stacktrace 才能定位。

zap 提供 zap.Stack()zap.NamedError(),后者会自动提取 error 实现的 StackTrace() 方法(如 github.com/pkg/errors 或 Go 1.17+ 的 errors.WithStack 封装)。

if err != nil {
    logger.Error("failed to process user",
        zap.String("user_id", userID),
        zap.Error(err), // 如果 err 是 pkg/errors.Wrap 封装的,会自动带 stack
        zap.String("stage", "decode"),
    )
}
  • 不要对每个错误都加 zap.Stack(),它开销大且信息冗余
  • 推荐统一用 zap.Error(err),依赖 error 类型自身是否携带 trace
  • 避免手动 fmt.Sprintf("%+v", err) 写进日志字段——会丢失结构化能力

error 包装时该用 errors.Wrap 还是 fmt.Errorf %w

优先用 fmt.Errorf("%w", err)。Go 1.13 引入的 %w 是语言原生支持,errors.Is / errors.As 能正常工作,且无额外依赖。

NameGPT名称生成器
NameGPT名称生成器

免费AI公司名称生成器,AI在线生成企业名称,注册公司名称起名大全。

下载

github.com/pkg/errorsWrap 在 Go 1.13+ 已不推荐,它返回的 error 不完全兼容标准库的 unwrap 行为(比如嵌套多层时 errors.Unwrap 可能漏掉中间层)。

// ✅ 推荐:原生语义清晰,工具链友好
err := doSomething()
if err != nil {
    return fmt.Errorf("failed to initialize config: %w", err)
}

// ❌ 不推荐:pkg/errors.Wrap 在 go 1.20+ 中与 vet 冲突,且 stacktrace 格式不统一
// return errors.Wrap(err, "failed to initialize config")
  • 所有包装必须用 %w,否则 errors.Is(err, fs.ErrNotExist) 会失败
  • 不要混用 %w%s 包装同一错误链,会导致 unwrap 中断
  • 如果要加 context 字段(如请求 ID),用独立日志字段,而不是塞进 error message 里

HTTP handler 中错误日志要不要打 full stack

不要。HTTP handler 属于边界层,错误应降级为用户可读提示(如 {"error": "invalid request"}),日志只需记录关键上下文 + 错误摘要 + trace ID,stacktrace 留给后端服务内部错误(如 DB 查询失败、RPC 超时)。

典型反模式:logger.Error("http handler panic", zap.Any("err", r)) —— 这会把整个 http.Request 结构体全打出来,含 body、headers、甚至 cookies,既慢又危险。

  • handler 中 panic 捕获后,用 zap.String("trace_id", reqID) + zap.Error(err) 即可
  • 敏感字段(如 Authorization header、password 字段)必须过滤,不能直接 log struct
  • 生产环境禁用 http.Error(w, err.Error(), http.StatusInternalServerError),应返回泛化错误码
日志不是 dump,错误也不是越详细越好。真正难的是判断哪一层该留 trace、哪一层该脱敏、哪一层该丢弃——这些决策藏在 error 的构造方式和日志写入位置里,不在工具本身。

相关专题

更多
python中print函数的用法
python中print函数的用法

python中print函数的语法是“print(value1, value2, ..., sep=' ', end=' ', file=sys.stdout, flush=False)”。本专题为大家提供print相关的文章、下载、课程内容,供大家免费下载体验。

185

2023.09.27

string转int
string转int

在编程中,我们经常会遇到需要将字符串(str)转换为整数(int)的情况。这可能是因为我们需要对字符串进行数值计算,或者需要将用户输入的字符串转换为整数进行处理。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

358

2023.08.02

format在python中的用法
format在python中的用法

Python中的format是一种字符串格式化方法,用于将变量或值插入到字符串中的占位符位置。通过format方法,我们可以动态地构建字符串,使其包含不同值。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

679

2023.07.31

python中的format是什么意思
python中的format是什么意思

python中的format是一种字符串格式化方法,用于将变量或值插入到字符串中的占位符位置。通过format方法,我们可以动态地构建字符串,使其包含不同值。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

431

2024.06.27

scripterror怎么解决
scripterror怎么解决

scripterror的解决办法有检查语法、文件路径、检查网络连接、浏览器兼容性、使用try-catch语句、使用开发者工具进行调试、更新浏览器和JavaScript库或寻求专业帮助等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

188

2023.10.18

500error怎么解决
500error怎么解决

500error的解决办法有检查服务器日志、检查代码、检查服务器配置、更新软件版本、重新启动服务、调试代码和寻求帮助等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

291

2023.10.25

printf用法大全
printf用法大全

php中文网为大家提供printf用法大全,以及其他printf函数的相关文章、相关下载资源以及各种相关课程,供大家免费下载体验。

73

2023.06.20

fprintf和printf的区别
fprintf和printf的区别

fprintf和printf的区别在于输出的目标不同,printf输出到标准输出流,而fprintf输出到指定的文件流。根据需要选择合适的函数来进行输出操作。更多关于fprintf和printf的相关文章详情请看本专题下面的文章。php中文网欢迎大家前来学习。

282

2023.11.28

C++ 高级模板编程与元编程
C++ 高级模板编程与元编程

本专题深入讲解 C++ 中的高级模板编程与元编程技术,涵盖模板特化、SFINAE、模板递归、类型萃取、编译时常量与计算、C++17 的折叠表达式与变长模板参数等。通过多个实际示例,帮助开发者掌握 如何利用 C++ 模板机制编写高效、可扩展的通用代码,并提升代码的灵活性与性能。

10

2026.01.23

热门下载

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

精品课程

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

共21课时 | 2.9万人学习

Git版本控制工具
Git版本控制工具

共8课时 | 1.5万人学习

Git中文开发手册
Git中文开发手册

共0课时 | 0人学习

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

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