如何在Golang中处理HTTP请求错误_捕获并返回接口错误信息-Golang-PHP中文网

如何在Golang中处理HTTP请求错误_捕获并返回接口错误信息

P粉602998670

发布： 2025-12-17 18:02:02

原创

496人浏览过

应主动构造结构化错误响应：用 JSON 格式返回统一格式如{"code":400,"message":"invalid user id","data":null}，按错误类型设对应状态码（400/404/500），封装 AppError 类型并用中间件处理，严禁泄露敏感信息。

如何在golang中处理http请求错误_捕获并返回接口错误信息

在 Go 的 HTTP 处理函数中，遇到错误时不要 panic 或静默忽略，而应主动构造响应，把错误原因以结构化方式返回。推荐使用 JSON 格式，状态码匹配语义（如 400 表示参数错误，500 表示服务内部异常）：

不是所有错误都该返回 500。需识别错误来源，选择合适的状态码和提示：

客户端错误（如 JSON 解析失败、必填字段缺失、ID 格式错误）→ 返回 400，并给出可读提示，不暴露内部细节
资源未找到（如数据库查不到用户）→ 返回 404，避免泄露是否存在该资源的逻辑（如用 404 而非 400 区分“ID 格式错”和“ID 存在但无数据”）
服务端错误（如 DB 连接失败、第三方 API 超时）→ 返回 500，日志记录完整错误栈，响应体只返回通用提示（如 "service unavailable"）

原生 error 接口信息有限。可定义带状态码、业务码、消息的错误类型，便于中间件统一处理：

图酷AI

下载即用！可以免费使用的AI图像处理工具，致力于为用户提供最先进的AI图像处理技术，让图像编辑变得简单高效。

106

定义结构体如 AppError，含 Code（HTTP 状态码）、BizCode（业务码如 "USER_NOT_FOUND"）、Msg 字段
在 handler 中主动 wrap 错误：return &AppError{Code: http.StatusNotFound, BizCode: "USER_001", Msg: "user not exist"}
配合中间件，在 writeHeader 前拦截 *AppError，自动设置状态码并序列化响应