Enum WxPayError 

pub enum WxPayError {
    ConfigError {
        message: String,
    },
    InvalidPrivateKey(String),
    InvalidCertificate(String),
    MissingConfig {
        field: String,
    },
    SignError(String),
    SignatureVerificationFailed,
    InvalidSignatureFormat(String),
    EncryptionError(String),
    DecryptionError(String),
    InvalidKey(String),
    InvalidCiphertext(String),
    CertificateDownloadError(String),
    CertificateParseError(String),
    CertificateExpired,
    CertificateVerificationError(String),
    CertificateNotFound(String),
    NetworkError(Error),
    RequestBuildError(String),
    ResponseParseError(String),
    Timeout,
    ApiError {
        code: String,
        message: String,
    },
    UnexpectedStatusCode(u16),
    BusinessError(String),
    NotifySignatureVerificationFailed,
    NotifyDecryptionError(String),
    InvalidNotifyFormat(String),
    InvalidNotifyType(String),
    JsonError(Error),
    UrlEncodeError(String),
    UrlParseError(ParseError),
    InternalError(String),
    UnsupportedOperation(String),
    InvalidParameter(String),
}

微信支付 SDK 错误类型

Variants

ConfigError

配置错误

Fields

message: String

InvalidPrivateKey(String)

无效的私钥

InvalidCertificate(String)

无效的证书

MissingConfig

缺少必填配置项

Fields

field: String

SignError(String)

签名生成失败

SignatureVerificationFailed

签名验证失败

InvalidSignatureFormat(String)

无效的签名格式

EncryptionError(String)

加密失败

DecryptionError(String)

解密失败

InvalidKey(String)

无效的密钥

InvalidCiphertext(String)

无效的密文格式

CertificateDownloadError(String)

证书下载失败

CertificateParseError(String)

证书解析失败

CertificateExpired

证书已过期

CertificateVerificationError(String)

证书验证失败

CertificateNotFound(String)

找不到匹配的证书

NetworkError(Error)

网络错误

RequestBuildError(String)

HTTP 请求构建失败

ResponseParseError(String)

HTTP 响应解析失败

Timeout

请求超时

ApiError

微信支付 API 错误

Fields

code: String

错误码

message: String

错误信息

UnexpectedStatusCode(u16)

API 返回了意外的状态码

BusinessError(String)

业务逻辑错误

NotifySignatureVerificationFailed

通知签名验证失败

NotifyDecryptionError(String)

通知解密失败

InvalidNotifyFormat(String)

无效的通知格式

InvalidNotifyType(String)

无效的通知类型

JsonError(Error)

JSON 序列化/反序列化错误

UrlEncodeError(String)

URL 编码错误

UrlParseError(ParseError)

URL 解析错误

InternalError(String)

内部错误

UnsupportedOperation(String)

不支持的操作

InvalidParameter(String)

参数错误

Implementations

impl WxPayError

pub fn config(message: impl Into<String>) -> Self

创建配置错误

pub fn missing_config(field: impl Into<String>) -> Self

创建缺少配置项错误

pub fn sign(message: impl Into<String>) -> Self

创建签名错误

pub fn encryption(message: impl Into<String>) -> Self

创建加密错误

pub fn decryption(message: impl Into<String>) -> Self

创建解密错误

pub fn certificate_parse(message: impl Into<String>) -> Self

创建证书错误

pub fn certificate_download(message: impl Into<String>) -> Self

创建证书下载错误

pub fn certificate_verification(message: impl Into<String>) -> Self

创建证书验证错误

pub fn api(code: impl Into<String>, message: impl Into<String>) -> Self

创建 API 错误

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

创建内部错误

pub fn invalid_parameter(message: impl Into<String>) -> Self

创建参数错误

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

创建业务错误

pub fn api_kind(&self) -> Option<WxPayErrorKind>

获取 API 错误分类

pub fn api_code(&self) -> Option<&str>

获取 API 错误码

pub fn alert_level(&self) -> WxPayAlertLevel

告警级别（用于结构化日志告警策略）

pub fn alert_policy(&self) -> &'static str

告警策略键（用于指标/告警策略路由）

pub fn should_retry(&self) -> bool

是否建议重试

pub fn is_network_error(&self) -> bool

判断是否为网络错误

pub fn is_api_error(&self) -> bool

判断是否为 API 错误

pub fn is_auth_error(&self) -> bool

判断是否为鉴权相关错误

pub fn is_signature_error(&self) -> bool

判断是否为签名/验签错误

pub fn is_certificate_error(&self) -> bool

判断是否为证书错误

Trait Implementations

impl Debug for WxPayError

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

Formats the value using the given formatter.

impl Display for WxPayError

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

Formats the value using the given formatter.

impl Error for WxPayError

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<DecodeError> for WxPayError

从 base64 错误转换

fn from(err: DecodeError) -> Self

Converts to this type from the input type.

impl From<Error> for WxPayError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for WxPayError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for WxPayError

从 RSA 错误转换

fn from(err: Error) -> Self

Converts to this type from the input type.

impl From<Error> for WxPayError

从 PKCS 错误转换

fn from(err: Error) -> Self

Converts to this type from the input type.

impl From<Error> for WxPayError

从 DER 错误转换

fn from(err: Error) -> Self

Converts to this type from the input type.

impl From<ParseError> for WxPayError

fn from(source: ParseError) -> Self

Converts to this type from the input type.

impl From<ParseError> for WxPayError

从时间解析错误转换

fn from(err: ParseError) -> Self

Converts to this type from the input type.