|
|
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
|
|
|
}
|
