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
- 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)