File size: 4,919 Bytes
4a2ab42
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
4ae946d
 
 
4a2ab42
 
 
 
 
 
 
 
 
 
 
 
 
 
 
4ae946d
 
 
4a2ab42
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
4ae946d
 
 
4a2ab42
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
4ae946d
 
 
4a2ab42
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
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
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
"""
Error handling middleware for consistent API error responses
"""

import logging
import uuid
from datetime import datetime

from fastapi import HTTPException, Request
from fastapi.responses import JSONResponse
from pydantic import ValidationError
from starlette.middleware.base import BaseHTTPMiddleware

from app.models.error_responses import (
    APIErrorResponse,
    ErrorCodes,
    ErrorDetail,
    ValidationErrorResponse,
)

logger = logging.getLogger(__name__)


class StandardizedErrorMiddleware(BaseHTTPMiddleware):
    """Middleware to standardize error responses across all endpoints"""

    async def dispatch(self, request: Request, call_next):
        try:
            response = await call_next(request)
            return response
        except Exception as exc:
            return await self._handle_exception(request, exc)

    async def _handle_exception(self, request: Request, exc: Exception) -> JSONResponse:
        """Handle exceptions and return standardized error responses"""

        # Generate request ID for tracking
        request_id = str(uuid.uuid4())

        # Log the error
        logger.error(
            f"Request error: {request.method} {request.url.path}",
            extra={
                "request_id": request_id,
                "method": request.method,
                "path": request.url.path,
                "user_agent": request.headers.get("user-agent"),
                "error_type": type(exc).__name__,
                "error_message": str(exc),
            },
            exc_info=True,
        )

        # Handle different exception types
        if isinstance(exc, HTTPException):
            return self._handle_http_exception(exc, request_id, request.url.path)
        elif isinstance(exc, ValidationError):
            return self._handle_validation_error(exc, request_id, request.url.path)
        else:
            return self._handle_generic_error(exc, request_id, request.url.path)

    def _handle_http_exception(
        self, exc: HTTPException, request_id: str, path: str
    ) -> JSONResponse:
        """Handle FastAPI HTTPException"""

        # Map HTTP status codes to error codes
        error_code_map = {
            400: ErrorCodes.VALIDATION_ERROR,
            401: ErrorCodes.UNAUTHORIZED,
            403: ErrorCodes.FORBIDDEN,
            404: ErrorCodes.RESOURCE_NOT_FOUND,
            409: ErrorCodes.RESOURCE_ALREADY_EXISTS,
            422: ErrorCodes.VALIDATION_ERROR,
            429: ErrorCodes.RATE_LIMIT_EXCEEDED,
            500: ErrorCodes.INTERNAL_SERVER_ERROR,
            503: ErrorCodes.SERVICE_UNAVAILABLE,
        }

        error_code = error_code_map.get(
            exc.status_code, ErrorCodes.INTERNAL_SERVER_ERROR
        )

        error_detail = ErrorDetail(
            message=str(exc.detail),
            code=error_code,
        )

        error_response = APIErrorResponse(
            error=error_detail,
            timestamp=datetime.now(),
            request_id=request_id,
            path=path,
        )

        return JSONResponse(
            status_code=exc.status_code,
            content=error_response.dict(),
        )

    def _handle_validation_error(
        self, exc: ValidationError, request_id: str, path: str
    ) -> JSONResponse:
        """Handle Pydantic validation errors"""

        error_details = []
        for error in exc.errors():
            field_path = ".".join(str(loc) for loc in error["loc"])
            error_details.append(
                ErrorDetail(
                    field=field_path,
                    message=error["msg"],
                    code=ErrorCodes.VALIDATION_ERROR,
                    details={"validation_error": error},
                )
            )

        error_response = ValidationErrorResponse(
            errors=error_details,
            timestamp=datetime.now(),
            request_id=request_id,
            path=path,
        )

        return JSONResponse(
            status_code=422,
            content=error_response.dict(),
        )

    def _handle_generic_error(
        self, exc: Exception, request_id: str, path: str
    ) -> JSONResponse:
        """Handle unexpected errors"""

        # Don't expose internal error details in production
        error_message = "An unexpected error occurred"
        if __debug__:  # Only show details in debug mode
            error_message = str(exc)

        error_detail = ErrorDetail(
            message=error_message,
            code=ErrorCodes.INTERNAL_SERVER_ERROR,
            details={"exception_type": type(exc).__name__} if __debug__ else None,
        )

        error_response = APIErrorResponse(
            error=error_detail,
            timestamp=datetime.now(),
            request_id=request_id,
            path=path,
        )

        return JSONResponse(
            status_code=500,
            content=error_response.dict(),
        )