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

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

只影响告警，不影响响应体是否脱敏——脱敏见 Self::with_redact。

pub fn with_redact(self, redact: bool) -> Self

显式控制是否对客户端隐去 message 与 extra，支持链式调用。

不调用本方法时按状态码判定：5xx 隐去、4xx 保留。

之所以要与 Self::with_exception 分开：两者是独立的轴。exception 的语义是「需要告警」，不等于「含内部细节」。此前二者被合并判定， 一个 400 + exception 的错误会回 400 {"message":"internal server error"}, 状态码与文案自相矛盾，前端无从处理。

需要覆盖默认时才用它，两个方向都支持：

• with_redact(true)：4xx 但 message 含内部细节（如策略引擎的内部规则）
• with_redact(false)：5xx 但 message 是可安全外露的固定文案

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 redact(&self) -> Option<bool>

是否已显式设置脱敏；None 表示按状态码默认判定（见 Self::with_redact）。

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

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

pub fn from_upstream(status: u16, body: &[u8]) -> Self

由上游服务的 HTTP 错误响应重建 Error。

上游若是同样用本类型的 tibba 服务，category / sub_category / code / extra 会被原样保留；否则退化为「把响应体当纯文本作 message」。

为什么 status 从参数来而不是从响应体解析

状态码本来就在 HTTP 状态行上，把它再塞进 JSON body 是冗余——也正因如此 Error 的序列化形式里没有它，单纯 serde_json::from_slice 得到的 Error 状态码是 0（落到 IntoResponse 会变成 500）。这个构造函数就是那块拼图： 由调用方把状态行上的值传进来，结构化字段从 body 来。

注意：这是上游的状态码

返回的 Error 带的是上游给的状态码，不代表本服务该回什么。直接透传给 自己的客户端通常是错的（上游 401 不等于调用方未登录）。调用方应显式 决定对外状态码，见 tibba-request 的 handle_fail 如何映射成 502。

响应体不是本类型的 JSON 时，message 取响应体文本并截断到 MAX_UPSTREAM_MESSAGE_LEN 字节——上游回一整页 HTML 错误页是常事， 整页塞进 message 只会把日志冲垮。

Trait Implementations

impl Clone for Error

fn clone(&self) -> Self

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() -> Self

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.