import logging from fastapi import FastAPI from fastapi.exceptions import RequestValidationError from fastapi.responses import JSONResponse from sqlalchemy.exc import SQLAlchemyError from starlette.exceptions import HTTPException as StarletteHTTPException from ..domain.errors import ( Conflict, DomainError, Invalid, NotFound, PayloadTooLarge, Unauthorized, Unavailable, UnsupportedMediaType, ) logger = logging.getLogger('app.error') CODE_BY_STATUS = { 400: 'invalid_request', 401: 'unauthorized', 404: 'not_found', 409: 'conflict', 413: 'payload_too_large', 415: 'unsupported_media_type', 429: 'rate_limited', 500: 'internal_error', 503: 'unavailable', } STATUS_BY_DOMAIN = { Invalid: 400, Unauthorized: 401, NotFound: 404, Conflict: 409, PayloadTooLarge: 413, UnsupportedMediaType: 415, Unavailable: 503, } def code_for(status: int) -> str: if status in CODE_BY_STATUS: return CODE_BY_STATUS[status] return 'invalid_request' if status < 500 else 'internal_error' def error_response(status: int, message: str, request_id: str, code: str = '') -> JSONResponse: return JSONResponse( status_code=status, content={'error': {'code': code or code_for(status), 'message': message, 'request_id': request_id}}, ) def _domain_status(error: DomainError) -> int: for kind, status in STATUS_BY_DOMAIN.items(): if isinstance(error, kind): return status return 500 def _describe(error: RequestValidationError) -> str: """Краткое указание на пол, без stack trace и внутреннего устройства""" for item in error.errors(): if item.get('type') == 'json_invalid': return 'тело запроса не является корректным JSON' location = '.'.join(str(part) for part in item.get('loc', ()) if part != 'body') return f'некорректное поле {location}' if location else 'некорректный запрос' return 'некорректный запрос' def request_id(request) -> str: return getattr(request.state, 'request_id', 'unknown') def install(app: FastAPI) -> None: @app.exception_handler(DomainError) async def _on_domain(request, error: DomainError) -> JSONResponse: return error_response(_domain_status(error), error.message, request_id(request)) @app.exception_handler(RequestValidationError) async def _on_validation(request, error: RequestValidationError) -> JSONResponse: return error_response(400, _describe(error), request_id(request)) @app.exception_handler(SQLAlchemyError) async def _on_database(request, error: SQLAlchemyError) -> JSONResponse: logger.warning('database error request_id=%s type=%s', request_id(request), type(error).__name__) return error_response(503, 'база данных недоступна', request_id(request)) @app.exception_handler(OSError) async def _on_storage_socket(request, error: OSError) -> JSONResponse: logger.warning('storage socket error request_id=%s type=%s', request_id(request), type(error).__name__) return error_response(503, 'обязательное хранилище недоступно', request_id(request)) @app.exception_handler(StarletteHTTPException) async def _on_http(request, error: StarletteHTTPException) -> JSONResponse: message = error.detail if isinstance(error.detail, str) and error.detail else 'ошибка запроса' response = error_response(error.status_code, message, request_id(request)) for name, value in (error.headers or {}).items(): response.headers[name] = value return response __all__ = ['code_for', 'error_response', 'install']