Struct Error 

pub struct Error { /* private fields */ }

全局 HTTP 错误类型，贯穿整个应用。

所有字段均为私有，必须通过 Error::new 创建并经由链式 with_xxx / add_xxx 方法配置；读取使用同名 getter（Error::status、 Error::category 等）。

内部把可选字段统一装箱到 Box<ErrorData>，将 Result<_, Error> 的 Err 变体保持在 clippy::result_large_err 128 字节限制以内。

Implementations

impl Error

pub fn new(message: impl ToString) -> Self

以错误信息创建新的 Error 实例，其余字段均为默认值。 message 接受任意 Display 类型，便于直接由外部错误包装。

pub fn with_category(self, category: impl Into<String>) -> Self

设置错误分类（模块来源），支持链式调用。

pub fn with_sub_category(self, sub_category: impl Into<String>) -> Self

设置错误子分类，支持链式调用。

pub fn with_code(self, code: impl Into<String>) -> Self

设置业务错误码，支持链式调用。

pub fn with_status(self, status: u16) -> Self

设置 HTTP 状态码，支持链式调用。

pub fn with_exception(self, exception: bool) -> Self

标记是否为需要告警的异常级错误，支持链式调用。

pub fn add_extra(self, value: impl Into<String>) -> Self

追加一条附加上下文信息，支持链式调用。

pub fn status(&self) -> u16

HTTP 状态码；返回 0 表示未显式设置，响应时会回退到 500。

pub fn category(&self) -> &str

错误来源模块。

pub fn message(&self) -> &str

面向用户或日志的错误描述。

pub fn sub_category(&self) -> Option<&str>

错误子分类，未设置时返回 None。

pub fn code(&self) -> Option<&str>

业务错误码，未设置时返回 None。

pub fn is_exception(&self) -> bool

是否为需要告警的异常级错误；未显式设置时返回 false。

pub fn extra(&self) -> &[String]

附加上下文列表，未设置时返回空切片。

Trait Implementations

impl Clone for Error

fn clone(&self) -> Error

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Error

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

Formats the value using the given formatter.

impl Default for Error

fn default() -> Error

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Error

fn deserialize<D>(deserializer: D) -> Result<Self, D::Error>

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for Error

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

Formats the value using the given formatter.

impl Error for Error

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 IntoResponse for Error

将 Error 转换为带 JSON 响应体和 no-cache 头的 HTTP 响应。

fn into_response(self) -> Response

Create a response.

impl Serialize for Error

序列化为扁平 JSON 对象：{ category, message, sub_category?, … }。

fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error>

where S: Serializer,

Serialize this value into the given Serde serializer.