"""Какие ошибки драйвера означают «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