influxdata/influxdb · error · Error

Token error

Error message

Token error: {0}

What it means

Display message of the `Error::TokenError` variant, which wraps a `CatalogError` encountered while handling the auth/bearer token. It indicates the token could not be resolved or validated against the catalog during server startup or token handling.

Solutions

1. Verify the catalog contains the expected token records (inspect the catalog store directly)
2. Fix or recreate the catalog storage backend if it is corrupt or unreachable
3. Regenerate/recreate the admin token so it is consistently stored in the catalog
4. Check object-store/DB connectivity settings used by the catalog

Example fix

// before
influxdb3 serve --node-id=node1 ...
// after
# ensure catalog store is healthy, then re-create the token
influxdb3 create token --admin

// before serving, confirm the token exists in the catalog store
// e.g. query the catalog/token table with the same storage backend

match result {
    Err(Error::TokenError(e)) => eprintln!("catalog token lookup failed: {e}"),
    other => other?,
}

When it happens

Trigger: The serve command tries to look up or verify an admin/bearer token against the catalog and the catalog lookup returns a `CatalogError`.

Common situations: Corrupt or partially-migrated catalog state, token referenced in config does not exist in the catalog, or catalog storage (object store / SQLite) is unreachable or inconsistent.

Related errors

• duration not to overflow
• token info must be present after token creation by name
• Authentication error
• authorization failure
• cannot delete operator token

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

Appendix: source

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

#[derive(Debug, Error)]
pub enum Error {
    #[error("Cannot parse object store config: {0}")]
    ObjectStoreParsing(#[from] influxdb3_clap_blocks::object_store::ParseError),

    #[error("Tracing config error: {0}")]
    TracingConfig(#[from] trace_exporters::Error),

    #[error("Error initializing tokio runtime: {0}")]
    TokioRuntime(#[source] std::io::Error),

    #[error("Failed to bind address")]
    BindAddress(#[source] std::io::Error),

    #[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:#}")]

View on GitHub (pinned to 06200ef96b)