Tencent/WeKnora · error

MinerU Cloud task timed out after %d polls

Error message

MinerU Cloud task timed out after %d polls

What it means

pollBatchResult exhausted its poll budget while the MinerU Cloud extraction task never reached done/failed — the cloud job is stuck or extremely slow, so the wait is abandoned with the poll count reported.

Source

Thrown at internal/infrastructure/docparser/mineru_cloud_converter.go:261

		state := strings.ToLower(item.State)

		if pollCount == 1 || pollCount%10 == 0 || state == "done" || state == "failed" {
			logger.Infof(context.Background(), "[MinerUCloud] poll #%d: file=%s state=%s pages=%d/%d",
				pollCount, item.FileName, state, item.Progress.ExtractedPages, item.Progress.TotalPages)
		}

		if state == "failed" {
			return "", nil, fmt.Errorf("MinerU Cloud task failed: %s", item.ErrMsg)
		}

		if state == "done" {
			return c.extractDoneResult(ctx, &item)
		}

		sleepCtx(ctx, defaultPollInterval)
	}

	return "", nil, fmt.Errorf("MinerU Cloud task timed out after %d polls", pollCount)
}

func (c *MinerUCloudReader) fetchBatchStatus(ctx context.Context, batchID string, headers map[string]string) ([]extractResultItem, error) {
	url := fmt.Sprintf("%s/extract-results/batch/%s", c.baseURL, batchID)
	httpReq, err := http.NewRequestWithContext(ctx, http.MethodGet, url, nil)
	if err != nil {
		return nil, err
	}
	for k, v := range headers {
		httpReq.Header.Set(k, v)
	}

	client := utils.NewSSRFSafeHTTPClient(utils.SSRFSafeHTTPClientConfig{Timeout: 30 * time.Second, MaxRedirects: 5})
	resp, err := client.Do(httpReq)
	if err != nil {
		return nil, err
	}
	defer resp.Body.Close()

View on GitHub (pinned to 988cbb0330)

Solutions

1. Retry the whole Read; the job may complete later
2. Increase the poll timeout for very large documents
3. Check MinerU Cloud service status if timeouts recur

When it happens

Trigger: Thrown at internal/infrastructure/docparser/mineru_cloud_converter.go:261 when the library encounters an invalid state.

Common situations: See trigger scenarios.

Understand the failure class

• Timeouts: ETIMEDOUT, deadlines, and hung requests — what actually expires when a request times out.

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