"""Любая ошибка → `{"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)