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