bevyengine/bevy · error

Failed to initialize asset processor log. This cannot be rec

Error message

Failed to initialize asset processor log. This cannot be recovered. Try restarting. If that doesn't work, try deleting processed asset folder. {}

What it means

Error emitted by AssetProcessor::initialize when validate_transaction_log_and_recover could not recover from an invalid transaction log: after detecting unrecoverable log state, the attempt to wipe and recreate the processed assets also failed, so the processor cannot construct a usable log.

Source

Thrown at crates/bevy_asset/src/processor/mod.rs:1337

            if !state_is_valid {
                error!("Processed asset transaction log state was invalid and unrecoverable for some reason (see previous logs). Removing processed assets and starting fresh.");
                for source in self.sources().iter_processed() {
                    let Ok(processed_writer) = source.processed_writer() else {
                        continue;
                    };
                    if let Err(err) = processed_writer
                        .remove_assets_in_directory(Path::new(""))
                        .await
                    {
                        panic!("Processed assets were in a bad state. To correct this, the asset processor attempted to remove all processed assets and start from scratch. This failed. There is no way to continue. Try restarting, or deleting imported asset folder manually. {err}");
                    }
                }
            }
        }
        let mut log = self.data.log.write().await;
        *log = match log_factory.create_new_log().await {
            Ok(log) => Some(log),
            Err(err) => panic!("Failed to initialize asset processor log. This cannot be recovered. Try restarting. If that doesn't work, try deleting processed asset folder. {}", err),
        };
    }
}

impl AssetProcessorData {
    /// Initializes a new [`AssetProcessorData`] using the given [`AssetSources`].
    pub(crate) fn new(sources: Arc<AssetSources>, processing_state: Arc<ProcessingState>) -> Self {
        AssetProcessorData {
            processing_state,
            sources,
            log_factory: Mutex::new(Some(Box::new(FileTransactionLogFactory::default()))),
            log: Default::default(),
            processors: Default::default(),
        }
    }

    /// Sets the transaction log factory for the processor.
    ///

View on GitHub (pinned to 396ca72708)

Solutions

1. Restart the application so initialization is retried
2. Manually delete the processed/imported asset folder
3. Verify write permissions and available disk space for the processed asset directory

When it happens

Trigger: Thrown at crates/bevy_asset/src/processor/mod.rs:1337 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/783a7249fef7fda2. Report an issue: GitHub.