vtx_sdk/
error.rs

1use serde::{Deserialize, Serialize};
2use std::fmt;
3
4/// 插件运行时错误类型（统一错误模型）
5///
6/// 定义插件在运行过程中可能出现的所有已知错误。
7/// 所有错误均支持序列化，可用于 HTTP 返回或日志透传。
8#[derive(Debug, Clone, Serialize, Deserialize)]
9pub enum VtxError {
10    /// 底层数据库错误（如 SQL 执行失败、约束冲突等）
11    DatabaseError(String),
12
13    /// 序列化或反序列化失败（如 JSON 格式不匹配）
14    SerializationError(String),
15
16    /// 身份验证失败（带建议返回的 HTTP 状态码，如 401 / 403）
17    AuthDenied(u16),
18
19    /// 权限不足（如在只读环境尝试执行写操作）
20    PermissionDenied(String),
21
22    /// 资源不存在（如文件、视频、用户未找到等）
23    NotFound(String),
24
25    /// 插件内部逻辑错误（兜底类型）
26    Internal(String),
27}
28
29impl fmt::Display for VtxError {
30    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
31        match self {
32            VtxError::DatabaseError(msg) => write!(f, "Database error: {}", msg),
33            VtxError::SerializationError(msg) => write!(f, "Data serialization error: {}", msg),
34            VtxError::AuthDenied(code) => write!(f, "Authentication denied (Code: {})", code),
35            VtxError::PermissionDenied(msg) => write!(f, "Permission denied: {}", msg),
36            VtxError::NotFound(msg) => write!(f, "Resource not found: {}", msg),
37            VtxError::Internal(msg) => write!(f, "Internal error: {}", msg),
38        }
39    }
40}
41
42impl std::error::Error for VtxError {}
43
44/// 插件标准结果类型别名
45///
46/// 推荐用于所有返回 VtxError 的接口中，确保错误链统一。
47pub type VtxResult<T> = Result<T, VtxError>;
vtx_sdk/error.rs

vtx_sdk/
error.rs
