bevyengine/bevy · error · TryFromFilteredError

Conversion failed, filtered entity ref does not have read ac

Error message

Conversion failed, filtered entity ref does not have read access to all components

What it means

TryFromFilteredError::MissingReadAccess: converting a FilteredEntityRef/FilteredEntityMut into an EntityRef failed because the filtered access set does not grant read access to all of the entity's components — EntityRef requires full read access.

Source

Thrown at crates/bevy_ecs/src/world/entity_access/filtered.rs:807

}

impl ContainsEntity for FilteredEntityMut<'_, '_> {
    fn entity(&self) -> Entity {
        self.id()
    }
}

// SAFETY: This type represents one Entity. We implement the comparison traits based on that Entity.
unsafe impl EntityEquivalent for FilteredEntityMut<'_, '_> {}

/// Error type returned by [`TryFrom`] conversions from filtered entity types
/// ([`FilteredEntityRef`]/[`FilteredEntityMut`]) to full-access entity types
/// ([`EntityRef`]/[`EntityMut`]).
#[derive(Error, Debug)]
pub enum TryFromFilteredError {
    /// Error indicating that the filtered entity does not have read access to
    /// all components.
    #[error("Conversion failed, filtered entity ref does not have read access to all components")]
    MissingReadAllAccess,
    /// Error indicating that the filtered entity does not have write access to
    /// all components.
    #[error("Conversion failed, filtered entity ref does not have write access to all components")]
    MissingWriteAllAccess,
}

View on GitHub (pinned to 396ca72708)

Solutions

1. Use try_from / try_into and handle the Err case
2. Obtain an EntityRef directly from the world instead of from a filtered access
3. Widen the filtered access (or use unfiltered entity fetching) so all components are readable

When it happens

Trigger: Thrown at crates/bevy_ecs/src/world/entity_access/filtered.rs:807 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/75aa67df71f57de5. Report an issue: GitHub.