✨ [feat][backend] Improve error logging

Author: tomy0000000

backend/kayman/main.py

@@ -11,6 +11,7 @@
     SPAStaticFiles,
     custom_generate_unique_id,
     lifespan,
+    setup_exception_handlers,
     setup_logger,
 )
 
@@ -54,3 +55,6 @@
 
 # Override the OpenAPI generation to customize operationId
 override_openapi(app)
+
+# Log unhandled exceptions through loguru and return a clean 500
+setup_exception_handlers(app)

backend/kayman/util.py

@@ -8,7 +8,7 @@
 from zoneinfo import ZoneInfo
 
 import simplejson
-from fastapi import FastAPI
+from fastapi import FastAPI, Request
 from fastapi.responses import JSONResponse
 from fastapi.routing import APIRoute
 from fastapi.staticfiles import StaticFiles
@@ -85,6 +85,21 @@ def custom_generate_unique_id(route: APIRoute) -> str:
     return f"{route.tags[0]}-{route.name}"
 
 
+def setup_exception_handlers(app: FastAPI) -> None:
+    @app.exception_handler(Exception)
+    async def unhandled_exception_handler(request: Request, exc: Exception) -> Response:
+        route = request.scope.get("route")
+        logger.bind(
+            method=request.method,
+            path=request.url.path,
+            route=getattr(route, "path", None),
+            client_host=request.client.host if request.client else None,
+        ).opt(exception=exc).error("Unhandled exception")
+        return KustomJSONResponse(
+            status_code=500, content={"detail": "Internal Server Error"}
+        )
+
+
 def handle_special_types(obj: Any) -> Any:
     print(f"handled type: {type(obj)}, {obj=}")
     if isinstance(obj, BaseModel):