DioxusLabs/dioxus · error · HttpError

{}: {}

Error message

{}: {}

What it means

Not a thrown error itself: this format string is HttpError's Display impl used by helpers like bad_request/unauthorized, rendering the HTTP status code followed by the optional human-readable message when a server function rejects a request.

Source

Thrown at packages/fullstack-core/src/httperror.rs:26

    pub status: StatusCode,
    pub message: Option<String>,
}

impl HttpError {
    pub fn new<M: Into<String>>(status: StatusCode, message: M) -> Self {
        HttpError {
            status,
            message: Some(message.into()),
        }
    }

    pub fn err<T>(status: StatusCode, message: impl Into<String>) -> Result<T, Self> {
        Err(HttpError::new(status, message))
    }

    // --- 4xx Client Errors ---
    pub fn bad_request<T>(message: impl Into<String>) -> Result<T, Self> {
        Self::err(StatusCode::BAD_REQUEST, message)
    }
    pub fn unauthorized<T>(message: impl Into<String>) -> Result<T, Self> {
        Self::err(StatusCode::UNAUTHORIZED, message)
    }
    pub fn payment_required<T>(message: impl Into<String>) -> Result<T, Self> {
        Self::err(StatusCode::PAYMENT_REQUIRED, message)
    }
    pub fn forbidden<T>(message: impl Into<String>) -> Result<T, Self> {
        Self::err(StatusCode::FORBIDDEN, message)
    }
    pub fn not_found<T>(message: impl Into<String>) -> Result<T, Self> {
        Self::err(StatusCode::NOT_FOUND, message)
    }
    pub fn method_not_allowed<T>(message: impl Into<String>) -> Result<T, Self> {
        Self::err(StatusCode::METHOD_NOT_ALLOWED, message)
    }
    pub fn not_acceptable<T>(message: impl Into<String>) -> Result<T, Self> {
        Self::err(StatusCode::NOT_ACCEPTABLE, message)

View on GitHub (pinned to 24f6a829df)

Solutions

1. Read the HTTP status and message carried by this error to diagnose the failing server function call; fix the request or the server handler accordingly.

When it happens

Trigger: Thrown at packages/fullstack-core/src/httperror.rs:26 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of DioxusLabs/dioxus@24f6a829df (2026-08-23). Data as JSON: /api/errors/261ec02d977c8556. Report an issue: GitHub.