hashicorp/nomad · error

errMismatchChecksum

errMismatchChecksum

Error message

mismatch checksum

What it means

Sentinel errMismatchChecksum from checksumValidatingReader: after fully reading the artifact, the computed hash's base64 does not match the expected checksum (e.g. from a Content-Checkum/manifest), so the downloaded content is corrupt or the wrong file.

Source

Thrown at api/ioutil.go:16

// Copyright IBM Corp. 2015, 2026
// SPDX-License-Identifier: MPL-2.0

package api

import (
	"crypto/sha256"
	"crypto/sha512"
	"encoding/base64"
	"errors"
	"hash"
	"io"
	"strings"
)

var errMismatchChecksum = errors.New("mismatch checksum")

// checksumValidatingReader is a wrapper reader that validates
// the checksum of the underlying reader.
type checksumValidatingReader struct {
	r io.ReadCloser

	// algo is the hash algorithm (e.g. `sha-256`)
	algo string

	// checksum is the base64 component of checksum
	checksum string

	// hash is the hashing function used to compute the checksum
	hash hash.Hash
}

// newChecksumValidatingReader returns a checksum-validating wrapper reader, according
// to a digest received in HTTP header

View on GitHub (pinned to 482b49bf1a)

Solutions

1. Re-download the artifact; the transfer may have been corrupted
2. Verify the expected checksum matches the actual file contents
3. Ensure the hashing algorithm (algo field) matches how the checksum was produced

When it happens

Trigger: Thrown at api/ioutil.go:16 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of hashicorp/nomad@482b49bf1a (2026-09-04). Data as JSON: /api/errors/4fefb34fc160d2e4. Report an issue: GitHub.