influxdata/influxdb · error · Error

failed to initialize last cache

Error message

failed to initialize last cache: {0}

What it means

Display message of the `Error::InitializeLastCache` variant, wrapping a `last_cache::Error` (#[source]) from constructing the last-N-values cache at startup. The last cache is optional per-table, so failure typically comes from invalid cache configuration for a table.

Solutions

1. Read the wrapped last_cache::Error to see which cache spec failed
2. Drop and recreate the offending last cache against the current table schema
3. Verify cached column names still exist in the table schema
4. Adjust cache count/TTL parameters to valid values

Example fix

// before
CREATE LAST CACHE ON "mytable"(Name) ; -- column removed from schema
// after
DROP LAST CACHE ON "mytable";
CREATE LAST CACHE ON "mytable"(host) ; -- column that exists in current schema

-- before starting, verify each last-cache spec's columns exist:
-- SHOW CREATE TABLE / check schema vs cached column names

match serve_result {
    Err(Error::InitializeLastCache(src)) => eprintln!("last cache init failed: {src}"),
    ...
}

When it happens

Trigger: A configured last cache (e.g. from a cached `CREATE LAST CACHE` spec replayed at startup) fails to build because its columns, TTL, or count settings are invalid for the table's current schema.

Common situations: A table's schema changed (column renamed/removed) after a last cache was created, so the stored cache spec no longer matches; or invalid cache size/TTL values.

Related errors

• failed to initialize distinct cache
• cache not found
• column id in series key should be valid
• Error creating record batch
• error from table buffer

AI-assisted analysis of influxdata/influxdb@06200ef96b (2026-09-19). Data as JSON: /api/errors/652aecfbcda930a0. Report an issue: GitHub.

Appendix: source

Thrown at influxdb3/src/commands/serve.rs:147

    #[error("Server error: {0}")]
    Server(#[source] influxdb3_server::Error),

    #[error("Token error: {0}")]
    TokenError(CatalogError),

    #[error("Write buffer error: {0}")]
    WriteBuffer(#[from] influxdb3_write::write_buffer::Error),

    #[error("invalid token: {0}")]
    InvalidToken(#[from] hex::FromHexError),

    #[error("failed to initialize write buffer: {0:?}")]
    WriteBufferInit(#[source] anyhow::Error),

    #[error("failed to initialize catalog: {0}")]
    InitializeCatalog(#[source] CatalogError),

    #[error("failed to initialize last cache: {0}")]
    InitializeLastCache(#[source] last_cache::Error),

    #[error("failed to initialize distinct cache: {0:#}")]
    InitializeDistinctCache(#[source] influxdb3_cache::distinct_cache::ProviderError),

    #[error("lost backend")]
    LostBackend,

    #[error("lost HTTP/gRPC service")]
    LostHttpGrpc,

    #[error("lost admin token recovery service")]
    LostAdminTokenRecovery,

    #[error("tls requires both a cert and a key file to be passed in to work")]
    NoCertOrKeyFile,

    #[error("table cache index initialization failed: {0}")]

View on GitHub (pinned to 06200ef96b)