Custom exception handlers in FastAPI - Performance & Optimization

Performance: Custom exception handlers

MEDIUM IMPACT

This affects server response time and user experience by controlling how errors are processed and returned.

Handling errors in FastAPI to provide user-friendly messages

FastAPI

from fastapi import FastAPI
from fastapi.responses import JSONResponse
app = FastAPI()

@app.exception_handler(Exception)
async def generic_exception_handler(request, exc):
    # Minimal processing, quick response
    return JSONResponse(status_code=500, content={"detail": "Internal Server Error"})

Avoids blocking calls and heavy processing, returning error quickly to client.

📈 Performance GainResponse sent immediately, reducing INP and improving user experience

Handling errors in FastAPI to provide user-friendly messages

FastAPI

from fastapi import FastAPI
from fastapi.responses import JSONResponse
app = FastAPI()

@app.exception_handler(Exception)
async def generic_exception_handler(request, exc):
    # Heavy logging and complex processing here
    import time
    import asyncio
    await asyncio.sleep(2)  # Simulate slow processing asynchronously
    return JSONResponse(status_code=500, content={"detail": "Internal Server Error"})

Blocking or slow processing in exception handlers delays server response, increasing input latency.

📉 Performance CostBlocks response for 2 seconds, increasing INP and user wait time

Performance Comparison

Pattern	DOM Operations	Reflows	Paint Cost	Verdict
Heavy blocking exception handler	N/A	N/A	N/A	[X] Bad
Lightweight async exception handler	N/A	N/A	N/A	[OK] Good

Rendering Pipeline

When an exception occurs, FastAPI routes it to the custom handler which processes and returns a response. Slow handlers delay the server's response, impacting interaction responsiveness.

→Server Processing

→Response Generation

⚠️ BottleneckServer Processing due to heavy or blocking operations in handler

Core Web Vital Affected

INP

This affects server response time and user experience by controlling how errors are processed and returned.

Optimization Tips

1Avoid blocking or heavy processing in custom exception handlers.

2Use asynchronous code to keep handlers fast and non-blocking.

3Return error responses quickly to improve input responsiveness (INP).

Performance Quiz - 3 Questions

What is the main performance risk of a slow custom exception handler in FastAPI?

A It causes layout shifts on the page.

B It increases the number of DOM nodes on the client.

C It delays the server response, increasing input latency.

D It increases CSS selector complexity.

DevTools: Network

How to check: Open DevTools, go to Network tab, trigger an error, and observe the response time for error responses.

What to look for: Look for long response times on error requests indicating slow exception handling.