AlistGo/alist · error

failed to convert path to remote path: %w

Error message

failed to convert path to remote path: %w

What it means

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

Source

Thrown at drivers/chunker/driver.go:114

	}
	for _, obj := range objs {
		if obj.GetName() == name {
			return obj, nil
		}
	}
	return nil, errs.ObjectNotFound
}

func (d *Chunker) Link(ctx context.Context, file model.Obj, args model.LinkArgs) (*model.Link, error) {
	obj := d.linkedObject(file)
	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)

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:114 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/c11726381ea83260. Report an issue: GitHub.