Files
mtusi2026lab5/src/messenger/shared/entrypoints/errors.py
T

137 lines
5.2 KiB
Python

from collections.abc import Callable, Mapping
from fastapi import FastAPI, Request, Response, status
from fastapi.exceptions import RequestValidationError
from starlette.exceptions import HTTPException
from messenger.shared.application.errors import Unavailable
from messenger.shared.application.ports import Logger
from messenger.shared.domain.errors import DomainError
from messenger.shared.entrypoints.schemas import ErrorEnvelope
REQUEST_ID_HEADER = "X-Request-Id"
INSTANCE_ID_HEADER = "X-Instance-Id"
type ErrorCodes = Mapping[type[DomainError], tuple[str, int]]
type Challenge = Callable[[str], str]
MESSAGES = {
"invalid_request": "Запрос не соответствует контракту",
"unauthorized": "Аутентификация не предоставлена или недействительна",
"not_found": "Объект не найден",
"conflict": "Конфликт состояния",
"payload_too_large": "Тело запроса больше допустимого",
"unsupported_media_type": "Неподдерживаемый тип содержимого",
"rate_limited": "Слишком много запросов",
"unavailable": "Сервис временно недоступен",
"internal_error": "Внутренняя ошибка",
}
STATUS_CODES = {
status.HTTP_400_BAD_REQUEST: "invalid_request",
status.HTTP_401_UNAUTHORIZED: "unauthorized",
status.HTTP_404_NOT_FOUND: "not_found",
status.HTTP_409_CONFLICT: "conflict",
status.HTTP_413_CONTENT_TOO_LARGE: "payload_too_large",
status.HTTP_415_UNSUPPORTED_MEDIA_TYPE: "unsupported_media_type",
status.HTTP_422_UNPROCESSABLE_CONTENT: "invalid_request",
status.HTTP_429_TOO_MANY_REQUESTS: "rate_limited",
status.HTTP_503_SERVICE_UNAVAILABLE: "unavailable",
}
class Unauthenticated(Exception):
pass
def classify(error: DomainError, codes: ErrorCodes) -> tuple[str, int]:
for kind in type(error).__mro__:
known = codes.get(kind)
if known is not None:
return known
return "internal_error", status.HTTP_500_INTERNAL_SERVER_ERROR
def route_of(request: Request) -> str:
route = request.scope.get("route")
return getattr(route, "path", request.url.path)
def install(
app: FastAPI, logger: Logger, codes: ErrorCodes, challenge: Challenge, instance: str
) -> None:
def error_response(request: Request, code: str, detail: str, http_status: int) -> Response:
request_id = getattr(request.state, "request_id", "") or "unknown"
headers = {REQUEST_ID_HEADER: request_id, INSTANCE_ID_HEADER: instance}
if http_status == status.HTTP_401_UNAUTHORIZED:
headers["WWW-Authenticate"] = challenge(request.url.path)
return Response(
status_code=http_status,
content=ErrorEnvelope.of(code, detail, request_id).model_dump_json(),
media_type="application/json",
headers=headers,
)
@app.exception_handler(DomainError)
async def _domain(request: Request, exc: DomainError) -> Response:
code, http_status = classify(exc, codes)
return error_response(request, code, exc.detail, http_status)
@app.exception_handler(Unavailable)
async def _unavailable(request: Request, exc: Unavailable) -> Response:
logger.warning(
"dependency.unavailable",
route=route_of(request),
error=type(exc.__cause__ or exc).__name__,
request_id=getattr(request.state, "request_id", None),
)
return error_response(
request,
"unavailable",
MESSAGES["unavailable"],
status.HTTP_503_SERVICE_UNAVAILABLE,
)
@app.exception_handler(Unauthenticated)
async def _unauthenticated(request: Request, _exc: Unauthenticated) -> Response:
return error_response(
request,
"unauthorized",
MESSAGES["unauthorized"],
status.HTTP_401_UNAUTHORIZED,
)
@app.exception_handler(RequestValidationError)
async def _validation(request: Request, _exc: RequestValidationError) -> Response:
return error_response(
request,
"invalid_request",
MESSAGES["invalid_request"],
status.HTTP_400_BAD_REQUEST,
)
@app.exception_handler(HTTPException)
async def _http(request: Request, exc: HTTPException) -> Response:
http_status = exc.status_code
if http_status == status.HTTP_405_METHOD_NOT_ALLOWED:
http_status = status.HTTP_404_NOT_FOUND
code = STATUS_CODES.get(http_status, "internal_error")
return error_response(
request, code, MESSAGES.get(code, MESSAGES["internal_error"]), http_status
)
@app.exception_handler(Exception)
async def _unexpected(request: Request, exc: Exception) -> Response:
logger.error(
"request.failed",
route=route_of(request),
error=type(exc).__name__,
request_id=getattr(request.state, "request_id", None),
)
return error_response(
request,
"internal_error",
MESSAGES["internal_error"],
status.HTTP_500_INTERNAL_SERVER_ERROR,
)