package serializer import ( "errors" "github.com/gin-gonic/gin" ) // AppError 应用错误,实现了error接口 type AppError struct { Code int Msg string RawError error } // NewError 返回新的错误对象 func NewError(code int, msg string, err error) AppError { return AppError{ Code: code, Msg: msg, RawError: err, } } // NewErrorFromResponse 从 serializer.Response 构建错误 func NewErrorFromResponse(resp *Response) AppError { return AppError{ Code: resp.Code, Msg: resp.Msg, RawError: errors.New(resp.Error), } } // WithError 将应用error携带标准库中的error func (err *AppError) WithError(raw error) AppError { err.RawError = raw return *err } // Error 返回业务代码确定的可读错误信息 func (err AppError) Error() string { return err.Msg } // 三位数错误编码为复用http原本含义 // 五位数错误编码为应用自定义错误 // 五开头的五位数错误编码为服务器端错误,比如数据库操作失败 // 四开头的五位数错误编码为客户端错误,有时候是客户端代码写错了,有时候是用户操作错误 const ( // CodeNotFullySuccess 未完全成功 CodeNotFullySuccess = 203 // CodeCheckLogin 未登录 CodeCheckLogin = 401 // CodeNoPermissionErr 未授权访问 CodeNoPermissionErr = 403 // CodeNotFound 资源未找到 CodeNotFound = 404 // CodeConflict 资源冲突 CodeConflict = 409 // CodeUploadFailed 上传出错 CodeUploadFailed = 40002 // CodeCreateFolderFailed 目录创建失败 CodeCreateFolderFailed = 40003 // CodeObjectExist 对象已存在 CodeObjectExist = 40004 // CodeSignExpired 签名过期 CodeSignExpired = 40005 // CodePolicyNotAllowed 当前存储策略不允许 CodePolicyNotAllowed = 40006 // CodeGroupNotAllowed 用户组无法进行此操作 CodeGroupNotAllowed = 40007 // CodeAdminRequired 非管理用户组 CodeAdminRequired = 40008 // CodeMasterNotFound 主机节点未注册 CodeMasterNotFound = 40009 // CodeUploadSessionExpired 上传会话已过期 CodeUploadSessionExpired = 400011 // CodeInvalidChunkIndex 无效的分片序号 CodeInvalidChunkIndex = 400012 // CodeInvalidContentLength 无效的正文长度 CodeInvalidContentLength = 400013 // CodeBatchSourceSize 超出批量获取外链限制 CodeBatchSourceSize = 40014 // CodeBatchAria2Size 超出最大 Aria2 任务数量限制 CodeBatchAria2Size = 40015 // CodeParentNotExist 父目录不存在 CodeParentNotExist = 40016 // CodeUserBaned 用户不活跃 CodeUserBaned = 40017 // CodeUserNotActivated 用户不活跃 CodeUserNotActivated = 40018 // CodeFeatureNotEnabled 此功能未开启 CodeFeatureNotEnabled = 40019 // CodeCredentialInvalid 凭证无效 CodeCredentialInvalid = 40020 // CodeUserNotFound 用户不存在 CodeUserNotFound = 40021 // Code2FACodeErr 二步验证代码错误 Code2FACodeErr = 40022 // CodeLoginSessionNotExist 登录会话不存在 CodeLoginSessionNotExist = 40023 // CodeInitializeAuthn 无法初始化 WebAuthn CodeInitializeAuthn = 40024 // CodeWebAuthnCredentialError WebAuthn 凭证无效 CodeWebAuthnCredentialError = 40025 // CodeCaptchaError 验证码错误 CodeCaptchaError = 40026 // CodeCaptchaRefreshNeeded 验证码需要刷新 CodeCaptchaRefreshNeeded = 40027 // CodeFailedSendEmail 邮件发送失败 CodeFailedSendEmail = 40028 // CodeInvalidTempLink 临时链接无效 CodeInvalidTempLink = 40029 // CodeTempLinkExpired 临时链接过期 CodeTempLinkExpired = 40030 // CodeDBError 数据库操作失败 CodeDBError = 50001 // CodeEncryptError 加密失败 CodeEncryptError = 50002 // CodeIOFailed IO操作失败 CodeIOFailed = 50004 // CodeInternalSetting 内部设置参数错误 CodeInternalSetting = 50005 // CodeCacheOperation 缓存操作失败 CodeCacheOperation = 50006 // CodeCallbackError 回调失败 CodeCallbackError = 50007 //CodeParamErr 各种奇奇怪怪的参数错误 CodeParamErr = 40001 // CodeNotSet 未定错误,后续尝试从error中获取 CodeNotSet = -1 ) // DBErr 数据库操作失败 func DBErr(msg string, err error) Response { if msg == "" { msg = "数据库操作失败" } return Err(CodeDBError, msg, err) } // ParamErr 各种参数错误 func ParamErr(msg string, err error) Response { if msg == "" { msg = "参数错误" } return Err(CodeParamErr, msg, err) } // Err 通用错误处理 func Err(errCode int, msg string, err error) Response { // 底层错误是AppError,则尝试从AppError中获取详细信息 if appError, ok := err.(AppError); ok { errCode = appError.Code err = appError.RawError msg = appError.Msg } res := Response{ Code: errCode, Msg: msg, } // 生产环境隐藏底层报错 if err != nil && gin.Mode() != gin.ReleaseMode { res.Error = err.Error() } return res }