Files
mtusi2026lab3/src/infra/db/errors.py
T
ricoromaandClaude Opus 5.5 68edc66742 fix: answer 503 when PostgreSQL refuses connections with too many clients
SQLSTATE 53300 (too_many_connections) joins UNAVAILABLE_SQLSTATES, so a
refused pool connection gives 503 unavailable instead of 500. New fault
check fills max_connections through the failure stand hook and expects
503 in the contract format.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-11 07:26:36 +03:00

41 lines
2.2 KiB
Python
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
"""Какие ошибки драйвера означают «PostgreSQL недоступен» (→ 503).
Классы проверены на SQLAlchemy 2.1.1 и asyncpg 0.31 (задача 5.1 change
`postgres-storage`, решение 6 его design):
- Postgres остановлен — `ConnectionRefusedError`, его SQLAlchemy не
оборачивает; сервер не отвечает на подключение — `TimeoutError`; оба —
`OSError`, как и срок запроса из `get_db_session`;
- пул исчерпан — `sqlalchemy.exc.TimeoutError`;
- сработал `statement_timeout` — `DBAPIError` с SQLSTATE `57014`;
- соединение оборвано (рестарт, `pg_terminate_backend`) — `DBAPIError`
с `connection_invalidated`;
- отказ в подключении сверх `max_connections` — `TooManyConnectionsError`
asyncpg, `DBAPIError` с SQLSTATE `53300` (класс 53: нехватка ресурсов),
без `connection_invalidated`. Найден серией `pool` change
`scaling-bench`; остальные коды класса 53 (диск, память) сюда не
входят: их не воспроизводили.
Остальные `DBAPIError` (нарушение ограничения, синтаксис) — дефект
сервиса, им положен 500, а не 503.
"""
from sqlalchemy import exc as sa_exc
# класс 08 — ошибки соединения; 53300 — too_many_connections (отказ в
# подключении сверх max_connections); 57014 — query_canceled
# (statement_timeout); 57P01–57P03 — сервер останавливается или ещё не
# принимает подключения
UNAVAILABLE_SQLSTATES = ("08", "53300", "57014", "57P01", "57P02", "57P03")
def is_db_unavailable(error: BaseException) -> bool:
if isinstance(error, OSError | sa_exc.TimeoutError):
return True
if isinstance(error, sa_exc.DBAPIError):
if error.connection_invalidated:
return True
sqlstate = getattr(error.orig, "sqlstate", None) or ""
return sqlstate.startswith(UNAVAILABLE_SQLSTATES)
return False