weaviate/weaviate · error

commit: %w

Error message

commit: %w

What it means

Wraps backup.manager.OnCommit failure in the cluster-API commit handler: the request body parsed as a backup.StatusRequest, but the local backup manager rejected or failed the commit step (invalid backup state transition, coordinator error, or storage failure). Surfaced as an HTTP 500 to the coordinating node, which then fails the backup transaction.

Source

Thrown at adapters/handlers/rest/clusterapi/backups.go:93

	return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
		body, err := io.ReadAll(r.Body)
		if err != nil {
			status := http.StatusInternalServerError
			http.Error(w, fmt.Errorf("read request body: %w", err).Error(), status)
			return
		}
		defer r.Body.Close()

		var req backup.StatusRequest
		if err := json.Unmarshal(body, &req); err != nil {
			status := http.StatusInternalServerError
			http.Error(w, fmt.Errorf("unmarshal request: %w", err).Error(), status)
			return
		}

		if err := b.manager.OnCommit(r.Context(), &req); err != nil {
			status := http.StatusInternalServerError
			http.Error(w, fmt.Errorf("commit: %w", err).Error(), status)
			return
		}

		w.WriteHeader(http.StatusCreated)
	})
}

func (b *backups) Abort() http.Handler {
	return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
		body, err := io.ReadAll(r.Body)
		if err != nil {
			status := http.StatusInternalServerError
			http.Error(w, fmt.Errorf("read request body: %w", err).Error(), status)
			return
		}
		defer r.Body.Close()

		var req backup.AbortRequest

View on GitHub (pinned to 75aa4b6d11)

Solutions

1. Check the participant node's backup manager logs for the OnCommit failure
2. Verify backup bucket/path accessibility
3. Retry the backup once the underlying issue is resolved

When it happens

Trigger: Thrown at adapters/handlers/rest/clusterapi/backups.go:93 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of weaviate/weaviate@75aa4b6d11 (2026-09-04). Data as JSON: /api/errors/322ee0cb7a607361. Report an issue: GitHub.