Tencent/WeKnora · error

failed to get or create default untagged tag: %w

Error message

failed to get or create default untagged tag: %w

What it means

FindOrCreateTagByName failed for the default '未分类' (untagged) tag: neither the caller's tag_id nor tag_name was provided, and the fallback that ensures the default tag exists errored, so no tag can be assigned and the FAQ write is aborted.

Source

Thrown at internal/application/service/knowledge_faq.go:1971

		if err != nil {
			return "", fmt.Errorf("failed to find tag by seq_id %d: %w", payload.TagID, err)
		}
		return tag.ID, nil
	}

	// 如果提供了 tag_name，查找或创建标签
	if payload.TagName != "" {
		tag, err := s.tagService.FindOrCreateTagByName(ctx, kbID, payload.TagName)
		if err != nil {
			return "", fmt.Errorf("failed to resolve tag by name '%s': %w", payload.TagName, err)
		}
		return tag.ID, nil
	}

	// 都没有提供，使用"未分类"标签
	tag, err := s.tagService.FindOrCreateTagByName(ctx, kbID, types.UntaggedTagName)
	if err != nil {
		return "", fmt.Errorf("failed to get or create default untagged tag: %w", err)
	}
	return tag.ID, nil
}

func sanitizeFAQEntryPayload(payload *types.FAQEntryPayload) (*types.FAQChunkMetadata, error) {
	// 处理 AnswerStrategy，默认为 all
	answerStrategy := types.AnswerStrategyAll
	if payload.AnswerStrategy != nil && *payload.AnswerStrategy != "" {
		switch *payload.AnswerStrategy {
		case types.AnswerStrategyAll, types.AnswerStrategyRandom:
			answerStrategy = *payload.AnswerStrategy
		default:
			return nil, werrors.NewBadRequestError("answer_strategy 必须是 'all' 或 'random'")
		}
	}
	meta := &types.FAQChunkMetadata{
		StandardQuestion:  strings.TrimSpace(payload.StandardQuestion),
		SimilarQuestions:  payload.SimilarQuestions,

View on GitHub (pinned to 988cbb0330)

Solutions

1. Check tag service/storage health from the wrapped error
2. Pre-seed the default untagged tag per knowledge base
3. Retry the operation; ensure-idempotency of FindOrCreate makes retries safe

When it happens

Trigger: Thrown at internal/application/service/knowledge_faq.go:1971 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/fe660255709d1d1c. Report an issue: GitHub.