AlistGo/alist · error

need img validate code: <img src="data:image/png;base64

Error message

need img validate code: <img src="data:image/png;base64,%s"/>

What it means

Raised in Cloud189PC.initLoginParam when a captcha is required but OCR is unavailable or failed: the captcha PNG is embedded base64 in this error message and surfaced to the frontend so the user can solve it manually. Login cannot proceed without the code.

Solutions

  1. Complete the required verification (captcha/SMS/image code) as prompted, then retry the login or operation.
Defensive patterns

Strategy: fallback

When it happens

Trigger: Thrown at drivers/189pc/utils.go:453 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/7115b4e8fdf0e857. Report an issue: GitHub.

Appendix: source

Thrown at drivers/189pc/utils.go:453

	if err != nil {
		return fmt.Errorf("failed to obtain verification code")
	}
	if imgRes.Size() > 20 {
		if setting.GetStr(conf.OcrApi) != "" && !y.NoUseOcr {
			vRes, err := base.RestyClient.R().
				SetMultipartField("image", "validateCode.png", "image/png", bytes.NewReader(imgRes.Body())).
				Post(setting.GetStr(conf.OcrApi))
			if err != nil {
				return err
			}
			if jsoniter.Get(vRes.Body(), "status").ToInt() == 200 {
				y.VCode = jsoniter.Get(vRes.Body(), "result").ToString()
				return nil
			}
		}

		// 返回验证码图片给前端
		return fmt.Errorf(`need img validate code: <img src="data:image/png;base64,%s"/>`, base64.StdEncoding.EncodeToString(imgRes.Body()))
	}
	return nil
}

// 刷新会话
func (y *Cloud189PC) refreshSession() (err error) {
	if y.ref != nil {
		return y.ref.refreshSession()
	}
	var erron RespErr
	var userSessionResp UserSessionResp
	_, err = y.client.R().
		SetResult(&userSessionResp).SetError(&erron).
		SetQueryParams(clientSuffix()).
		SetQueryParams(map[string]string{
			"appId":       APP_ID,
			"accessToken": y.tokenInfo.AccessToken,
		}).

View on GitHub (pinned to 843d9dc814)