Tencent/WeKnora · error

failed to download file from URL: %w

Error message

failed to download file from URL: %w

What it means

Thrown in ProcessDocument when downloadFileFromURL fails to fetch the user-supplied FileURL (after the SSRF allowlist check passed). Fires on network errors, DNS failures, redirects, or the remote host returning a bad status; the document's ParseStatus is marked failed on the last retry.

Source

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

			knowledge.ParseStatus = "failed"
			knowledge.ErrorMessage = "File URL is not allowed for security reasons"
			knowledge.UpdatedAt = time.Now()
			s.repo.UpdateKnowledge(ctx, knowledge)
			return nil
		}

		resolvedFileName := payload.FileName
		resolvedFileType := payload.FileType
		contentBytes, err := downloadFileFromURL(ctx, payload.FileURL, &resolvedFileName, &resolvedFileType)
		if err != nil {
			logger.Errorf(ctx, "Failed to download file from URL: %s, error: %v", payload.FileURL, err)
			if isLastRetry {
				knowledge.ParseStatus = "failed"
				knowledge.ErrorMessage = err.Error()
				knowledge.UpdatedAt = time.Now()
				s.repo.UpdateKnowledge(ctx, knowledge)
			}
			return fmt.Errorf("failed to download file from URL: %w", err)
		}

		if resolvedFileType != "" && !isSupportedImportExtension(resolvedFileType) {
			logger.Errorf(ctx, "Unsupported file type resolved from file URL: %s", resolvedFileType)
			knowledge.ParseStatus = "failed"
			knowledge.ErrorMessage = fmt.Sprintf("unsupported file type: %s", resolvedFileType)
			knowledge.UpdatedAt = time.Now()
			s.repo.UpdateKnowledge(ctx, knowledge)
			return nil
		}

		if resolvedFileName != "" && knowledge.FileName == "" {
			knowledge.FileName = resolvedFileName
		}
		if resolvedFileType != "" && knowledge.FileType == "" {
			knowledge.FileType = resolvedFileType
			s.repo.UpdateKnowledge(ctx, knowledge)
		}

View on GitHub (pinned to 988cbb0330)

Solutions

1. Verify the source URL is reachable and serves the file
2. Check egress network/DNS from workers to the external host
3. Retry the parse task; asynq re-attempts before terminal failure
4. Inspect knowledge.ErrorMessage for the wrapped HTTP/network cause

When it happens

Trigger: Thrown at internal/application/service/knowledge_process.go:3355 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/6dbd2317e11fb22e. Report an issue: GitHub.