chenhg5/cc-connect · error

get file: %w

Error message

get file: %w

What it means

Returned when bot.GetFile — the Telegram Bot API getFile call used to resolve a file_id into a downloadable path — fails. The error wraps the underlying Bot API/network error, meaning the platform could not obtain file metadata for the requested file.

Source

Thrown at platform/telegram/telegram.go:1353

	if err != nil {
		return err
	}
	_, err = bot.DeleteMessage(ctx, &tgbot.DeleteMessageParams{ChatID: h.chatID, MessageID: h.messageID})
	if err != nil {
		slog.Debug("telegram: delete preview message failed", "error", err)
	}
	return err
}

func (p *Platform) downloadFile(fileID string) ([]byte, error) {
	bot, err := p.connectedBot("download file")
	if err != nil {
		return nil, err
	}
	ctx := context.Background()
	f, err := bot.GetFile(ctx, &tgbot.GetFileParams{FileID: fileID})
	if err != nil {
		return nil, fmt.Errorf("get file: %w", err)
	}
	if f.FilePath == "" {
		return nil, fmt.Errorf("get file: empty file_path returned for file_id %s", fileID)
	}
	link := bot.FileDownloadLink(f)

	resp, err := p.httpClient.Get(link)
	if err != nil {
		return nil, fmt.Errorf("download file %s: %w", fileID, err)
	}
	defer resp.Body.Close()
	if resp.StatusCode != http.StatusOK {
		return nil, fmt.Errorf("download file %s: status %d", fileID, resp.StatusCode)
	}
	return io.ReadAll(resp.Body)
}

func (p *Platform) ReconstructReplyCtx(sessionKey string) (any, error) {

View on GitHub (pinned to 4000b2338a)

Solutions

1. Verify the file_id belongs to the same bot token performing the getFile call.
2. Check file size — bots can only download files up to 20 MB via getFile; use a local Bot API server for larger files.
3. Confirm network connectivity to api.telegram.org and retry transient errors.
4. Read the wrapped Bot API description ('wrong file identifier') to distinguish bad ID from size limits.

Example fix

// before
f, err := bot.GetFile(ctx, &tgbot.GetFileParams{FileID: fileID})
// after: validate before calling
if fileID == "" { return nil, errors.New("empty file_id") }
f, err := bot.GetFile(ctx, &tgbot.GetFileParams{FileID: fileID})

if fileID == "" { return errors.New("empty file_id") }

f, err := bot.GetFile(ctx, &tgbot.GetFileParams{FileID: fileID})
if err != nil {
    return nil, fmt.Errorf("get file: %w", err) // inspect wrapped Bot API reason
}

When it happens

Trigger: In the file download helper, bot.GetFile(ctx, &tgbot.GetFileParams{FileID: fileID}) returns a non-nil err (invalid file_id, file too large for bots, network failure).

Common situations: Passing a file_id from a different bot (file_ids are bot-scoped); file larger than the 20 MB bot download limit; expired media group reference; Telegram API outage.

Related errors

• get file: empty file_path returned for file_id %s
• sendVoice failed: %w
• sendAudio fallback failed: %w
• telegram: SendAudio: sendVoice: %w
• telegram: sendWithButtons: %w

AI-assisted analysis of chenhg5/cc-connect@4000b2338a (2026-09-06). Data as JSON: /api/errors/5a9bb0337bac7f1c. Report an issue: GitHub.