Tencent/WeKnora · error

execute request: %w

Error message

execute request: %w

What it means

doRequest wraps errors from c.httpClient.Do(req) as "execute request: %w". This is the transport layer failing: DNS resolution failure, TCP connect refused/timeout, TLS handshake error, or request cancellation via context. The client retries with backoff up to maxRetries before returning the last error.

Source

Thrown at internal/datasource/connector/yuque/client.go:78

	for attempt := 0; attempt <= maxRetries; attempt++ {
		reqURL := c.baseURL + path
		req, err := http.NewRequestWithContext(ctx, method, reqURL, nil)
		if err != nil {
			return fmt.Errorf("create request: %w", err)
		}
		req.Header.Set("X-Auth-Token", c.token)
		req.Header.Set("User-Agent", userAgent)
		req.Header.Set("Content-Type", "application/json; charset=utf-8")

		if attempt == 0 {
			logger.Infof(ctx, "[Yuque] %s %s", method, path)
		} else {
			logger.Infof(ctx, "[Yuque] %s %s (retry %d/%d)", method, path, attempt, maxRetries)
		}

		resp, err := c.httpClient.Do(req)
		if err != nil {
			lastErr = fmt.Errorf("execute request: %w", err)
			if attempt < maxRetries {
				if sErr := sleepCtx(ctx, backoff[attempt]); sErr != nil {
					return sErr
				}
				continue
			}
			return lastErr
		}

		body, readErr := io.ReadAll(resp.Body)
		resp.Body.Close()
		if readErr != nil {
			lastErr = fmt.Errorf("read response body: %w", readErr)
			if attempt < maxRetries {
				if sErr := sleepCtx(ctx, backoff[attempt]); sErr != nil {
					return sErr
				}
				continue

View on GitHub (pinned to 988cbb0330)

Solutions

1. Test outbound connectivity to the Yuque API from the host: curl -v https://www.yuque.com/api/v2.
2. Configure proxy environment variables (HTTPS_PROXY) if the network requires one, or fix firewall/egress rules.
3. Check DNS resolution inside the container/host (nslookup www.yuque.com).
4. If context canceled, extend the request timeout or investigate why the caller's context was canceled.
5. Retry later if it's a transient Yuque outage — the client already retries with backoff.

Example fix

// before (no proxy support, blocked network)
client := &http.Client{Timeout: 10 * time.Second}
// after
proxy := http.ProxyFromEnvironment
transport := &http.Transport{Proxy: proxy, TLSHandshakeTimeout: 10 * time.Second}
client := &http.Client{Transport: transport, Timeout: 30 * time.Second}

conn, err := net.DialTimeout("tcp", "www.yuque.com:443", 5*time.Second)
if err != nil {
    return fmt.Errorf("Yuque API unreachable: %v", err)
}
conn.Close()

func isTransportError(err error) bool {
    var ne net.Error
    return errors.As(err, &ne) || strings.Contains(err.Error(), "execute request:")
}

err := client.GetCurrentUser(ctx)
if err != nil && strings.HasPrefix(err.Error(), "execute request:") {
    if errors.Is(ctx.Err(), context.DeadlineExceeded) {
        // increase timeout and retry once
    }
    return err
}

When it happens

Trigger: Network unreachable from the host running the connector; Yuque API temporarily down or blocked by firewall/proxy; DNS not resolving www.yuque.com; context canceled (client disconnect, shutdown, deadline) mid-request.

Common situations: Deploying in an environment without outbound internet or behind a corporate proxy that isn't configured (missing HTTPS_PROXY); DNS failures in containers; transient Yuque outages; request deadlines too short.

Related errors

• read response body: %w
• fetch failed: %w
• create request: %w
• read poll response body: %w
• download zip: %w

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