{"record":{"id":"53834379b0b37d73","repo":"bevyengine/bevy","slug":"encountered-an-unrecoverable-error-all-assets-wil","errorCode":null,"errorMessage":"Encountered an unrecoverable error. All assets will be reprocessed.","messagePattern":"Encountered an unrecoverable error\\. All assets will be reprocessed\\.","errorType":"exception","errorClass":"ValidateLogError","httpStatus":null,"severity":"error","filePath":"crates/bevy_asset/src/processor/log.rs","lineNumber":262,"sourceCode":"    #[error(\"Failed to read log file: {0}\")]\n    Io(#[from] futures_io::Error),\n}\n\n/// An error that occurs when writing to the [`ProcessorTransactionLog`] fails.\n#[derive(Error, Debug)]\n#[error(\n    \"Failed to write {log_entry:?} to the asset processor log. This is not recoverable. {error}\"\n)]\npub(crate) struct WriteLogError {\n    pub(crate) log_entry: LogEntry,\n    pub(crate) error: BevyError,\n}\n\n/// An error that occurs when validating the [`ProcessorTransactionLog`] fails.\n#[derive(Error, Debug)]\npub enum ValidateLogError {\n    /// An error that could not be recovered from. All assets will be reprocessed.\n    #[error(\"Encountered an unrecoverable error. All assets will be reprocessed.\")]\n    UnrecoverableError,\n    /// A [`ReadLogError`].\n    #[error(\"Failed to read log entries: {0}\")]\n    ReadLogError(BevyError),\n    /// Duplicated process asset transactions occurred.\n    #[error(\"Encountered a duplicate process asset transaction: {0:?}\")]\n    EntryErrors(Vec<LogEntryError>),\n}\n\n/// An error that occurs when validating individual [`ProcessorTransactionLog`] entries.\n#[derive(Error, Debug)]\npub enum LogEntryError {\n    /// A duplicate process asset transaction occurred for the given asset path.\n    #[error(\"Encountered a duplicate process asset transaction: {0}\")]\n    DuplicateTransaction(AssetPath<'static>),\n    /// A transaction was ended that never started for the given asset path.\n    #[error(\"A transaction was ended that never started {0}\")]\n    EndedMissingTransaction(AssetPath<'static>),","sourceCodeStart":244,"sourceCodeEnd":280,"githubUrl":"https://github.com/bevyengine/bevy/blob/396ca727080776bd313bb892423b7d94e03b81b4/crates/bevy_asset/src/processor/log.rs#L244-L280","documentation":"ValidateLogError::Unrecoverable: the processor transaction log contains the unrecoverable marker, meaning a previous processing session failed in a way that leaves the log unreliable. The processor's documented response is to discard incremental state and reprocess all assets.","triggerScenarios":"Thrown at crates/bevy_asset/src/processor/log.rs:262 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Let the processor reprocess all assets (delete stale processed outputs if needed)","Find and fix the original failure that wrote the unrecoverable marker (often disk/full crash during processing)","Ensure only one processor instance writes a given log"],"exampleFix":null,"handlingStrategy":"fallback","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-14T05:17:10.506Z"}