AlistGo/alist · error

failed to convert chunk path: %w

Error message

failed to convert chunk path: %w

What it means

Error "failed to convert chunk path: %w" thrown in AlistGo/alist.

Source

Thrown at drivers/chunker/driver.go:125

	if obj == nil || !obj.Chunked {
		remoteIndex := 0
		if obj != nil {
			remoteIndex = obj.MainRemoteIndex
		}
		actualPath, err := d.getActualPathForRemoteOnTarget(file.GetPath(), remoteIndex)
		if err != nil {
			return nil, fmt.Errorf("failed to convert path to remote path: %w", err)
		}
		link, _, err := op.Link(ctx, d.remoteTargets[remoteIndex].Storage, actualPath, args)
		return link, err
	}

	linkedParts := make([]linkedPart, 0, len(obj.Parts))
	baseClosers := utils.EmptyClosers()
	for _, part := range obj.Parts {
		actualPath, err := d.getActualChunkPath(obj.GetPath(), part.No, part.XactID, part.RemoteIndex)
		if err != nil {
			return nil, fmt.Errorf("failed to convert chunk path: %w", err)
		}
		link, _, err := op.Link(ctx, d.remoteTargets[part.RemoteIndex].Storage, actualPath, args)
		if err != nil {
			return nil, err
		}
		if link.MFile != nil {
			baseClosers.Add(link.MFile)
		}
		if link.RangeReadCloser != nil {
			baseClosers.Add(link.RangeReadCloser)
		}
		linkedParts = append(linkedParts, linkedPart{
			part: part,
			link: link,
		})
	}

	return &model.Link{

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/chunker/driver.go:125 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/c01201888eeb8e80. Report an issue: GitHub.