{"record":{"id":"2dc3206e0fd35334","repo":"nautechsystems/nautilus_trader","slug":"failed-during-trader-startup-start-err-failed-2dc320","errorCode":null,"errorMessage":"Failed during trader startup: {start_err}; failed to finalize startup abort: {finalize_err}","messagePattern":"Failed during trader startup: (.+?); failed to finalize startup abort: (.+?)","errorType":"exception","errorClass":null,"httpStatus":null,"severity":"error","filePath":"crates/live/src/node/mod.rs","lineNumber":2331,"sourceCode":"        processed\n    }\n\n    async fn abort_after_trader_start_failure(\n        &mut self,\n        start_err: anyhow::Error,\n    ) -> anyhow::Result<()> {\n        log::info!(\"Trader startup failed, aborting startup\");\n        self.handle.set_shutting_down();\n        let stop_result = self.kernel.stop_trader_after_start_failure();\n        let finalize_result = self.finalize_stop().await;\n\n        match (stop_result, finalize_result) {\n            (Ok(()), Ok(())) => Err(start_err),\n            (Err(stop_err), Ok(())) => anyhow::bail!(\n                \"Failed during trader startup: {start_err}; failed to stop partial trader start: \\\n                 {stop_err}\"\n            ),\n            (Ok(()), Err(finalize_err)) => anyhow::bail!(\n                \"Failed during trader startup: {start_err}; failed to finalize startup abort: \\\n                 {finalize_err}\"\n            ),\n            (Err(stop_err), Err(finalize_err)) => anyhow::bail!(\n                \"Failed during trader startup: {start_err}; failed to stop partial trader start: \\\n                 {stop_err}; failed to finalize startup abort: {finalize_err}\"\n            ),\n        }\n    }\n\n    fn initiate_shutdown(&mut self) {\n        #[cfg(feature = \"plugin\")]\n        if let Err(e) = self.plugins.stop_controllers() {\n            log::error!(\"Error stopping plug-in controllers: {e}\");\n        }\n        self.kernel.stop_trader();\n        let delay = self.kernel.delay_post_stop();\n        log::info!(\"Awaiting residual events ({delay:?})...\");","sourceCodeStart":2313,"sourceCodeEnd":2349,"githubUrl":"https://github.com/nautechsystems/nautilus_trader/blob/18893faf8b356be3320add8de2f861b0b647cf06/crates/live/src/node/mod.rs#L2313-L2349","documentation":"Same compound-error path as its sibling: after a failed trader start, stopping the partial trader succeeded but finalize_stop() failed, so the message chains 'Failed during trader startup: {start_err}' with 'failed to finalize startup abort: {finalize_err}'.","triggerScenarios":"start or run_with_mode fails during trader startup; stop_trader_after_start_failure returns Ok but finalize_stop returns Err.","commonSituations":"Partial trader stops cleanly but final node shutdown steps (draining channels, kernel shutdown finalization) fail — e.g. background tasks not joining or channels already closed.","solutions":["Fix the original startup failure first (root cause)","Examine why finalize_stop failed — each joined error names a failing finalization step","Check for tasks that don't shut down or channels that were dropped early","Add tracing around finalize_stop to capture the failing step"],"exampleFix":null,"handlingStrategy":"try-catch","validationCode":null,"typeGuard":null,"tryCatchPattern":"if let Err(e) = node.start().await {\n    if e.to_string().contains(\"failed to finalize startup abort\") {\n        tracing::error!(error = %e, \"startup abort finalization failed\");\n    }\n    return Err(e);\n}","preventionTips":["Verify finalize_stop steps (task joins, channel drains) succeed in shutdown tests","Cancel spawned tasks before shutdown","Keep kernel shutdown idempotent"],"tags":["rust","startup","live-node","shutdown","error-chaining"],"backgroundTag":"internal-invariant-violation","analyzedSha":"18893faf8b356be3320add8de2f861b0b647cf06","analyzedAt":"2026-09-08T20:49:34.690Z","contentChangedAt":"2026-09-08T20:49:34.690Z","schemaVersion":2},"datasetVersion":"2026-09-14T05:17:10.506Z"}