{"record":{"id":"01accfc382d3943c","repo":"bevyengine/bevy","slug":"an-error-occurred-while-resolving-an-asset-added-b","errorCode":null,"errorMessage":"An error occurred while resolving an asset added by `add_async`: {error}","messagePattern":"An error occurred while resolving an asset added by `add_async`: (.+?)","errorType":"exception","errorClass":"AddAsyncError","httpStatus":null,"severity":"error","filePath":"crates/bevy_asset/src/server/mod.rs","lineNumber":2311,"sourceCode":"\nimpl AssetLoaderError {\n    /// The path of the asset that failed to load.\n    pub fn path(&self) -> &AssetPath<'static> {\n        &self.path\n    }\n\n    /// The error the loader reported when attempting to load the asset.\n    ///\n    /// If you know the type of the error the asset loader returned, you can use\n    /// [`BevyError::downcast_ref()`] to get it.\n    pub fn error(&self) -> &BevyError {\n        &self.error\n    }\n}\n\n/// An error that occurs while resolving an asset added by `add_async`.\n#[derive(Error, Debug, Clone)]\n#[error(\"An error occurred while resolving an asset added by `add_async`: {error}\")]\npub struct AddAsyncError {\n    error: Arc<dyn core::error::Error + Send + Sync + 'static>,\n}\n\n/// An error that occurs when an [`AssetLoader`] is not registered for a given extension.\n#[derive(Error, Debug, Clone, PartialEq, Eq)]\n#[error(\"no `AssetLoader` found{}\", format_missing_asset_ext(extensions))]\npub struct MissingAssetLoaderForExtensionError {\n    extensions: Vec<String>,\n}\n\n/// An error that occurs when an [`AssetLoader`] is not registered for a given [`core::any::type_name`].\n#[derive(Error, Debug, Clone, PartialEq, Eq)]\n#[error(\"no `AssetLoader` found with the name '{type_name}'\")]\npub struct MissingAssetLoaderForTypeNameError {\n    /// The type name that was not found.\n    pub type_name: String,\n}","sourceCodeStart":2293,"sourceCodeEnd":2329,"githubUrl":"https://github.com/bevyengine/bevy/blob/227d3a6c661b3bdf3020d3e8290b5a6ffd0226f7/crates/bevy_asset/src/server/mod.rs#L2293-L2329","documentation":"AddAsyncError — the future registered via AssetServer::add_async completed but resolving the resulting asset into the server failed; the underlying error (e.g. missing loader for the produced type) is wrapped in the payload. Check that a loader/registration exists for the asset type produced by the async operation.","triggerScenarios":"Thrown at crates/bevy_asset/src/server/mod.rs:2296 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Handle the Result returned by add_async","Inspect the wrapped inner error for the root cause","Add retries or fallback asset paths for flaky async sources"],"exampleFix":null,"handlingStrategy":"try-catch","validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"227d3a6c661b3bdf3020d3e8290b5a6ffd0226f7","analyzedAt":"2026-08-20T16:12:39.808Z","contentChangedAt":"2026-08-20T16:12:39.808Z","schemaVersion":2},"datasetVersion":"2026-09-14T00:17:10.932Z"}