Gin框架优雅处理错误与统一JSON格式输出-Golang-PHP中文网

c.error() 不会返回响应，统一错误必须靠中间件主动检查 c.errors 并调用 c.abortwithstatusjson；它仅将错误追加至 c.errors 切片并记录位置，不终止请求链路、不写响应，需配合兜底中间件统一处理。

gin框架优雅处理错误与统一json格式输出

c.Error() 不会返回响应，统一错误必须靠中间件主动检查 c.Errors 并调用 c.AbortWithStatusJSON。很多人写完 c.Error(err) 就以为前端能收到 JSON 错误，结果客户端收不到任何数据，甚至拿到空 200 —— 因为 c.Error() 只是把错误塞进上下文队列，不发 HTTP 响应，也不终止请求链路。

为什么 c.Error() 不能直接用于统一错误响应

Gin 的 c.Error() 是个信号机制，不是响应动作。它只做两件事：把错误追加到 c.Errors 切片、记录位置（Err + Func + File:Line）。它不修改响应头、不写响应体、不调用 c.Abort()。

如果你只调用 c.Error(fmt.Errorf("not found")) 而没后续处理，handler 继续执行，最后可能 c.JSON(200, ...) 正常返回，掩盖错误
gin.Recovery() 默认只捕获 panic，对 c.Error() 完全无感 —— 所以业务校验失败（如参数为空）不会被它处理
多个中间件里重复调用 c.AbortWithStatusJSON() 会导致 http: multiple response.WriteHeader calls panic

如何用中间件统一拦截所有错误出口

最可靠的方式是写一个兜底中间件，放在 router.Use() 链的末尾，在 c.Next() 后检查 c.Errors 是否非空，并集中渲染。它能覆盖三类错误：handler 主动 c.Error()、中间件抛错、panic（配合自定义 CustomRecovery）。

Wjs Uploading Video

将一个或多个视频上传至YouTube。当用户想“上传到YouTube”“发YouTube”“批量上传”“upload to YouTube”“post videos to YouTube”或发布到YouTube时使用此技能。

下载

必须放在所有其他中间件之后，否则可能被后续中间件覆盖响应
用 c.Errors.Last() 取最新错误（Gin 按顺序追加），避免被前置中间件的低优先级错误干扰
别用 err.Error() == "xxx" 字符串匹配，改用 errors.Is(err.Err, ErrNotFound) 或自定义 error 类型的 Status() 方法
敏感字段（如文件路径、SQL 片段）不能直接透出，建议封装 &AppError{Code: 1001, Msg: "用户名不能为空"}

HTTP 状态码和业务 code 必须分离但共存

网关、监控看 HTTP 状态码（400 表示客户端问题，500 表示服务端故障），前端展示和埋点依赖业务 code（1001 参数错误，4001 用户不存在）。两者语义不同，但必须在同一个 JSON 里同时存在。

响应结构至少含 code（业务码）、message（用户提示）、status（HTTP 状态码）、data（可选）
不要在 handler 里写 c.JSON(400, gin.H{"code": 1001, "msg": "..."} ) —— 这破坏了控制权集中，也容易漏掉 panic 场景
自定义 CustomRecovery 里必须用 c.AbortWithStatusJSON()，且 defer 后加 return，否则 c.Next() 继续执行会触发多次写头
日志记录要传完整 err（比如用 logger.Errorw("PANIC", "err", err)），而不是 fmt.Printf，否则堆栈丢失