Struct ApiError 

pub struct ApiError {
    pub code: i32,
    pub msg: String,
    pub status: u16,
    pub internal_detail: Option<String>,
}

API 错误（对外暴露的统一错误类型）

HTTP 状态码使用 u16 存储，与 Web 框架解耦。

Fields

code: i32

业务码

msg: String

对外消息（已脱敏，不泄露内部信息）

status: u16

HTTP 状态码（u16，与 axum::StatusCode 互转）

internal_detail: Option<String>

内部调试信息（仅日志记录，不返回前端）

Implementations

impl ApiError

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

创建 API 错误

• status: HTTP 状态码（如 400、401、500）
• code: 业务错误码
• msg: 对外提示消息

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

400 Bad Request：客户端请求格式或参数错误

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

401 Unauthorized：未认证或 Token 无效

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

403 Forbidden：已认证但权限不足

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

404 Not Found：资源不存在

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

405 Method Not Allowed：HTTP 方法不正确

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

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

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

422 Unprocessable Entity：请求体语义错误（如字段校验失败）

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

429 Too Many Requests：请求频率超限

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

500 Internal Server Error：服务端内部错误

前端仅看到模糊提示；完整错误需通过日志排查。

pub fn internal_masked( public_msg: impl Into<String>, detail: impl Into<String>, ) -> Self

500 Internal Server Error（带调试详情）

• public_msg: 返回前端的模糊提示
• detail: 内部日志记录的详细信息（如完整的错误栈）

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

503 Service Unavailable：服务暂时不可用

Trait Implementations

impl Debug for ApiError

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

Formats the value using the given formatter.

impl From<ApiError> for Error

fn from(e: ApiError) -> Self

Converts to this type from the input type.

impl From<Error> for ApiError

fn from(e: Error) -> Self

Converts to this type from the input type.