bevyengine/bevy · error · AssetReaderError

Encountered HTTP status {0:?} when loading asset

Error message

Encountered HTTP status {0:?} when loading asset

What it means

AssetReaderError::HttpErrorStatus: an HTTP-based AssetReader completed its request but received an unhandled response status code (e.g. 404, 500) instead of the asset bytes. The error carries the status so the caller can distinguish missing assets from server failures.

Source

Thrown at crates/bevy_asset/src/io/mod.rs:62

    path::{Path, PathBuf},
};
use thiserror::Error;

/// Errors that occur while loading assets.
#[derive(Error, Debug, Clone)]
pub enum AssetReaderError {
    /// Path not found.
    #[error("Path not found: {}", _0.display())]
    NotFound(PathBuf),

    /// Encountered an I/O error while loading an asset.
    #[error("Encountered an I/O error while loading asset: {0}")]
    Io(Arc<std::io::Error>),

    /// The HTTP request completed but returned an unhandled [HTTP response status code](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status).
    /// - If the request returns a 404 error, expect [`AssetReaderError::NotFound`].
    /// - If the request fails before getting a status code (e.g. request timeout, interrupted connection, etc), expect [`AssetReaderError::Io`].
    #[error("Encountered HTTP status {0:?} when loading asset")]
    HttpError(u16),
}

impl PartialEq for AssetReaderError {
    /// Equality comparison for `AssetReaderError::Io` is not full (only through `ErrorKind` of inner error)
    #[inline]
    fn eq(&self, other: &Self) -> bool {
        match (self, other) {
            (Self::NotFound(path), Self::NotFound(other_path)) => path == other_path,
            (Self::Io(error), Self::Io(other_error)) => error.kind() == other_error.kind(),
            (Self::HttpError(code), Self::HttpError(other_code)) => code == other_code,
            _ => false,
        }
    }
}

impl Eq for AssetReaderError {}

View on GitHub (pinned to 396ca72708)

Solutions

1. For 404: verify the asset URL/path is correct on the server
2. For 5xx: retry the request later or against a healthy server instance
3. Extend/adjust the remote asset source configuration if status codes are unexpectedly unhandled

When it happens

Trigger: Thrown at crates/bevy_asset/src/io/mod.rs:62 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of bevyengine/bevy@396ca72708 (2026-08-20). Data as JSON: /api/errors/8b5c4c524e08b6d5. Report an issue: GitHub.