influxdata/influxdb · error · Error

hyper error

Error message

hyper error: {0}

What it means

A variant of influxdb3_server::Error produced when an underlying hyper::Error is propagated via #[from]. It means the HTTP server's transport layer (hyper) failed while reading the request or writing the response — connection resets, aborted requests, malformed HTTP framing, timeouts at the protocol level.

Solutions

1. Inspect the source hyper error and server logs to identify whether it is a client disconnect (often benign) or a server-side transport fault
2. Retry the request from the client with a longer timeout / keep-alive settings
3. Check for intermediary proxies or load balancers dropping connections and adjust their idle timeouts

match err {
    ServerError::Hyper(h) if h.is_incomplete_message() || h.is_parse() => {
        // transport failure: retry with backoff, or treat client disconnect as benign
    }
    ServerError::Hyper(h) => log::error!("hyper transport error: {h}"),
    _ => return Err(err),
}

When it happens

Trigger: Client disconnects mid-request or mid-response; request body stream aborts; hyper fails to parse a malformed HTTP request; response body channel is dropped while hyper is still streaming.

Common situations: Clients with aggressive timeouts canceling slow queries; load balancers closing idle connections; network interruptions between client and server; a client sending invalid HTTP framing.

Understand the failure class

Background: 'Something went wrong' / 'Request failed (500)' / 'HTTP error! status: 404' — what failed HTTP requests actually mean and how to find the real cause — this error's family across 28 libraries.

Related errors

• client disconnected
• client error
• error fetching plugin from repository
• error serving http
• failed to read the API response bytes

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

Appendix: source

Thrown at influxdb3_server/src/lib.rs:63

use tokio_rustls::rustls::pki_types::pem::PemObject;
use tokio_rustls::rustls::pki_types::{CertificateDer, PrivateKeyDer};
use tokio_rustls::rustls::{ServerConfig, SupportedProtocolVersion};
use tokio_util::sync::CancellationToken;
use trace::TraceCollector;
use trace_http::ctx::TraceHeaderParser;
use trace_http::metrics::{MetricFamily, RequestMetrics};
use trace_http::tower::{ServiceProtocol, TraceLayer};
use unified_service::{RemoteAddrLayer, UnifiedService};

pub const PRODUCT_NAME: &str = "InfluxDB 3 Core";
pub const INFLUXDB3_BUILD: &str = "Core";

/// Version string combining the product name, [`influxdb3_process::INFLUXDB3_VERSION`], and [`influxdb3_process::INFLUXDB3_GIT_HASH`].
pub static VERSION_STRING: LazyLock<String> = LazyLock::new(|| build_version_string(PRODUCT_NAME));

#[derive(Debug, Error)]
pub enum Error {
    #[error("hyper error: {0}")]
    Hyper(#[from] hyper::Error),

    #[error("http error: {0}")]
    Http(#[from] Box<http::Error>),

    #[error("database not found {db_name}")]
    DatabaseNotFound { db_name: String },

    #[error("datafusion error: {0}")]
    DataFusion(#[from] datafusion::error::DataFusionError),

    #[error("influxdb3_write error: {0}")]
    InfluxDB3Write(#[from] influxdb3_write::Error),

    #[error("from hex error: {0}")]
    FromHex(#[from] hex::FromHexError),

    #[error("io error: {0}")]

View on GitHub (pinned to 06200ef96b)