BerriAI/litellm · error · BadGatewayError

BadGatewayError: {exception_provider} - {message}

Error message

BadGatewayError: {exception_provider} - {message}

What it means

Error "BadGatewayError: {exception_provider} - {message}" thrown in BerriAI/litellm.

Source

Thrown at litellm/litellm_core_utils/exception_mapping_utils.py:457

            )
        elif original_exception.status_code == 429:
            raise RateLimitError(
                message=f"RateLimitError: {exception_provider} - {message}",
                model=model,
                llm_provider=custom_llm_provider,
                response=getattr(original_exception, "response", None),
                litellm_debug_info=extra_information,
            )
        elif original_exception.status_code == 500:
            raise InternalServerError(
                message=f"InternalServerError: {exception_provider} - {message}",
                model=model,
                llm_provider=custom_llm_provider,
                response=getattr(original_exception, "response", None),
                litellm_debug_info=extra_information,
            )
        elif original_exception.status_code == 502:
            raise BadGatewayError(
                message=f"BadGatewayError: {exception_provider} - {message}",
                model=model,
                llm_provider=custom_llm_provider,
                response=getattr(original_exception, "response", None),
                litellm_debug_info=extra_information,
            )
        elif original_exception.status_code == 503:
            raise ServiceUnavailableError(
                message=f"ServiceUnavailableError: {exception_provider} - {message}",
                model=model,
                llm_provider=custom_llm_provider,
                response=getattr(original_exception, "response", None),
                litellm_debug_info=extra_information,
            )
        elif original_exception.status_code == 504:  # gateway timeout error
            raise Timeout(
                message=f"Timeout Error: {exception_provider} - {message}",
                model=model,

View on GitHub (pinned to 6c2dcb801b)

Solutions

1. Provider gateway error; retry with backoff and check provider status.

When it happens

Trigger: Thrown at litellm/litellm_core_utils/exception_mapping_utils.py:457 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of BerriAI/litellm@6c2dcb801b (2026-08-15). Data as JSON: /api/errors/9a52c5ee23a36bea. Report an issue: GitHub.