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