golang如何实现项目错误码规范_golang项目错误码规范实现指南

错误码必须分层封装为实现error接口的结构体并集中管理。应定义CodeError结构体绑定码值、消息和HTTP状态码，通过pkg/code/统一声明const码值和var错误实例，禁止硬编码；所有错误需在handler入口统一包装转换，底层异常须在DAO层转为业务错误，确保日志可排查、前端可解析、协作低成本。Go 项目里错误码不统一，会导致日志难排查、前端解析混乱、协作成本高------这不是设计问题，是没做错误码分层和封装。错误码必须和 error 绑定，不能只靠字符串或整数很多人用 fmt.Errorf("code:1001, msg:user not found") 或直接返回 1001 整数，这会让调用方无法类型断言、无法结构化提取码值，也破坏 Go 的错误处理惯性。正确做法是定义一个实现了 error 接口的结构体，内嵌码、消息、HTTP 状态码等字段：type CodeError struct {Code int `json:"code"`Message string `json:"message"`HTTPCode int `json:"http_code,omitempty"`}func (e *CodeError) Error() string {return e.Message}func (e *CodeError) WithHTTPCode(code int) *CodeError {e.HTTPCode = codereturn e}CodeError 可被 errors.As() 捕获，支持类型安全判断避免在 Error() 方法里拼接码值（如 return fmt.Sprintf("%d %s", e.Code, e.Message)），否则日志中会重复出现码值，干扰 grep 和 ELK 解析不要把 HTTPCode 默认设为 500------400 类错误（如参数校验失败）应显式设为 400，便于网关透传错误码定义必须集中管理，且不可变把错误码散落在各 handler 或 service 文件里，很快就会出现 1001 在 user 包表示"用户不存在"，在 order 包却表示"订单过期"。立即学习"go语言免费学习笔记（深入）"； Vozo Vozo是一款强大的AI视频编辑工具，可以帮助用户轻松重写、配音和编辑视频。