AlistGo/alist · error

the remote storage driver need to be enhanced to support s3

Error message

the remote storage driver need to be enhanced to support s3

What it means

GetObject found the target file's Link lacking every supported content source (no RangeReadCloser, no MFile, no URL), so the S3 gateway cannot stream its body. It signals the underlying storage driver does not yet provide downloadable content compatible with S3 serving.

Solutions

  1. Check the storage configuration and the provider's service status, fix the indicated cause, and retry the operation.
Defensive patterns

Strategy: type-guard

When it happens

Trigger: Thrown at server/s3/backend.go:175 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/86c7ce48fd8238cf. Report an issue: GitHub.

Appendix: source

Thrown at server/s3/backend.go:175

	}

	if node.IsDir() {
		return nil, gofakes3.KeyNotFound(objectName)
	}

	link, file, err := fs.Link(ctx, fp, model.LinkArgs{})
	if err != nil {
		return nil, err
	}

	size := file.GetSize()
	rnge, err := rangeRequest.Range(size)
	if err != nil {
		return nil, err
	}

	if link.RangeReadCloser == nil && link.MFile == nil && len(link.URL) == 0 {
		return nil, fmt.Errorf("the remote storage driver need to be enhanced to support s3")
	}

	var rdr io.ReadCloser
	length := int64(-1)
	start := int64(0)
	if rnge != nil {
		start, length = rnge.Start, rnge.Length
	}
	// 参考 server/common/proxy.go
	if link.MFile != nil {
		_, err := link.MFile.Seek(start, io.SeekStart)
		if err != nil {
			return nil, err
		}
		rdr = link.MFile
	} else {
		remoteFileSize := file.GetSize()
		if length >= 0 && start+length >= remoteFileSize {

View on GitHub (pinned to 843d9dc814)