Spaces:
Sleeping
Sleeping
File size: 4,325 Bytes
f1f74fb | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 | from __future__ import annotations
import logging
from http import HTTPStatus
from typing import Any
from fastapi import FastAPI, Request, status
from fastapi.encoders import jsonable_encoder
from fastapi.exceptions import RequestValidationError
from starlette.exceptions import HTTPException as StarletteHTTPException
from starlette.responses import JSONResponse
from app.core.config import settings
from app.core.correlation import get_request_id_from_request
logger = logging.getLogger(__name__)
class AppException(Exception):
def __init__(
self,
*,
code: str,
message: str,
status_code: int = status.HTTP_400_BAD_REQUEST,
details: Any | None = None,
) -> None:
self.code = code
self.message = message
self.status_code = status_code
self.details = details
super().__init__(message)
class ResourceNotFound(AppException):
def __init__(self, resource: str, identifier: Any):
super().__init__(
code="not_found",
message=f"{resource} not found: {identifier}",
status_code=status.HTTP_404_NOT_FOUND,
)
# RFC 9110 name; Python 3.13+ exposes `UNPROCESSABLE_CONTENT` (422).
_VALIDATION_STATUS = getattr(HTTPStatus, "UNPROCESSABLE_CONTENT", HTTPStatus.UNPROCESSABLE_ENTITY)
def _error_payload(
*,
code: str,
message: str,
request_id: str | None,
details: Any | None = None,
) -> dict[str, Any]:
body: dict[str, Any] = {
"error": {
"code": code,
"message": message,
"request_id": request_id,
},
}
if details is not None:
body["details"] = jsonable_encoder(details)
return body
def register_exception_handlers(app: FastAPI) -> None:
@app.exception_handler(AppException)
async def app_exception_handler(request: Request, exc: AppException) -> JSONResponse:
rid = get_request_id_from_request(request)
return JSONResponse(
status_code=exc.status_code,
content=_error_payload(
code=exc.code,
message=exc.message,
request_id=rid,
details=exc.details,
),
headers={"X-Request-ID": rid} if rid else None,
)
@app.exception_handler(StarletteHTTPException)
async def http_exception_handler(
request: Request,
exc: StarletteHTTPException,
) -> JSONResponse:
rid = get_request_id_from_request(request)
detail = exc.detail
if isinstance(detail, str):
message = detail
elif isinstance(detail, list):
message = "Request failed"
else:
message = str(detail)
return JSONResponse(
status_code=exc.status_code,
content=_error_payload(
code="http_error",
message=message,
request_id=rid,
),
headers={"X-Request-ID": rid} if rid else None,
)
@app.exception_handler(RequestValidationError)
async def validation_exception_handler(
request: Request,
exc: RequestValidationError,
) -> JSONResponse:
rid = get_request_id_from_request(request)
return JSONResponse(
status_code=_VALIDATION_STATUS,
content=_error_payload(
code="validation_error",
message="Request validation failed",
request_id=rid,
details=exc.errors(),
),
headers={"X-Request-ID": rid} if rid else None,
)
@app.exception_handler(Exception)
async def unhandled_exception_handler(request: Request, exc: Exception) -> JSONResponse:
rid = get_request_id_from_request(request)
logger.exception("Unhandled error (request_id=%s)", rid)
if settings.app_env == "production":
message = "Internal server error"
else:
message = str(exc)
return JSONResponse(
status_code=status.HTTP_500_INTERNAL_SERVER_ERROR,
content=_error_payload(
code="internal_error",
message=message,
request_id=rid,
),
headers={"X-Request-ID": rid} if rid else None,
)
|