AlistGo/alist · error

driver not init

Error message

driver not init

What it means

Returned by aliyundrive_open's limiter.wait when its receiver l is nil: the per-user limiter was never registered (driver not initialized before an operation ran), so rate limiting cannot be applied and the call is refused rather than panicking.

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 drivers/aliyundrive_open/limiter.go:66 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/c67e991ea612b4f3. Report an issue: GitHub.

Appendix: source

Thrown at drivers/aliyundrive_open/limiter.go:66

		}
	}()
	if lim, ok := limiters[userID]; ok {
		lim.usedBy++
		return lim
	}
	lim := &limiter{
		usedBy: 1,
		list:   rate.NewLimiter(rate.Limit(listRateLimit), 1),
		link:   rate.NewLimiter(rate.Limit(linkRateLimit), 1),
		other:  rate.NewLimiter(rate.Limit(otherRateLimit), 1),
	}
	limiters[userID] = lim
	return lim
}

func (l *limiter) wait(ctx context.Context, typ limiterType) error {
	if l == nil {
		return fmt.Errorf("driver not init")
	}
	switch typ {
	case limiterList:
		return l.list.Wait(ctx)
	case limiterLink:
		return l.link.Wait(ctx)
	case limiterOther:
		return l.other.Wait(ctx)
	default:
		return fmt.Errorf("unknown limiter type")
	}
}

func (l *limiter) free() {
	if l == nil {
		return
	}
	limitersLock.Lock()

View on GitHub (pinned to 843d9dc814)