{"record":{"id":"98a1e37e138a1ffc","repo":"influxdata/influxdb","slug":"table-cache-index-initialization-failed-0","errorCode":null,"errorMessage":"table cache index initialization failed: {0}","messagePattern":"table cache index initialization failed: (.+?)","errorType":"exception","errorClass":"Error","httpStatus":null,"severity":"critical","filePath":"influxdb3/src/commands/serve.rs","lineNumber":165,"sourceCode":"    #[error(\"failed to initialize last cache: {0}\")]\n    InitializeLastCache(#[source] last_cache::Error),\n\n    #[error(\"failed to initialize distinct cache: {0:#}\")]\n    InitializeDistinctCache(#[source] influxdb3_cache::distinct_cache::ProviderError),\n\n    #[error(\"lost backend\")]\n    LostBackend,\n\n    #[error(\"lost HTTP/gRPC service\")]\n    LostHttpGrpc,\n\n    #[error(\"lost admin token recovery service\")]\n    LostAdminTokenRecovery,\n\n    #[error(\"tls requires both a cert and a key file to be passed in to work\")]\n    NoCertOrKeyFile,\n\n    #[error(\"table cache index initialization failed: {0}\")]\n    TableIndexCacheInitialization(\n        #[source] influxdb3_write::table_index_cache::TableIndexCacheError,\n    ),\n\n    #[error(\n        \"environment variable {0} (named by --node-id-from-env / INFLUXDB3_NODE_ID_FROM_ENV) \\\n        must be set to a valid node id\"\n    )]\n    NodeIdEnvVarMissing(String),\n\n    #[error(\n        \"Python environment initialization failed: {0}\\nPlease ensure Python and pip package manager is installed\"\n    )]\n    PythonEnvironmentInitialization(\n        #[source] influxdb3_processing_engine::environment::PluginEnvironmentError,\n    ),\n}\n","sourceCodeStart":147,"sourceCodeEnd":183,"githubUrl":"https://github.com/influxdata/influxdb/blob/06200ef96ba82c5f6727e5038a83af8e722c6875/influxdb3/src/commands/serve.rs#L147-L183","documentation":"Wraps a `TableIndexCacheError` from influxdb3_write that occurred while initializing the table index cache during server startup. The table index cache must be fully initialized before WAL snapshotting, retention, or hard deletion start, so a failure here aborts startup.","triggerScenarios":"`table_index_cache.initialize().await` returns Err during serve startup, e.g. because loading persisted table definitions from the WAL/parquet files fails or the underlying write buffer is corrupt.","commonSituations":"Corrupted or truncated WAL files, schema/catalog data unreadable on disk, or version-downgrade scenarios where persisted snapshots cannot be transformed to table indexes.","solutions":["Read the chained #[source] TableIndexCacheError message for the underlying cause.","Check data-directory disk health and permissions; verify WAL files are not corrupted.","Restore the node's data directory from backup if WAL/parquet data is corrupt.","Upgrade influxdb3; if the cause looks like a bug, file an issue with logs."],"exampleFix":null,"handlingStrategy":"try-catch","validationCode":"null","typeGuard":"null","tryCatchPattern":"match result {\n    Err(Error::TableIndexCacheInitialization(src)) => {\n        eprintln!(\"table index cache init failed: {src}\");\n        // inspect src (TableIndexCacheError) for root cause\n    }\n    ...\n}","preventionTips":["Keep the data directory on healthy, sufficiently sized storage.","Avoid abrupt kills; allow clean shutdown to flush WAL.","Do not downgrade binaries against data written by newer versions.","Back up the data directory before upgrades."],"tags":["startup","cache","storage","influxdb3"],"backgroundTag":"module-init-failed","analyzedSha":"06200ef96ba82c5f6727e5038a83af8e722c6875","analyzedAt":"2026-09-19T12:55:30.003Z","contentChangedAt":"2026-09-19T12:55:30.003Z","schemaVersion":2},"datasetVersion":"2026-09-23T08:17:48.524Z"}