Enum AppError 

pub enum AppError {
    Business {
        code: i32,
        msg: String,
    },
    LoginExpired {
        msg: String,
    },
    DownloadUnAuth {
        msg: String,
    },
    DownloadFailed {
        msg: String,
    },
    Oss {
        code: Option<i32>,
        msg: String,
    },
    Database(String),
    Internal(String),
}

应用层统一错误类型

封装所有业务异常，通过 [IntoResponse] 自动转换为 HTTP 响应。

错误变体

变体	HTTP 状态	响应格式	说明
Business	200	JSON {code, msg}	业务逻辑错误
LoginExpired	200	JSON {code:401, msg}	Token 过期或未登录
DownloadUnAuth	403	纯文本	下载权限不足
DownloadFailed	500	纯文本	文件不存在或下载失败
Oss	200	JSON	OSS 对象存储异常
Database	200	JSON	数据库查询/写入失败
Internal	200	JSON	内部未知错误

Panics

本类型不 panic。所有变体均通过 [IntoResponse] 优雅降级：

• Database / Internal 会将完整错误栈输出到 tracing::error! 日志
• Download* 返回纯文本以避免浏览器 blob 下载保存 JSON
• JSON 序列化失败时有 fallback 硬编码 JSON 字符串

从 sqlx::Error 转换

// Repository 层可直接使用 ? 传播数据库错误
let row = sqlx::query("SELECT ...").fetch_one(&pool).await?;
// sqlx::Error 自动转为 AppError::Database

Variants

Business

业务异常（带码）

Fields

code: i32

msg: String

LoginExpired

登录过期

Fields

msg: String

DownloadUnAuth

下载无权限（返回纯文本 403）

Fields

msg: String

DownloadFailed

下载失败（文件不存在等，返回纯文本 500，避免 blob 客户端保存 JSON）

Fields

msg: String

Oss

OSS 异常

Fields

code: Option<i32>

msg: String

Database(String)

数据库错误

Internal(String)

内部错误

Implementations

impl AppError

pub fn business(msg: impl Into<String>) -> Self

构造通用业务错误（错误码 500）。

返回值

返回 AppError::Business 变体，code=500。

pub fn business_code(code: i32, msg: impl Into<String>) -> Self

构造指定错误码的业务错误。

参数

• code: 业务错误码，参见 ErrorCode 常量
• msg: 错误描述

返回值

返回 AppError::Business 变体。

pub fn unique(field: &str) -> Self

构造唯一约束冲突错误（错误码 1002）。

消息格式："不允许重复的{field}喵!"

返回值

返回 AppError::Business 变体，code=1002。

pub fn login_expired(msg: impl Into<String>) -> Self

构造登录过期错误（错误码 401）。

返回值

返回 AppError::LoginExpired 变体，HTTP 响应 {"code":401,"msg":"..."}。

pub fn download_unauth(msg: impl Into<String>) -> Self

构造下载无权限错误（HTTP 403 纯文本）。

返回纯文本而非 JSON，避免浏览器 blob 下载保存错误 JSON。

返回值

返回 AppError::DownloadUnAuth 变体。

pub fn download_failed(msg: impl Into<String>) -> Self

构造下载失败错误（HTTP 500 纯文本）。

当 legacy 下载和 OSS 下载均不可用时调用。 返回纯文本以避免浏览器 blob 下载保存 JSON。

返回值

返回 AppError::DownloadFailed 变体。

Trait Implementations

impl Clone for AppError

fn clone(&self) -> AppError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AppError

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

Formats the value using the given formatter.

impl From<Error> for AppError

自动将 sqlx::Error 转换为 AppError::Database。

允许 Repository 层直接使用 ? 传播数据库错误：

let row = sqlx::query("SELECT ...").fetch_one(&pool).await?;

fn from(e: Error) -> Self

Converts to this type from the input type.

impl IntoResponse for AppError

将 AppError 转为 HTTP 响应。

转换规则

变体	Content-Type	HTTP 状态
Business / LoginExpired / Oss	application/json;charset=UTF-8	200
DownloadUnAuth	text/plain	403
DownloadFailed	text/plain	500
Database / Internal	application/json;charset=UTF-8	200

Errors

JSON 序列化失败时有硬编码 fallback，不会 panic。

fn into_response(self) -> Response

Create a response.