{"record":{"id":"f6dbf67e7c3dd747","repo":"bevyengine/bevy","slug":"failed-to-read-log-file-0","errorCode":null,"errorMessage":"Failed to read log file: {0}","messagePattern":"Failed to read log file: (.+?)","errorType":"exception","errorClass":"ReadLogError","httpStatus":null,"severity":"error","filePath":"crates/bevy_asset/src/processor/log.rs","lineNumber":244,"sourceCode":"        &'a mut self,\n        asset: &'a AssetPath<'_>,\n    ) -> BoxedFuture<'a, Result<(), BevyError>> {\n        Box::pin(async move { self.write(&format!(\"{ENTRY_END}{asset}\\n\")).await })\n    }\n\n    fn unrecoverable(&mut self) -> BoxedFuture<'_, Result<(), BevyError>> {\n        Box::pin(async move { self.write(UNRECOVERABLE_ERROR).await })\n    }\n}\n\n/// An error that occurs when reading from the [`ProcessorTransactionLog`] fails.\n#[derive(Error, Debug)]\npub enum ReadLogError {\n    /// An invalid log line was encountered, consisting of the contained string.\n    #[error(\"Encountered an invalid log line: '{0}'\")]\n    InvalidLine(String),\n    /// A file-system-based error occurred while reading the log file.\n    #[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.\")]","sourceCodeStart":226,"sourceCodeEnd":262,"githubUrl":"https://github.com/bevyengine/bevy/blob/396ca727080776bd313bb892423b7d94e03b81b4/crates/bevy_asset/src/processor/log.rs#L226-L262","documentation":"ReadLogError::Io: reading the ProcessorTransactionLog from disk failed with an underlying futures io error (file missing mid-read, permissions, truncated by a crash). The log replay cannot continue until the io issue is resolved.","triggerScenarios":"Thrown at crates/bevy_asset/src/processor/log.rs:244 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Inspect the inner io error for the filesystem cause","Ensure the log file is readable and not locked by another processor instance","Retry after fixing the io condition; if the file was corrupted, remove it to force full reprocessing"],"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-14T05:17:10.506Z"}