Files
mtusi2026lab3/src/api/handlers.py
T

122 lines
4.1 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.
"""Любая ошибка → `{"error": {"code", "message", "request_id"}}`.
- `AppError`: статус, `code` и `WWW-Authenticate` (у 401) берутся из
класса исключения.
- Ошибки валидации FastAPI → 400 `invalid_request` (422 не отдаётся).
- 404 неизвестного пути и 405 → формат контракта.
- Непредвиденное исключение → 500 без деталей. Traceback пишет uvicorn:
Starlette после ответа бросает исключение дальше.
"""
from uuid import uuid4
from fastapi import FastAPI, Request
from fastapi.exceptions import RequestValidationError
from fastapi.responses import JSONResponse
from starlette.exceptions import HTTPException as StarletteHTTPException
from starlette.requests import HTTPConnection
from src.api.schemas import ErrorBody, ErrorResponse
from src.constants import INSTANCE_ID_HEADER, REQUEST_ID_HEADER
from src.errors import AppError
_HTTP_ERRORS: dict[int, tuple[str, str]] = {
404: ("not_found", "Not found"),
405: ("invalid_request", "Method not allowed"),
}
def request_id_of(conn: HTTPConnection) -> str:
"""Id запроса от RequestIdMiddleware; запасной — если ошибка случилась раньше."""
return getattr(conn.state, "request_id", None) or uuid4().hex
def error_response(
conn: HTTPConnection,
*,
status_code: int,
code: str,
message: str,
headers: dict[str, str] | None = None,
) -> JSONResponse:
request_id = request_id_of(conn)
body = ErrorResponse(
error=ErrorBody(code=code, message=message, request_id=request_id),
)
return JSONResponse(
status_code=status_code,
content=body.model_dump(),
# заголовки ставит и middleware; здесь они нужны ответам 500,
# которые формируются снаружи всех middleware
headers={
**(headers or {}),
REQUEST_ID_HEADER: request_id,
INSTANCE_ID_HEADER: conn.app.state.settings.instance_id,
},
)
def app_error_response(conn: HTTPConnection, exc: AppError) -> JSONResponse:
"""Ответ на доменную ошибку; общий для ручек и AuthenticationMiddleware."""
return error_response(
conn,
status_code=exc.status_code,
code=exc.code,
message=str(exc),
headers={"WWW-Authenticate": exc.challenge} if exc.challenge else None,
)
async def on_app_error(request: Request, exc: AppError) -> JSONResponse:
return app_error_response(request, exc)
async def on_validation_error(
request: Request,
exc: RequestValidationError,
) -> JSONResponse:
# первая ошибка: где и что не так; входное значение в ответ не попадает
errors = exc.errors()
first = errors[0] if errors else {}
location = ".".join(str(part) for part in first.get("loc", ()))
reason = first.get("msg", "Invalid request")
return error_response(
request,
status_code=400,
code="invalid_request",
message=f"{location}: {reason}" if location else reason,
)
async def on_http_error(
request: Request,
exc: StarletteHTTPException,
) -> JSONResponse:
code, message = _HTTP_ERRORS.get(
exc.status_code,
("invalid_request", "Invalid request"),
)
return error_response(
request,
status_code=exc.status_code,
code=code,
message=message,
headers=exc.headers,
)
async def on_unexpected_error(request: Request, _exc: Exception) -> JSONResponse:
return error_response(
request,
status_code=500,
code="internal_error",
message="Internal server error",
)
def install(app: FastAPI) -> None:
app.add_exception_handler(AppError, on_app_error)
app.add_exception_handler(RequestValidationError, on_validation_error)
app.add_exception_handler(StarletteHTTPException, on_http_error)
app.add_exception_handler(Exception, on_unexpected_error)