fatedier/frp · error

annotations size %d is larger than limit %d

Error message

annotations size %d is larger than limit %d

What it means

Error "annotations size %d is larger than limit %d" thrown in fatedier/frp.

Source

Thrown at pkg/config/v1/validation/proxy.go:269

		for _, msg := range validation.IsQualifiedName(strings.ToLower(k)) {
			errs = AppendError(errs, fmt.Errorf("annotation key %s is invalid: %s", k, msg))
		}
	}
	if err := ValidateAnnotationsSize(annotations); err != nil {
		errs = AppendError(errs, err)
	}
	return errs
}

const TotalAnnotationSizeLimitB int = 256 * (1 << 10) // 256 kB

func ValidateAnnotationsSize(annotations map[string]string) error {
	var totalSize int64
	for k, v := range annotations {
		totalSize += (int64)(len(k)) + (int64)(len(v))
	}
	if totalSize > (int64)(TotalAnnotationSizeLimitB) {
		return fmt.Errorf("annotations size %d is larger than limit %d", totalSize, TotalAnnotationSizeLimitB)
	}
	return nil
}

View on GitHub (pinned to 6c8a8d0a97)

Solutions

1. Remove or shorten annotations so the total size of all keys and values is not more than 256 kB.
2. Move large data out of annotations into the service behind the proxy.

When it happens

Trigger: Raised by ValidateAnnotations in pkg/config/v1/validation/proxy.go when the total serialized size of the annotations map exceeds the configured limit.

Common situations: Too many or too large annotations are attached to a proxy. Fix by removing unneeded annotations or shortening annotation values to stay under the limit.

AI-assisted analysis of fatedier/frp@6c8a8d0a97 (2026-08-15). Data as JSON: /api/errors/28bf9a542480abc7. Report an issue: GitHub.