AlistGo/alist · error

chunk upload failed with code %d

Error message

chunk upload failed with code %d

What it means

Error "chunk upload failed with code %d" thrown in AlistGo/alist.

Source

Thrown at drivers/bitqiu/driver.go:525

			"serialnumber": initData.SerialNumber,
			"hash":         md5sum,
			"len":          strconv.FormatInt(chunkLen, 10),
			"offset":       strconv.FormatInt(offset, 10),
			"user-agent":   d.userAgent(),
		}

		var chunkResp ChunkUploadResponse
		req := d.client.R().
			SetContext(ctx).
			SetHeaders(headers).
			SetBody(chunkBuf).
			SetResult(&chunkResp)

		if _, err := req.Post(initData.UploadURL); err != nil {
			return "", err
		}
		if chunkResp.ErrCode != 0 {
			return "", fmt.Errorf("chunk upload failed with code %d", chunkResp.ErrCode)
		}
		finishedFlag = chunkResp.FinishedFlag
		offset += chunkLen
		up(float64(offset) * 100 / float64(size))
	}

	if finishedFlag == "" {
		return "", fmt.Errorf("upload finished without server code")
	}
	return finishedFlag, nil
}

func (d *BitQiu) completeChunkUpload(ctx context.Context, initData UploadInitData, parentID, parentPath, name string, size int64, md5sum, serverCode string) (model.Obj, error) {
	form := map[string]string{
		"currentPage": "1",
		"limit":       "1",
		"userId":      strconv.FormatInt(initData.UserID, 10),
		"status":      "0",

View on GitHub (pinned to 843d9dc814)

Solutions

1. Inspect the underlying error details in the message, fix the indicated cause (credentials, network, or provider-side failure), and retry.

When it happens

Trigger: Thrown at drivers/bitqiu/driver.go:525 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of AlistGo/alist@843d9dc814 (2026-08-15). Data as JSON: /api/errors/8c5d615b28d1321d. Report an issue: GitHub.