Enum OutboxError 

#[non_exhaustive]
pub enum OutboxError {
    Serialization(Error),
    Database(Box<dyn Error + Send + Sync>),
    MissingHandler {
        event_type: String,
    },
    MaxRetries {
        event_id: Uuid,
        attempts: u32,
    },
    TypeMismatch {
        expected: &'static str,
        actual: String,
    },
    Internal(String),
}

Errors raised by the outbox primitives, publishers and workers.

Marked #[non_exhaustive] so new variants can be added without a breaking change.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Serialization(Error)

The event payload could not be serialized or deserialized as JSON.

Database(Box<dyn Error + Send + Sync>)

The backend reported a database-level failure.

The original error is preserved as a boxed source so callers can downcast if they need typed access to the underlying driver error.

MissingHandler

The worker polled an envelope whose event_type has no registered handler.

Fields

event_type: String

The unrouted event type read from the envelope.

MaxRetries

The envelope was retried more times than the configured maximum.

Fields

event_id: Uuid

Identifier of the event that exhausted its retry budget.

attempts: u32

Number of attempts already consumed.

TypeMismatch

An envelope was decoded into the wrong event type.

Returned when a caller invokes crate::OutboxEnvelope::decode with a type whose crate::Event::EVENT_TYPE does not match the envelope’s event_type field. Typically the sign of a router or registry misconfiguration on the caller side.

Fields

expected: &'static str

Event type requested by the caller (E::EVENT_TYPE).

actual: String

Event type actually stored in the envelope.

Internal(String)

An invariant of the outbox machinery was violated.

Signals a bug in the framework itself, not a recoverable error. Report occurrences upstream.

Trait Implementations

impl Debug for OutboxError

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

Formats the value using the given formatter.

impl Display for OutboxError

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

Formats the value using the given formatter.

impl Error for OutboxError

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

fn from(source: Error) -> Self

Converts to this type from the input type.