AlistGo/alist · error
wukong init multipart upload failed: code=
Error message
wukong init multipart upload failed: code=%d message=%s
What it means
Thrown by initMultipartUpload when POSTing phase=init to https://<host>/upload/v1/<storeURI> returns a code other than 2000. The TOS multipart session could not be created, so no UploadID exists and the whole multipart transfer aborts before any part is sent.
Solutions
- Re-run applyUploadInner to obtain fresh StoreURI, hosts, and Authorization, then init again
- Verify resp handles the empty-UploadID guard: if code is 2000 but UploadID is empty, that is a separate error — report upstream
- Retry against a different host from the candidates list
- Check that the file size actually requires multipart (totalParts > 0) before initializing
Defensive patterns
Strategy: retry
Validate before calling
if size <= 0 {
return errors.New("multipart init aborted: non-positive file size")
} Try / catch
uploadID, err := d.initMultipartUpload(ctx, host, storeURI, auth, storageUser)
if err != nil {
if strings.Contains(err.Error(), "auth") || strings.Contains(err.Error(), "expire") {
// fresh apply + init once
return d.restartMultipart(ctx, tempFile, size)
}
return err
} Prevention
- Init multipart immediately after applyUploadInner while auth is fresh
- Do not reuse StoreURI/auth across retries of the whole upload
- Handle the separate empty-UploadID error distinctly for clearer diagnostics
When it happens
Trigger: Authorization from ApplyUploadInner expired or not valid for multipart; storeURI malformed; selected upload host rejecting the init; X-Storage-U required but missing; upstream TOS outage.
Common situations: Upload started long after applyUploadInner (token TTL passed); best-host list stale; a previous upload's auth being reused after a driver retry.
Related errors
- wukong multipart finish failed: code=
- wukong multipart transfer failed: code=
- init upload failed
- multipart part crc32 mismatch: part=
- wukong init multipart upload returns empty uploadid
AI-assisted analysis of AlistGo/alist@843d9dc814 (2026-08-15).
Data as JSON: /api/errors/3bbe9408486d8894.
Report an issue: GitHub.
Appendix: source
Thrown at drivers/wukong/driver.go:658
SetHeader("Host", host).
SetHeader("Referer", webReferer).
SetHeader("Origin", "https://pan.wkbrowser.com").
SetHeader("Authorization", auth).
SetQueryParams(map[string]string{
"uploadmode": "part",
"phase": "init",
}).
SetResult(&resp)
if storageUser != "" {
req.SetHeader("X-Storage-U", storageUser)
}
uploadURL := fmt.Sprintf("https://%s/upload/v1/%s", host, storeURI)
_, err := req.Post(uploadURL)
if err != nil {
return "", err
}
if resp.Code != minUploadSubmitSuccess {
return "", fmt.Errorf("wukong init multipart upload failed: code=%d message=%s", resp.Code, resp.Message)
}
if resp.Data.UploadID == "" {
return "", errors.New("wukong init multipart upload returns empty uploadid")
}
return resp.Data.UploadID, nil
}
func (d *Wukong) uploadMultipartPart(ctx context.Context, host, storeURI, auth, storageUser, uploadID string, partNumber int, data []byte, crc32Hex string) (string, error) {
var resp tosUploadResp
req := base.NewRestyClient().R().
SetContext(ctx).
SetHeader("Host", host).
SetHeader("Referer", webReferer).
SetHeader("Origin", "https://pan.wkbrowser.com").
SetHeader("Authorization", auth).
SetHeader("Content-Type", "application/octet-stream").
SetHeader("Content-Crc32", crc32Hex).
SetHeader("Content-Length", strconv.Itoa(len(data))).View on GitHub (pinned to 843d9dc814)