Troubleshooting
Common integration and runtime issues with diagnostic guidance.
Flags always return defaults
- Confirm provider initialization is mounted once.
- Validate client key, environment value, and relay URL.
- Verify flag exists and is configured for current environment.
Readiness never true
- Check relay availability from runtime network.
- Inspect auth errors and CORS configuration.
- Ensure bootstrap cache is not malformed.
Unexpected rollout assignment
- Use stable context keys between sessions.
- Keep bucket attributes consistently formatted.
- Avoid per-render random context object values.
Intermittent network errors
- Use retry/backoff defaults in SDK options.
- Reduce polling interval if relay is under stress.
- Instrument fallback reason rates for early detection.