Tencent/WeKnora · error

%w: batch reparse submitted %d item(s) and failed %d: %w

Error message

%w: batch reparse submitted %d item(s) and failed %d: %w

What it means

Terminal aggregate error returned by runKnowledgeListReparseSubmissions when some batch items failed to submit: reports both submitted and failed counts plus the joined per-item errors. Deliberately non-retryable — retrying the wrapper would destructively reparse already-submitted items; failed rows remain selectable for an explicit retry.

Source

Thrown at internal/application/service/knowledge_process.go:3973

// submitted successfully. Failed rows remain selectable for an explicit retry.
func runKnowledgeListReparseSubmissions(
	ids []string,
	submit func(string) error,
) (knowledgeListReparseOutcome, error) {
	var outcome knowledgeListReparseOutcome
	failures := make([]error, 0)
	for _, id := range ids {
		if err := submit(id); err != nil {
			failures = append(failures, fmt.Errorf("knowledge %s: %w", secutils.SanitizeForLog(id), err))
			outcome.Failed++
			continue
		}
		outcome.Submitted++
	}
	if len(failures) == 0 {
		return outcome, nil
	}
	return outcome, fmt.Errorf(
		"%w: batch reparse submitted %d item(s) and failed %d: %w",
		asynq.SkipRetry, outcome.Submitted, outcome.Failed, errors.Join(failures...),
	)
}

View on GitHub (pinned to 988cbb0330)

Solutions

  1. Read the joined errors to identify which IDs failed
  2. Retry only the failed IDs explicitly, never the whole batch
  3. Treat partial success as final for this run (exit 1 if any failed, per CLI semantics)
Defensive patterns

Strategy: try-catch

When it happens

Trigger: Thrown at internal/application/service/knowledge_process.go:3973 when the library encounters an invalid state.

Common situations: See trigger scenarios.


AI-assisted analysis of Tencent/WeKnora@988cbb0330 (2026-09-02). Data as JSON: /api/errors/000994009c571b42. Report an issue: GitHub.