hashicorp/nomad · error

locks: %w

Error message

locks: %w

What it means

In LockLeaser.start's monitor loop, any error surfaced from ll.maintainLease (renewal, session loss, or lock invalidation other than ErrLockConflict, which exits silently) is wrapped with this prefix and returned from the lock monitoring loop, ending the caller's held lease. It means the Consul lock lease could no longer be maintained.

Source

Thrown at api/locks.go:343

				}
			}()

			// Maintain lease is a blocking function, it will return if there is
			// an error maintaining the lease or the protected function returned.
			err = ll.maintainLease(funcCtx)
			if err != nil && !errors.Is(err, ErrLockConflict) {
				errChannel <- fmt.Errorf("error renewing the lease: %w", err)
			}
		}

		waitTicker.Stop()
		waitTicker = time.NewTicker(ll.waitPeriod)
		select {
		case <-ctx.Done():
			return nil

		case err := <-errChannel:
			return fmt.Errorf("locks: %w", err)

		case <-waitTicker.C:
		}
	}
}

func (ll *LockLeaser) maintainLease(ctx context.Context) error {
	renewTicker := time.NewTicker(ll.renewalPeriod)
	defer renewTicker.Stop()
	for {
		select {
		case <-ctx.Done():
			return nil

		case <-renewTicker.C:
			err := ll.locker.Renew(ctx)
			if err != nil {
				return err

View on GitHub (pinned to 482b49bf1a)

Solutions

1. Inspect the wrapped inner error to determine whether the Consul session expired, the lock was contended, or the Consul connection failed
2. Verify connectivity between the client and the Consul servers
3. Re-acquire the lock by calling Start again once Consul is reachable
4. Check Consul server logs for session invalidation around the failure time

When it happens

Trigger: Thrown at api/locks.go:343 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/8c082efe09fd12f3. Report an issue: GitHub.