{"record":{"id":"8ba9ca4636858afc","repo":"bevyengine/bevy","slug":"failed-to-load-dependency-dependency-error","errorCode":null,"errorMessage":"Failed to load dependency {dependency:?} {error}","messagePattern":"Failed to load dependency (.+?) (.+?)","errorType":"exception","errorClass":"LoadDirectError","httpStatus":null,"severity":"error","filePath":"crates/bevy_asset/src/loader.rs","lineNumber":354,"sourceCode":"\n    fn asset_type_name(&self) -> &'static str {\n        core::any::type_name::<A>()\n    }\n}\n\n/// An error that occurs when attempting an async load using [`NestedLoadBuilder`].\n#[derive(Error, Debug)]\npub enum LoadDirectError {\n    /// The asset path was empty.\n    #[error(\"Attempted to load an asset with an empty path \\\"{0}\\\"\")]\n    EmptyPath(AssetPath<'static>),\n    /// Loading an asset path with a subasset at the end is unsupported. See issue [#18291].\n    ///\n    /// [#18291]: https://github.com/bevyengine/bevy/issues/18291\n    #[error(\"Requested to load an asset path ({0:?}) with a subasset, but this is unsupported. See issue #18291\")]\n    RequestedSubasset(AssetPath<'static>),\n    /// A general [`AssetLoadError`] for an asset dependency.\n    #[error(\"Failed to load dependency {dependency:?} {error}\")]\n    LoadError {\n        /// Which dependency failed.\n        dependency: AssetPath<'static>,\n        /// The original error for that dependency.\n        error: Box<AssetLoadError>,\n    },\n}\n\n/// An error that occurs while deserializing [`AssetMeta`].\n#[derive(Error, Debug, Clone, PartialEq, Eq)]\npub enum DeserializeMetaError {\n    /// Failed to deserialize the asset metadata.\n    #[error(\"Failed to deserialize asset meta: {0:?}\")]\n    DeserializeSettings(#[from] SpannedError),\n    /// Failed to deserialize the minimal asset metadata.\n    #[error(\"Failed to deserialize minimal asset meta: {0:?}\")]\n    DeserializeMinimal(SpannedError),\n}","sourceCodeStart":336,"sourceCodeEnd":372,"githubUrl":"https://github.com/bevyengine/bevy/blob/396ca727080776bd313bb892423b7d94e03b81b4/crates/bevy_asset/src/loader.rs#L336-L372","documentation":"LoadDirectError::LoadError: a dependency of the asset being loaded failed to load; the error records which dependency path failed and the underlying AssetLoadError (reader failure, deserialize failure, etc.). The parent load is aborted because its dependency tree is incomplete.","triggerScenarios":"Thrown at crates/bevy_asset/src/loader.rs:354 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Inspect the inner error to find the root cause for the dependency path shown","Fix or restore the missing/invalid dependency asset","Handle failed dependent loads gracefully (e.g. placeholder asset) and retrigger once dependencies are fixed"],"exampleFix":null,"handlingStrategy":"retry","validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"396ca727080776bd313bb892423b7d94e03b81b4","analyzedAt":"2026-08-20T16:12:39.808Z","contentChangedAt":"2026-08-20T16:12:39.808Z","schemaVersion":2},"datasetVersion":"2026-09-14T00:17:10.932Z"}