Enum AppError 

pub enum AppError {
    BadRequest(String),
    Unauthorized(String),
    Forbidden(String),
    NotFound(String),
    Conflict(String),
    UnprocessableEntity(String),
    TooManyRequests(String),
    InternalServerError(String),
    BadGateway(String),
    ServiceUnavailable(String),
    GatewayTimeout(String),
    JsonParseError(Error),
    UrlEncodedParseError(Error),
    MultipartParseError(String),
    ValidationError(Vec<ValidationErrorDetail>),
    DatabaseError(String),
    IoError(Error),
    Timeout(String),
    ExternalServiceError {
        service: String,
        message: String,
    },
    Custom {
        status: StatusCode,
        error_code: String,
        message: String,
        details: Option<Value>,
    },
}

框架统一错误类型

所有错误都会被转换为 HTTP 响应，提供一致的错误处理体验

Variants

BadRequest(String)

400 Bad Request - 请求格式错误或参数不合法

Unauthorized(String)

401 Unauthorized - 未认证

Forbidden(String)

403 Forbidden - 已认证但无权限

NotFound(String)

404 Not Found - 资源不存在

Conflict(String)

409 Conflict - 资源冲突（如重复创建）

UnprocessableEntity(String)

422 Unprocessable Entity - 验证失败

TooManyRequests(String)

429 Too Many Requests - 请求过于频繁

InternalServerError(String)

500 Internal Server Error - 内部错误

BadGateway(String)

502 Bad Gateway - 网关错误

ServiceUnavailable(String)

503 Service Unavailable - 服务不可用

GatewayTimeout(String)

504 Gateway Timeout - 网关超时

JsonParseError(Error)

JSON 解析错误

UrlEncodedParseError(Error)

URL 编码解析错误

MultipartParseError(String)

Multipart 解析错误

ValidationError(Vec<ValidationErrorDetail>)

验证错误（包含详细字段错误）

DatabaseError(String)

数据库错误

IoError(Error)

IO 错误

Timeout(String)

超时错误

ExternalServiceError

第三方服务错误

Fields

service: String

message: String

Custom

自定义错误，允许完全控制状态码和响应内容

Fields

status: StatusCode

error_code: String

message: String

details: Option<Value>

Implementations

impl AppError

pub fn custom( status: StatusCode, error_code: impl Into<String>, message: impl Into<String>, ) -> Self

创建自定义错误

pub fn custom_with_details( status: StatusCode, error_code: impl Into<String>, message: impl Into<String>, details: Value, ) -> Self

创建带详细信息的自定义错误

pub fn status_code(&self) -> StatusCode

获取 HTTP 状态码

pub fn error_code(&self) -> String

获取错误代码

pub fn message(&self) -> String

获取错误消息

pub fn details(&self) -> Option<Value>

获取错误详细信息

Trait Implementations

impl Debug for AppError

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

Formats the value using the given formatter.

impl Display for AppError

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

Formats the value using the given formatter.

impl Error for AppError

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 From<Error> for AppError

fn from(err: Error) -> Self

Converts to this type from the input type.

impl From<Error> for AppError

fn from(err: Error) -> Self

Converts to this type from the input type.

impl From<Error> for AppError

fn from(err: Error) -> Self

Converts to this type from the input type.

impl From<Error> for AppError

fn from(err: Error) -> Self

Converts to this type from the input type.

impl From<Error> for AppError

fn from(err: Error) -> Self

Converts to this type from the input type.

impl IntoResponse for AppError

fn into_response(self) -> Response<BoxBody<Bytes, Infallible>>