Enum CoreError 

#[non_exhaustive]
pub enum CoreError {
    Network(Box<NetworkError>),
    Authentication {
        message: String,
        code: ErrorCode,
        ctx: Box<ErrorContext>,
    },
    Api(Box<ApiError>),
    Validation {
        field: Cow<'static, str>,
        message: String,
        code: ErrorCode,
        ctx: Box<ErrorContext>,
    },
    Configuration {
        message: String,
        code: ErrorCode,
        ctx: Box<ErrorContext>,
    },
    Serialization {
        message: String,
        source: Option<Box<dyn Error + Send + Sync>>,
        code: ErrorCode,
        ctx: Box<ErrorContext>,
    },
    Business {
        code: ErrorCode,
        message: String,
        ctx: Box<ErrorContext>,
    },
    Timeout {
        duration: Duration,
        operation: Option<String>,
        ctx: Box<ErrorContext>,
    },
    RateLimit {
        limit: u32,
        window: Duration,
        reset_after: Option<Duration>,
        code: ErrorCode,
        ctx: Box<ErrorContext>,
    },
    ServiceUnavailable {
        service: Cow<'static, str>,
        retry_after: Option<Duration>,
        code: ErrorCode,
        ctx: Box<ErrorContext>,
    },
    Internal {
        code: ErrorCode,
        message: String,
        source: Option<Box<dyn Error + Send + Sync>>,
        ctx: Box<ErrorContext>,
    },
}

轻量版核心错误

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Network(Box<NetworkError>)

网络错误

Authentication

认证错误

Fields

message: String

错误消息

code: ErrorCode

错误码

ctx: Box<ErrorContext>

错误上下文

Api(Box<ApiError>)

API 错误

Validation

验证错误

Fields

field: Cow<'static, str>

字段名

message: String

错误消息

code: ErrorCode

错误码

ctx: Box<ErrorContext>

错误上下文

Configuration

配置错误

Fields

message: String

错误消息

code: ErrorCode

错误码

ctx: Box<ErrorContext>

错误上下文

Serialization

序列化错误

Fields

message: String

错误消息

source: Option<Box<dyn Error + Send + Sync>>

源错误

code: ErrorCode

错误码

ctx: Box<ErrorContext>

错误上下文

Business

业务错误

Fields

code: ErrorCode

错误码

message: String

错误消息

ctx: Box<ErrorContext>

错误上下文

Timeout

超时错误

Fields

duration: Duration

超时时长

operation: Option<String>

操作名

ctx: Box<ErrorContext>

错误上下文

RateLimit

限流错误

Fields

limit: u32

限制次数

window: Duration

时间窗口

reset_after: Option<Duration>

重置时间

code: ErrorCode

错误码

ctx: Box<ErrorContext>

错误上下文

ServiceUnavailable

服务不可用错误

Fields

service: Cow<'static, str>

服务名

retry_after: Option<Duration>

重试等待时间

code: ErrorCode

错误码

ctx: Box<ErrorContext>

错误上下文

Internal

内部错误

Fields

code: ErrorCode

错误码

message: String

错误消息

source: Option<Box<dyn Error + Send + Sync>>

源错误

ctx: Box<ErrorContext>

错误上下文

Implementations

impl CoreError

pub fn builder(kind: BuilderKind) -> ErrorBuilder

统一构建器入口

pub fn network_builder() -> ErrorBuilder

网络错误构建器

pub fn api_builder() -> ErrorBuilder

API 错误构建器

pub fn validation_builder() -> ErrorBuilder

验证错误构建器

pub fn authentication_builder() -> ErrorBuilder

认证错误构建器

pub fn business_builder() -> ErrorBuilder

业务错误构建器

pub fn network_msg(message: impl Into<String>) -> CoreError

简单网络错误（无 source）

pub fn authentication(message: impl Into<String>) -> CoreError

简单认证错误

pub fn api_error( status: i32, endpoint: impl Into<String>, message: impl Into<String>, request_id: Option<impl Into<String>>, ) -> CoreError

简单 API 错误（便于兼容旧 CoreError::api_error）

pub fn validation_msg(message: impl Into<String>) -> CoreError

仅带 message 的验证错误（默认字段 general）

pub fn message(&self) -> String

用户可读 message（兼容旧 API）

pub fn kind(&self) -> ErrorType

错误类型别名（兼容旧 kind）

pub fn is_api_error(&self) -> bool

直接判断 API 错误（便捷别名）

pub fn validation( field: impl Into<String>, message: impl Into<String>, ) -> CoreError

验证错误

pub fn api_data_error(message: impl Into<String>) -> CoreError

API 数据错误

pub fn code(&self) -> ErrorCode

获取错误码

pub fn severity(&self) -> ErrorSeverity

获取错误严重程度

pub fn is_retryable(&self) -> bool

是否可重试

pub fn retry_delay(&self, attempt: u32) -> Option<Duration>

获取重试延迟

pub fn ctx(&self) -> &ErrorContext

获取错误上下文

pub fn map_context(self, f: impl FnOnce(&mut ErrorContext)) -> CoreError

修改错误上下文

pub fn with_context_kv( self, key: impl Into<String>, value: impl Into<String>, ) -> CoreError

添加上下文键值对

pub fn with_operation( self, operation: impl Into<String>, component: impl Into<String>, ) -> CoreError

添加操作和组件信息

pub fn record(&self) -> ErrorRecord

观测记录（可序列化）——供日志/指标/告警统一使用

pub fn network<E>(source: E, ctx: ErrorContext) -> CoreError

where E: Error + Send + Sync + 'static,

网络错误

pub fn api( status: u16, endpoint: impl Into<Cow<'static, str>>, message: impl Into<String>, ctx: ErrorContext, ) -> CoreError

API 错误

Trait Implementations

impl ClientErrorExt for CoreError

fn suggestion(&self) -> &'static str

获取错误建议

fn recovery_steps(&self) -> Vec<&'static str>

获取错误恢复步骤

impl Clone for CoreError

fn clone(&self) -> CoreError

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for CoreError

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl Display for CoreError

fn fmt(&self, __formatter: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl Error for CoreError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl ErrorTrait for CoreError

fn severity(&self) -> ErrorSeverity

获取错误严重程度

fn is_retryable(&self) -> bool

判断是否可重试

fn retry_delay(&self, attempt: u32) -> Option<Duration>

获取建议的重试延迟

fn user_message(&self) -> Option<&str>

获取用户友好的错误消息

fn context(&self) -> &ErrorContext

获取错误上下文信息

fn error_type(&self) -> ErrorType

判断错误类型

fn error_code(&self) -> Option<&str>

获取错误代码（如果有）

fn is_user_error(&self) -> bool

判断是否为用户错误

fn is_system_error(&self) -> bool

判断是否为系统错误

fn is_network_error(&self) -> bool

判断是否为网络错误

fn is_auth_error(&self) -> bool

判断是否为认证错误

fn is_validation_error(&self) -> bool

判断是否为验证错误

fn is_timeout_error(&self) -> bool

判断是否为超时错误

fn is_rate_limited(&self) -> bool

判断是否为限流错误

fn is_config_error(&self) -> bool

判断是否为配置错误

fn is_serialization_error(&self) -> bool

判断是否为序列化错误

fn is_business_error(&self) -> bool

判断是否为业务错误

fn is_api_error(&self) -> bool

判断是否为API错误

fn is_service_unavailable_error(&self) -> bool

判断是否为服务不可用错误

impl From<Error> for CoreError

fn from(source: Error) -> CoreError

Converts to this type from the input type.

impl From<Error> for CoreError

fn from(source: Error) -> CoreError

Converts to this type from the input type.

impl From<RegistryError> for CoreError

fn from(err: RegistryError) -> CoreError

Converts to this type from the input type.