Enum Error 

pub enum Error {
    InvalidKeyLength {
        label: &'static str,
        expected: usize,
        got: usize,
    },
    InvalidPrefix {
        label: &'static str,
    },
    TooShort {
        label: &'static str,
    },
    MacVerificationFailed {
        label: &'static str,
    },
    DecryptionFailed {
        label: &'static str,
    },
    EncryptionFailed {
        label: &'static str,
    },
    SignFailed {
        label: &'static str,
    },
    VerificationFailed {
        label: &'static str,
    },
    UnknownIdentifier {
        kind: &'static str,
        identifier: String,
    },
    InvalidMasterKey {
        got: usize,
    },
    InvalidKey {
        label: &'static str,
    },
    InvalidIterations,
    InvalidKdfParams {
        label: &'static str,
    },
    InvalidOutputLength {
        requested: usize,
        max: usize,
    },
    InvalidHex,
    UnsupportedNationalAlgorithm {
        name: &'static str,
        hint: &'static str,
    },
    MissingConfig {
        key: &'static str,
    },
}

库统一错误。

Variants

InvalidKeyLength

长度不符合算法要求（密钥、盐、密文等；单位由调用点语境决定，如字节或位）。

Fields

label: &'static str

expected: usize

got: usize

InvalidPrefix

密文前缀不是本算法 / 本格式版本的标识。

Fields

label: &'static str

TooShort

密文长度不足（缺少 IV / MAC / tag）。

Fields

label: &'static str

MacVerificationFailed

encrypt-then-MAC 的 MAC 校验失败：密钥不对或密文被改，没有第三种解释。

Fields

label: &'static str

DecryptionFailed

认证加密（GCM / XChaCha20-Poly1305）解密失败：密钥不对或密文被改。

Fields

label: &'static str

EncryptionFailed

加密失败（一般不应发生）。

Fields

label: &'static str

SignFailed

签名失败（一般不应发生）。

Fields

label: &'static str

VerificationFailed

验签失败：签名不对或消息被改，没有第三种解释。

Fields

label: &'static str

UnknownIdentifier

标识未注册到注册表。

Fields

kind: &'static str

identifier: String

InvalidMasterKey

主密钥必须是 32 字节。

Fields

got: usize

InvalidKey

密钥材质非法（十六进制、长度或曲线点校验失败）。

Fields

label: &'static str

InvalidIterations

PBKDF2 迭代次数必须为正。

InvalidKdfParams

KDF 的成本参数非法（如 Argon2 的 m / t / p、scrypt 的 log_n / r / p）。

Fields

label: &'static str

InvalidOutputLength

请求的输出长度非法（为 0 或超过算法上限）。

Fields

requested: usize

max: usize

InvalidHex

十六进制字符串非法（奇数长度或含非十六进制字符）。

UnsupportedNationalAlgorithm

国密算法（SM1 / SM7 / SM9）本库不提供实现。

Fields

name: &'static str

hint: &'static str

MissingConfig

必需配置缺失（如环境变量未设置）。

Fields

key: &'static str

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 Display for Error

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

Formats the value using the given formatter.

impl Eq for Error

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 PartialEq for Error

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for Error