Files
tyapi-server/internal/infrastructure/external/nuoer/nuoer_errors.go
2026-05-28 10:55:28 +08:00

142 lines
3.8 KiB
Go
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

package nuoer
import (
"errors"
"fmt"
)
// 平台层 code 返回码见文档2
const (
CodeSuccess = 0 // 成功
CodeResponseError = -1 // 响应异常
)
// 业务层 busiCode 返回码见文档2
const (
BusiCodeSuccess = 10 // 查询成功【计费】
BusiCodeNotFound = 1000 // 数据未查得
BusiCodeInsufficientFund = 1001 // 账户余额不足
BusiCodeAccountNotFound = 1002 // 账户信息不存在
BusiCodeAppIDError = 1003 // appId异常
BusiCodeProductError = 1004 // 产品编号异常
BusiCodeAccountError = 1005 // 账号信息异常
BusiCodeOverdraftLimit = 1006 // 透支余额已达上限
BusiCodeDataRequestError = 1007 // 数据请求异常
BusiCodeServiceNotOpen = 1009 // 服务尚未开通
)
var (
ErrDatasource = errors.New("数据源异常")
ErrSystem = errors.New("系统异常")
ErrNotFound = errors.New("查询为空")
)
// platformCodeDesc 平台层 code -> 描述
var platformCodeDesc = map[int]string{
CodeSuccess: "成功",
CodeResponseError: "响应异常",
}
// busiCodeDesc 业务层 busiCode -> 描述
var busiCodeDesc = map[int]string{
BusiCodeSuccess: "查询成功【计费】",
BusiCodeNotFound: "数据未查得",
BusiCodeInsufficientFund: "账户余额不足",
BusiCodeAccountNotFound: "账户信息不存在",
BusiCodeAppIDError: "appId异常",
BusiCodeProductError: "产品编号异常",
BusiCodeAccountError: "账号信息异常",
BusiCodeOverdraftLimit: "透支余额已达上限",
BusiCodeDataRequestError: "数据请求异常",
BusiCodeServiceNotOpen: "服务尚未开通",
}
// GetPlatformCodeDesc 根据平台 code 获取描述
func GetPlatformCodeDesc(code int) string {
if desc, ok := platformCodeDesc[code]; ok {
return desc
}
return ""
}
// GetBusiCodeDesc 根据 busiCode 获取描述
func GetBusiCodeDesc(busiCode int) string {
if desc, ok := busiCodeDesc[busiCode]; ok {
return desc
}
return ""
}
// nuoerError 诺尔智汇平台层错误(响应 code 字段)
type nuoerError struct {
Code int
Message string
}
func (e *nuoerError) Error() string {
return fmt.Sprintf("诺尔智汇返回错误code: %dmsg: %s", e.Code, e.Message)
}
// NewNuoerError 创建平台层错误
func NewNuoerError(code int, message string) *nuoerError {
if message == "" {
if desc := GetPlatformCodeDesc(code); desc != "" {
message = desc
} else {
message = "诺尔智汇返回未知错误"
}
}
return &nuoerError{Code: code, Message: message}
}
// nuoerBusiError 诺尔智汇业务层错误data.busiCode 字段)
type nuoerBusiError struct {
BusiCode int
BusiMsg string
}
func (e *nuoerBusiError) Error() string {
return fmt.Sprintf("诺尔智汇业务错误busiCode: %dbusiMsg: %s", e.BusiCode, e.BusiMsg)
}
// NewNuoerBusiError 创建业务层错误
func NewNuoerBusiError(busiCode int, busiMsg string) *nuoerBusiError {
if busiMsg == "" {
if desc := GetBusiCodeDesc(busiCode); desc != "" {
busiMsg = desc
} else {
busiMsg = "诺尔智汇业务返回未知错误"
}
}
return &nuoerBusiError{BusiCode: busiCode, BusiMsg: busiMsg}
}
// GetNotFoundErrByBusiCode 将 busiCode 映射为「查询为空」类错误(不扣费场景)
func GetNotFoundErrByBusiCode(busiCode int) error {
switch busiCode {
case BusiCodeNotFound:
return ErrNotFound
default:
return nil
}
}
// GetErrByBusiCode 将 busiCode 映射为内部哨兵错误,供处理器 errors.Is 判断
func GetErrByBusiCode(busiCode int) error {
if busiCode == BusiCodeSuccess {
return nil
}
if notFound := GetNotFoundErrByBusiCode(busiCode); notFound != nil {
return notFound
}
return ErrDatasource
}
// GetErrByPlatformCode 将平台 code 映射为内部哨兵错误
func GetErrByPlatformCode(code int) error {
if code == CodeSuccess {
return nil
}
return ErrDatasource
}