errors

package
v1.0.9 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Jan 18, 2026 License: MIT Imports: 5 Imported by: 0

Documentation

Index

Constants

This section is empty.

Variables

View Source
var (
	ErrNil                   = NewWithCode(codes.Unknown, "nil")
	ErrInvalidArgument       = NewWithCode(codes.InvalidArgument, "invalid argument")
	ErrInvalidPointer        = NewWithCode(codes.InvalidPointer, "invalid pointer")
	ErrInvalidFormat         = NewWithCode(codes.InvalidFormat, "invalid format")
	ErrIllegalRequest        = NewWithCode(codes.IllegalRequest, "illegal request")
	ErrIllegalOperation      = NewWithCode(codes.IllegalInvoke, "illegal operation")
	ErrDeadlineExceeded      = NewWithCode(codes.DeadlineExceeded, "deadline exceeded")
	ErrUnknownError          = NewWithCode(codes.Unknown, "unknown error")
	ErrNoOperationPermission = NewWithCode(codes.PermissionDenied, "no operation permission")
)

通用错误

View Source
var (
	ErrInvalidReader       = NewWithCode(codes.InvalidReader, "invalid reader")
	ErrConnectionOpened    = NewWithCode(codes.ConnectionOpened, "connection is opened")
	ErrConnectionHanged    = NewWithCode(codes.ConnectionHanged, "connection is hanged")
	ErrConnectionClosed    = NewWithCode(codes.ConnectionClosed, "connection is closed")
	ErrConnectionNotOpened = NewWithCode(codes.ConnectionNotOpened, "connection is not opened")
	ErrConnectionNotHanged = NewWithCode(codes.ConnectionNotHanged, "connection is not hanged")
	ErrTooManyConnection   = NewWithCode(codes.TooManyConnections, "too many connection")
	ErrUnexpectedEOF       = NewWithCode(codes.UnexpectedEOF, "unexpected EOF")
)

网络/连接错误

View Source
var (
	ErrInvalidGID           = NewWithCode(codes.InvalidGateID, "invalid gate id")
	ErrInvalidNID           = NewWithCode(codes.InvalidNodeID, "invalid node id")
	ErrNotFoundSession      = NewWithCode(codes.SessionNotFound, "not found session")
	ErrInvalidSessionKind   = NewWithCode(codes.InvalidSessionKind, "invalid session kind")
	ErrNotFoundUserLocation = NewWithCode(codes.UserLocationNotFound, "not found user's location")
	ErrActorExists          = NewWithCode(codes.ActorExists, "actor exists")
	ErrNotFoundActor        = NewWithCode(codes.ActorNotFound, "not found actor")
	ErrNotBindActor         = NewWithCode(codes.ActorNotBound, "not bind actor")
)

会话/用户错误

View Source
var (
	ErrInvalidMessage     = NewWithCode(codes.InvalidMessage, "invalid message")
	ErrReceiveTargetEmpty = NewWithCode(codes.TargetEmpty, "the receive target is empty")
	ErrNotFoundRoute      = NewWithCode(codes.RouteNotFound, "not found route")
	ErrNotFoundEvent      = NewWithCode(codes.EventNotFound, "not found event")
	ErrSeqOverflow        = NewWithCode(codes.SeqOverflow, "seq overflow")
	ErrRouteOverflow      = NewWithCode(codes.RouteOverflow, "route overflow")
	ErrMessageTooLarge    = NewWithCode(codes.MessageTooLarge, "message too large")
	ErrInvalidDecoder     = NewWithCode(codes.InvalidDecoder, "invalid decoder")
	ErrInvalidScanner     = NewWithCode(codes.InvalidScanner, "invalid scanner")
	ErrUnregisterRoute    = NewWithCode(codes.RouteUnregistered, "unregistered route")
)

路由/消息错误

View Source
var (
	ErrInvalidConfigContent    = NewWithCode(codes.InvalidConfig, "invalid config content")
	ErrNotFoundConfigSource    = NewWithCode(codes.ConfigSourceNotFound, "not found config source")
	ErrMissingTransporter      = NewWithCode(codes.MissingTransporter, "missing transporter")
	ErrMissingDiscovery        = NewWithCode(codes.MissingDiscovery, "missing discovery")
	ErrNotFoundLocator         = NewWithCode(codes.MissingLocator, "not found locator")
	ErrMissingResolver         = NewWithCode(codes.MissingResolver, "missing resolver")
	ErrMissingDispatchStrategy = NewWithCode(codes.MissingDispatchStrategy, "missing dispatch strategy")
	ErrMissingCacheInstance    = NewWithCode(codes.MissingCacheInstance, "missing cache instance")
	ErrMissingEventbusInstance = NewWithCode(codes.MissingEventbusInstance, "missing eventbus instance")
	ErrClientShut              = NewWithCode(codes.ClientShut, "client is shut")
	ErrClientClosed            = NewWithCode(codes.ClientShut, "client is closed")
	ErrServerClosed            = NewWithCode(codes.ServerClosed, "server is closed")
	ErrSyncerClosed            = NewWithCode(codes.SyncerClosed, "syncer is closed")
)

配置/初始化错误

View Source
var (
	ErrNotFoundEndpoint        = NewWithCode(codes.EndpointNotFound, "not found endpoint")
	ErrNotFoundServiceAddress  = NewWithCode(codes.ServiceAddressNotFound, "not found service address")
	ErrServiceRegisterFailed   = NewWithCode(codes.ServiceRegisterFailed, "service register failed")
	ErrServiceDeregisterFailed = NewWithCode(codes.ServiceDeregisterFailed, "service deregister failed")
	ErrInvalidServiceDesc      = NewWithCode(codes.InvalidServiceDesc, "invalid service desc")
	ErrNotFoundIPAddress       = NewWithCode(codes.ServiceAddressNotFound, "not found ip address")
)

服务/集群错误

View Source
var (
	ErrInvalidPublicKey  = NewWithCode(codes.InvalidPublicKey, "invalid public key")
	ErrInvalidPrivateKey = NewWithCode(codes.InvalidPrivateKey, "invalid private key")
	ErrInvalidSignature  = NewWithCode(codes.InvalidSignature, "invalid signature")
	ErrInvalidCertFile   = NewWithCode(codes.InvalidCertFile, "invalid cert file")
	ErrInvalidKeyFormat  = NewWithCode(codes.InvalidKeyFormat, "invalid key format")
	ErrBlockSizeTooLarge = NewWithCode(codes.BlockSizeTooLarge, "block size too large for RSA key")
)

安全/加密错误

View Source
var (
	ErrCodecNotRegistered     = NewWithCode(codes.CodecNotRegistered, "codec not registered")
	ErrSignerNotRegistered    = NewWithCode(codes.SignerNotRegistered, "signer not registered")
	ErrEncryptorNotRegistered = NewWithCode(codes.EncryptorNotRegistered, "encryptor not registered")
	ErrProtoMarshalError      = NewWithCode(codes.ProtoMarshalError, "proto marshal error")
	ErrProtoUnmarshalError    = NewWithCode(codes.ProtoUnmarshalError, "proto unmarshal error")
)

编码/序列化错误

Functions

func As

func As(err error, target any) bool

As Wrapping for errors.As standard library

func Cause

func Cause(err error) error

Cause 返回根因错误

func Code

func Code(err error) *codes.Code

Code 返回错误码

func Is

func Is(err, target error) bool

Is Wrapping for errors.Is standard library

func IsCode added in v1.0.9

func IsCode(err error, code *codes.Code) bool

IsCode 判断错误是否是指定错误码

func IsConfigError added in v1.0.9

func IsConfigError(err error) bool

IsConfigError 判断是否是配置错误

func IsEncodingError added in v1.0.9

func IsEncodingError(err error) bool

IsEncodingError 判断是否是编码错误

func IsErr added in v1.0.9

func IsErr(err, target error) bool

IsErr 判断错误是否是指定错误(支持链式错误和错误码比较)

func IsNetworkError added in v1.0.9

func IsNetworkError(err error) bool

IsNetworkError 判断是否是网络错误

func IsRouteError added in v1.0.9

func IsRouteError(err error) bool

IsRouteError 判断是否是路由错误

func IsSecurityError added in v1.0.9

func IsSecurityError(err error) bool

IsSecurityError 判断是否是安全错误

func IsServiceError added in v1.0.9

func IsServiceError(err error) bool

IsServiceError 判断是否是服务错误

func IsSessionError added in v1.0.9

func IsSessionError(err error) bool

IsSessionError 判断是否是会话错误

func New

func New(text string) error

New Wrapping for errors.New standard library

func Next

func Next(err error) error

Next 返回下一个错误

func Replace

func Replace(err error, text string, condition ...codes.Code) error

Replace 替换文本

func Stack

func Stack(err error) *stack.Stack

Stack 返回堆栈

func Unwrap

func Unwrap(err error) error

Unwrap Wrapping for errors.Unwrap standard library

func UnwrapError added in v1.0.9

func UnwrapError(err error) error

UnwrapError 解包错误(返回下一层错误)

Types

type Error

type Error struct {
	// contains filtered or unexported fields
}

func NewError

func NewError(args ...any) *Error

NewError 新建一个错误 可传入以下参数: text : 文本字符串 code : 错误码 error: 原生错误

func NewErrorWithStack

func NewErrorWithStack(args ...any) *Error

NewErrorWithStack 新建一个带堆栈的错误 可传入以下参数: text : 文本字符串 code : 错误码 error: 原生错误

func NewSimple added in v1.0.9

func NewSimple(text string) *Error

NewSimple 新建一个简单错误

func NewWithCode added in v1.0.9

func NewWithCode(code *codes.Code, text string) *Error

NewWithCode 新建一个带错误码的错误

func Wrap added in v1.0.9

func Wrap(err error, message string) *Error

Wrap 包装一个错误,添加上下文信息

func WrapWithCode added in v1.0.9

func WrapWithCode(err error, code *codes.Code, message string) *Error

WrapWithCode 包装一个错误,添加错误码和上下文信息

func (*Error) Cause

func (e *Error) Cause() error

Cause 返回根因错误

func (*Error) Code

func (e *Error) Code() *codes.Code

Code 返回错误码

func (*Error) Error

func (e *Error) Error() (text string)

func (*Error) Format

func (e *Error) Format(s fmt.State, verb rune)

Format 格式化输出 %s : 打印本级错误信息 %v : 打印所有错误信息 %+v: 打印所有错误信息和堆栈信息

func (*Error) Next

func (e *Error) Next() error

Next 返回下一个错误

func (*Error) Replace

func (e *Error) Replace(text string, condition ...*codes.Code) error

Replace 替换文本

func (*Error) Stack

func (e *Error) Stack() *stack.Stack

Stack 返回堆栈

func (*Error) String

func (e *Error) String() string

String 格式化错误信息

func (*Error) Unwrap

func (e *Error) Unwrap() error

Unwrap 解包错误

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL