GO错误处理【3】返回err与日志的结合

我需要在每处返回err的地方加上日志吗?

日志需要在哪个地方使用,与err如何配套使用

我现在的目录结构是pkg与 internal

pkg下面有config\infra\utils

internal 下面有cron\handler\middleware\logic\repo\model
各地方都有可能报错,日志是不是也要加在报错返回之前?日志如何使用

针对"日志谁来打"的问题,有一个最清晰的判定准则:谁负责"终结"这个错误,谁就负责打日志。

1. 为什么 repomodel 绝对不打日志?

repo(数据库操作)层,它只负责执行 SQL。如果执行失败了,它并不知道这个失败对业务意味着什么。

  • 做法:直接 return fmt.Errorf("repo: 查询用户信息失败: %w", err)
  • 理由:如果你在 repo 打印了日志,而上层 logic 发现这个错误其实可以通过读缓存补偿,从而忽略了错误,那你的日志里就会多出一条"虚假报警"。

2. 谁该打日志?(终结者们)

A. Middleware(中间件)------ 必打!

它是所有请求的最后一道防线。

  • 职责:记录所有的 HTTP 访问日志,以及 Recovery 捕获到的程序崩溃。
  • 逻辑:它拿到了最终的结果,所以它记录的是"全局视角"。

B. Cron(定时任务)------ 必打!

定时任务没有前端页面,也没有 Response。

  • 职责:如果 logic 报错返回给 cron 了,cron 就是这个错误的终结者。
  • 逻辑:它必须把错误记下来,否则没人知道后台任务失败了。

C. Handler(控制器)------ 选打(视情况而定)

  • 职责:如果一个错误 logic 处理不了,传到了 handlerhandler 准备给前端回一个 ApiError
  • 建议:如果你已经在 middleware 里记录了所有带错误信息的访问日志,那么 handler 其实可以不打,省得重复。但如果是特殊的业务警告,可以在这里打。

D. Logic(业务逻辑)------ 关键逻辑打

  • 职责:这里是处理业务的地方。
  • 场景:比如"用户支付失败",这种事关金钱的重大业务异常,即使你还没把错误返回给上层,也建议在这里打一条结构化日志,方便以后对账。

3. "报错即链条"示意图

想象一个请求的传递:

  1. Repo: 发现连接断了,return %w
  2. Logic: 收到报错,由于是关键业务,infra.Log("pay").Error("支付中断", "err", err),然后继续 return %w
  3. Handler: 收到报错,调用 res.ApiError(w, 500, ...) 返回给前端。
  4. Middleware: 最后的 Access Log 记录下:method=POST status=500 err="logic: pay fail: repo: conn broken"

结果:你的日志文件里,一条是详细的业务告警,一条是总体的 HTTP 记录。没有废话,全是干货。

相关推荐
Patrick在香港1 天前
模型路由器实测:12 个任务省 77%,旗舰过载时的降级要打出显式标记
python·llm·智能路由器·api·架构设计·成本优化
明月_清风1 天前
从二叉树到 B+ 树:一文搞懂工程中「树」的演化之道
数据结构·算法·go
江湖十年1 天前
在 Go 中使用 dyno 包处理动态对象
后端·面试·go
a187927218311 天前
【算法】回溯算法(三):三记重锤与 N 皇后——记忆化、状态设计与三层漏斗
算法·leetcode·go·剪枝·回溯·n皇后·算法讲解
纪卓志George1 天前
打破语言范式:在 Go 里用动态代理实现 AOP
架构·go
刘广睿1 天前
多素材对比同步播放怎么设计?对齐播放与差异高亮的功能复盘
音视频·效率工具·架构设计·桌面客户端·素材管理
长脖鹿Johnny1 天前
游戏输入系统框架设计(三):网络输入权威与可验证性
网络·游戏·游戏开发·架构设计·输入系统·网络同步
码艺-Alimjan1 天前
维吾尔语数字转文本
java·javascript·python·算法·go
名字还没想好☜1 天前
Go 时间格式化为什么用 2006-01-02:time.Format/Parse 的参考时间、时区与解析踩坑
开发语言·后端·golang·go
我的div丢了肿么办2 天前
go语言中的map,map定义不同的数据类型,循环map,map的无序性
后端·go