{"record":{"id":"6c1095a2eb3188f7","repo":"Tencent/WeKnora","slug":"failed-to-enqueue-manual-process-task-w","errorCode":null,"errorMessage":"failed to enqueue manual process task: %w","messagePattern":"failed to enqueue manual process task: %w","errorType":"exception","errorClass":null,"httpStatus":null,"severity":"error","filePath":"internal/application/service/knowledge_create.go","lineNumber":1139,"sourceCode":"\tpayload := types.ManualProcessPayload{\n\t\tRequestId:       requestID,\n\t\tTenantID:        knowledge.TenantID,\n\t\tKnowledgeID:     knowledge.ID,\n\t\tKnowledgeBaseID: knowledge.KnowledgeBaseID,\n\t\tContent:         content,\n\t\tNeedCleanup:     needCleanup,\n\t}\n\tlangfuse.InjectTracing(ctx, &payload)\n\tpayloadBytes, err := json.Marshal(payload)\n\tif err != nil {\n\t\treturn \"\", fmt.Errorf(\"failed to marshal manual process payload: %w\", err)\n\t}\n\n\ttask := asynq.NewTask(types.TypeManualProcess, payloadBytes,\n\t\tasynq.Queue(types.QueueDefault), asynq.MaxRetry(3), asynq.Timeout(30*time.Minute))\n\tinfo, err := s.task.Enqueue(task)\n\tif err != nil {\n\t\treturn \"\", fmt.Errorf(\"failed to enqueue manual process task: %w\", err)\n\t}\n\tlogger.Infof(ctx, \"Enqueued manual process task: knowledge_id=%s, asynq_id=%s\", knowledge.ID, info.ID)\n\treturn info.ID, nil\n}\n\n// markKnowledgeEnqueueFailed prevents a durable knowledge row from remaining\n// indefinitely \"pending\" when its background processing task was never\n// created. The API may still return the row so callers can retry it.\nfunc (s *knowledgeService) markKnowledgeEnqueueFailed(ctx context.Context, knowledge *types.Knowledge) {\n\tif knowledge == nil {\n\t\treturn\n\t}\n\tknowledge.ParseStatus = \"failed\"\n\tknowledge.ErrorMessage = \"Failed to enqueue processing task\"\n\tif err := s.repo.UpdateKnowledge(ctx, knowledge); err != nil {\n\t\tlogger.Errorf(ctx, \"Failed to mark knowledge as failed after enqueue error: %v\", err)\n\t}\n}","sourceCodeStart":1121,"sourceCodeEnd":1157,"githubUrl":"https://github.com/Tencent/WeKnora/blob/988cbb03305e055d8ebb7d46d9ac6cc0803cd074/internal/application/service/knowledge_create.go#L1121-L1157","documentation":"Enqueueing the asynq manual:process task (default queue, 3 retries, 30m timeout) on the task broker failed after the payload was marshaled, meaning the async cleanup/re-index work was never scheduled; Redis/asynq connectivity or serialization issues are the usual causes.","triggerScenarios":"Thrown at internal/application/service/knowledge_create.go:1139 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Check asynq/Redis broker connectivity","Verify task type registration on the worker side","Retry enqueueing or fall back to synchronous processing"],"exampleFix":null,"handlingStrategy":"retry","validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"988cbb03305e055d8ebb7d46d9ac6cc0803cd074","analyzedAt":"2026-09-02T14:41:08.344Z","contentChangedAt":null,"schemaVersion":2},"datasetVersion":"2026-09-08T10:18:20.063Z"}