Ошибки HTTP-клиента в Python: причины, диагностика, исправление

Как проверить статус без исключений?

Когда не требуется прерывание потока, можно просто проверять свойство response.ok или сравнивать status_code.

resp = requests.get('https://httpbin.org/status/403')
if not resp.ok:
    print(f'Ошибка доступа (код {resp.status_code})')
    # дополнительная логика
else:
    print('Успех')

Python traceback using (трассировка ошибок в python)

Как обработать конкретную ошибку (404, 401)?

Иногда нужно различное поведение для разных кодов. Проверка статуса вручную даёт полный контроль.

resp = requests.get('https://httpbin.org/status/401')
if resp.status_code == 401:
    print('Требуется авторизация. Обновляем токен...')
elif resp.status_code == 404:
    print('Ресурс не найден. Возможно, удалён.')
elif 400 <= resp.status_code < 500:
    print(f'Другая клиентская ошибка: {resp.status_code}')
else:
    print('OK')

Python pip not found (ошибка 'pip not found' в python)

handlers = {
    401: lambda r: 'Обновление токена',
    404: lambda r: 'Поиск альтернативы',
    429: lambda r: 'Пауза на 10 секунд'
}
resp = requests.get('...')
handler = handlers.get(resp.status_code)
if handler:
    print(handler(resp))

Как автоматически повторить запрос при ошибке HTTP-клиента?

Для временных ошибок (например, 429 Too Many Requests) можно использовать адаптер с повторными попытками из requests.adapters.

from requests.adapters import HTTPAdapter
from requests.packages.urllib3.util.retry import Retry

session = requests.Session()
retries = Retry(total=3, backoff_factor=1, status_forcelist=[429, 500, 502, 503, 504])
session.mount('https://', HTTPAdapter(max_retries=retries))

try:
    response = session.get('https://httpbin.org/status/429')
    response.raise_for_status()
except requests.exceptions.RetryError:
    print('Все попытки исчерпаны.')
except requests.exceptions.HTTPError as e:
    print(f'Ошибка после повторных попыток: {e}')

File not found python (ошибка filenotfounderror в python)

Как обрабатывать ошибки в асинхронных запросах (aiohttp)?

В aiohttp клиентские ошибки также являются исключениями, но перехватываются через try-except внутри корутины.

import aiohttp
import asyncio

async def fetch():
    async with aiohttp.ClientSession() as session:
        try:
            async with session.get('https://httpbin.org/status/418') as resp:
                resp.raise_for_status()
                data = await resp.text()
        except aiohttp.ClientResponseError as e:
            print(f'Ошибка {e.status}: {e.message}')
        except aiohttp.ClientError as e:
            print(f'Общая ошибка клиента: {e}')

asyncio.run(fetch())

Python modulenotfounderror no module named (ошибка modulenotfounderror)

async with session.get(...) as resp:
    body = await resp.text()
    resp.raise_for_status()  # если ошибка, тело уже сохранено

Как логировать все клиентские ошибки централизованно?

Использование декоратора для всех запросов.

import requests
import logging

logging.basicConfig(level=logging.INFO)

def log_client_error(func):
    def wrapper(*args, **kwargs):
        try:
            resp = func(*args, **kwargs)
            resp.raise_for_status()
            return resp
        except requests.exceptions.HTTPError as e:
            logging.error(f'HTTP {resp.status_code}: {e}')
            raise
    return wrapper

@log_client_error
def fetch_data(url):
    return requests.get(url)

fetch_data('https://httpbin.org/status/400')

ошибка компиляции python (ошибка компиляции (синтаксиса) в python)

ERROR:root:HTTP 400: 400 Client Error: BAD REQUEST for url: https://httpbin.org/status/400

Python traceback (трассировка стека в python)

Как обрабатывать ошибки HTTPX с собственным исключением?

Библиотека httpx предоставляет httpx.HTTPStatusError, похожее на requests.

import httpx

try:
    with httpx.Client() as client:
        response = client.get('https://httpbin.org/status/410')
        response.raise_for_status()
except httpx.HTTPStatusError as e:
    print(f'Код: {e.response.status_code}, сообщение: {e.response.text}')
except httpx.RequestError as e:
    print(f'Ошибка соединения: {e}')

Script not found python (ошибка 'script not found')

Код: 410, сообщение: ...

List out of range python (ошибка indexerror: list index out of range в python)

Как извлечь тело ошибки и код из ответа без исключения?

Иногда нужно прочитать JSON с описанием ошибки, даже если код 4xx.

resp = requests.get('https://httpbin.org/status/422')
if resp.status_code != 200:
    try:
        error_info = resp.json()
        print(f'Причина: {error_info.get("message", "-")}')
    except ValueError:
        print('Тело не в JSON:', resp.text[:100])

Python codec can t decode byte (ошибка декодирования байтов в python)

Как пропускать определённые коды ошибок (например, 404) при массовых запросах?

Использовать фильтрацию перед raise_for_status().

import requests

def safe_get(url, ignore_codes={404}):
    resp = requests.get(url)
    if resp.status_code in ignore_codes:
        print(f'Пропуск {resp.status_code}')
        return None
    resp.raise_for_status()
    return resp

safe_get('https://httpbin.org/status/404')  # None без исключений