hasura/graphql-engine · warning

get latest version: %w

Error message

get latest version: %w

What it means

Returned by HasUpdate when getLatestVersion() fails, i.e. the updater could not determine the latest release version (cli/update/update.go:118). The wrapped error usually comes from querying the release metadata feed (rate-limited GitHub API, network failure, or unparsable release tags). It aborts the update check before any comparison with the current version happens.

Source

Thrown at cli/update/update.go:118

// HasUpdate tells us if there is a new stable or prerelease update available.
func HasUpdate(
	currentVersion *semver.Version,
	timeFile string,
) (bool, *semver.Version, bool, *semver.Version, error) {
	var op errors.Op = "update.HasUpdate"

	if timeFile != "" {
		defer func() {
			err := writeTimeToFile(timeFile, time.Now().UTC())
			if err != nil {
				fmt.Fprintln(os.Stderr, "failed writing last update check time: ", err)
			}
		}()
	}

	latestVersion, preReleaseVersion, err := getLatestVersion()
	if err != nil {
		return false, nil, false, nil, errors.E(op, fmt.Errorf("get latest version: %w", err))
	}

	return latestVersion.GreaterThan(
			currentVersion,
		), latestVersion, preReleaseVersion.GreaterThan(
			currentVersion,
		), preReleaseVersion, nil
}

// ApplyUpdate downloads and applies the update indicated by version v.
func ApplyUpdate(v *semver.Version) error {
	var op errors.Op = "update.ApplyUpdate"
	// get the current executable
	exe, err := getExecutablePath()
	if err != nil {
		return errors.E(op, fmt.Errorf("find executable: %w", err))
	}

View on GitHub (pinned to 724551b9ae)

Solutions

1. Check connectivity to the release metadata endpoint (curl the URL used by getLatestVersion).
2. If rate-limited by the GitHub API, wait or set GITHUB_TOKEN so authenticated limits apply.
3. Retry the command; transient DNS/network failures resolve themselves.
4. Verify release tags follow semantic versioning if the error mentions parsing.

Example fix

// before
hasUpdate, latest, hasPre, pre, err := update.HasUpdate(current)
if err != nil { log.Fatal(err) }

// after
hasUpdate, latest, hasPre, pre, err := update.HasUpdate(current)
if err != nil {
    log.Printf("update check failed (continuing with current version): %v", err)
}

hasUpdate, latest, hasPre, pre, err := update.HasUpdate(cur)
if err != nil {
    log.Printf("skipping update check: %v", err)
    // proceed with current version
}

When it happens

Trigger: Invoking the CLI's update check (run -> HasUpdate) with no network access, an unreachable release metadata endpoint, GitHub API rate limiting (unauthenticated 403), or release tags that cannot be parsed as semver.

Common situations: CI sandboxes with blocked egress; GitHub API rate limits hit from shared NAT IPs; corporate proxies intercepting the request; the repo changed its release tag format so parsing fails.

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

• exporting metadata from server: %w
• reading metadata from response: %w
• command: check update: %w
• determining server metadata inconsistency: %w
• saving downloaded file: %w

AI-assisted analysis of hasura/graphql-engine@724551b9ae (2026-08-28). Data as JSON: /api/errors/1bfaca7d96d14dc0. Report an issue: GitHub.