Billionmail/BillionMail · error

unable to get captcha after multiple attempts

Error message

unable to get captcha after multiple attempts

What it means

GetCode pulls a captcha from a pre-filled pool, refills it if needed, and as a last resort generates one directly. Only if every path — pool, refill, and direct generation — fails does it return 'unable to get captcha after multiple attempts'. Generation depends on an image backend (font/graphics library), so failures usually stem from that subsystem.

Source

Thrown at core/internal/service/rbac/validate_code.go:219

			// Asynchronously refresh if pool size is below threshold
			if poolSize < p.refreshRate {
				go p.RefreshPool(false)
			}

			return captchaID, b64s, nil
		}

		p.mutex.Unlock() // Ensure unlock
	}

	// Final attempt to generate a captcha directly as fallback
	id, b64s, _, err = p.captcha.Generate()
	if err == nil {
		return id, b64s, nil
	}

	return "", "", errors.New("unable to get captcha after multiple attempts")
}

// VerifyCode Verify captcha
func (p *CodePool) VerifyCode(id, answer string) bool {
	return p.store.Verify(id, answer, true)
}

// GetAnswer Get captcha answer (without consuming the captcha)
func (p *CodePool) GetAnswer(id string) string {
	return p.store.Get(id, false)
}

// GenerateCaptcha Generate a single captcha
func GenerateCaptcha() (id string, b64s string, answer string, err error) {
	return GetCodePool().captcha.Generate()
}

// GetCaptcha Get a captcha from the captcha pool

View on GitHub (pinned to fc36c76c05)

Solutions

1. Check the underlying Generate error — inspect pool/generator logs for the real cause (fonts, image library).
2. Install required font packages in the container (e.g. fontconfig/freetype fonts).
3. Verify the captcha library's image backend is supported in your base image (add graphics deps).
4. Increase pool size/refill rate if load exhausts the pre-filled pool.
5. Have callers return HTTP 503 and let the client retry the captcha request.

// ensure fonts/graphics deps exist at container start
if _, err := os.Stat("/usr/share/fonts"); err != nil {
    log.Fatal("font packages missing: captcha rendering unavailable")
}

id, b64s, err := service.GetCode(ctx)
if err != nil {
    if strings.Contains(err.Error(), "unable to get captcha after multiple attempts") {
        return ghttp.Res503("captcha temporarily unavailable, retry")
    }
    return err
}

When it happens

Trigger: All three attempts fail: pool empty, refill generation errors, and the direct p.captcha.Generate() fallback also returns an error — commonly when the image/font library can't render (missing fonts, image lib not available) or the generator is out of memory.

Common situations: Container images missing font packages required by go-captcha/freetype; repeated rapid calls exhausting the pool faster than refill; resource limits on small deployments.

Related errors

• Validation code ID and code cannot be empty
• Invalid validation code
• failed to get validate code: %w
• failed to connect: %w
• reconnect failed: %w

AI-assisted analysis of Billionmail/BillionMail@fc36c76c05 (2026-09-05). Data as JSON: /api/errors/8691e00891d38451. Report an issue: GitHub.