mirror of
				https://github.com/cloudreve/cloudreve.git
				synced 2025-11-01 00:57:15 +08:00 
			
		
		
		
	
		
			
				
	
	
		
			140 lines
		
	
	
		
			3.7 KiB
		
	
	
	
		
			Go
		
	
	
	
	
	
			
		
		
	
	
			140 lines
		
	
	
		
			3.7 KiB
		
	
	
	
		
			Go
		
	
	
	
	
	
| 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
 | ||
| 	// CodeCredentialInvalid 凭证无效
 | ||
| 	CodeCredentialInvalid = 40001
 | ||
| 	// 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 = 40012
 | ||
| 	// 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
 | ||
| }
 | 
