influxdata/influxdb · error · Error

base URL error

Error message

base URL error: {}

What it means

The influxdb3_client Client wraps reqwest URL-parsing failures of its configured base URL into Error::BaseUrl, displayed as 'base URL error: {}'. It occurs when the string given for the server endpoint cannot be parsed into a valid reqwest/url::Url.

Solutions

1. Fix the base URL to include a valid scheme and host, e.g. http://localhost:8181.
2. Validate/parse the URL with the `url` crate before passing it to Client::new.
3. Check the environment variable or config value that supplies the endpoint for typos or interpolation issues.

Example fix

// before
let client = Client::new("localhost:8181")?;
// after
let client = Client::new("http://localhost:8181")?;

fn valid_base_url(s: &str) -> bool {
    url::Url::parse(s).map(|u| u.has_host()).unwrap_or(false)
}
// call before Client::new: assert!(valid_base_url(&base));

fn as_url(s: &str) -> Option<url::Url> { url::Url::parse(s).ok() }

match Client::new(base) {
    Err(e) if matches!(e, Error::BaseUrl(_)) => Err(format!("invalid base URL '{base}'")),
    other => other,
}

When it happens

Trigger: Constructing `Client::new("not-a-url")` or a base URL with a bad scheme/characters; passing an empty or malformed endpoint from configuration; providing a URL reqwest rejects (e.g. missing scheme).

Common situations: Config files with 'localhost:8181' (missing http://), trailing typos in environment variables, templating bugs that leave placeholder text in the URL.

Understand the failure class

Background: "Invalid URL" errors: why new URL(), URI.parse, and reqwest::Url reject your string — missing scheme, whitespace, and bad path format — this error's family across 39 libraries.

Related errors

• failed to build an http client
• An unexpected error occurred in the client library
• Cannot parse object store config
• cannot write to a compactor-only server
• client error

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

Appendix: source

Thrown at influxdb3_client/src/lib.rs:25

use reqwest::{
    Body, Certificate, IntoUrl, Method, StatusCode,
    header::{CONTENT_ENCODING, CONTENT_TYPE, HeaderMap, HeaderValue},
    tls::Version,
};
use secrecy::{ExposeSecret, Secret};
use serde::{Serialize, de::DeserializeOwned};
use std::error::Error as _;
use std::io::Write as _;
use std::{fmt::Display, num::NonZeroUsize, path::PathBuf, string::FromUtf8Error, time::Duration};
use url::Url;

use influxdb3_types::http::*;
pub use influxdb3_types::write::Precision;

/// Primary error type for the [`Client`]
#[derive(Debug, thiserror::Error)]
pub enum Error {
    #[error("base URL error: {}", reqwest_description(.0))]
    BaseUrl(#[source] reqwest::Error),

    #[error("request URL error: {0}")]
    RequestUrl(#[from] url::ParseError),

    #[error("failed to read the API response bytes: {}", reqwest_description(.0))]
    Bytes(#[source] reqwest::Error),

    #[error("failed to serialize the request body: {0}")]
    RequestSerialization(#[source] serde_json::Error),

    #[error(
        "provided parameter ('{name}') could not be converted \
        to a statment parameter"
    )]
    ConvertQueryParam {
        name: String,
        #[source]

View on GitHub (pinned to 06200ef96b)