---
title: "Thiết lập logging FastAPI và xử lý lỗi mà không mất traceback"
description: "FastAPI không in log info nào cho đến khi chúng tôi cấu hình logging, và chỉ uvicorn in traceback của lỗi 500. Đây là cách thiết lập, các error handler và LogBrew, đã thử trên FastAPI 0.165."
canonical: "https://logbrew.co/vi/guides/fastapi-logging"
last_updated: "2026-11-21"
---

# Thiết lập logging FastAPI và xử lý lỗi mà không mất traceback

FastAPI không in log `info` nào cho đến khi chúng tôi cấu hình logging, và chỉ uvicorn in traceback của lỗi 500. Đây là cách thiết lập, các error handler và LogBrew, đã thử trên FastAPI 0.165.

Đã thử nghiệm ngày 21 tháng 11, 2026 với Python 3.13.5, FastAPI 0.165.0, uvicorn 0.54.0, logbrew-sdk 0.1.29, logbrew-fastapi 0.1.14 và logbrew CLI 0.1.96

Tác giả [Furkan Erday](https://github.com/furkanerday). Furkan Erday là nhà sáng lập LogBrew. Anh xây dựng LogBrew bằng Claude Code và Codex mỗi ngày.

Canonical: https://logbrew.co/vi/guides/fastapi-logging

## FastAPI in gì khi chưa thiết lập, và LogBrew nhận được gì

| Sự kiện | In ra khi chưa thiết lập | Vấn đề hoặc log trong LogBrew |
| --- | --- | --- |
| `logger.debug()` | Bị bỏ | Bị bỏ ở `INFO` |
| `logger.info()` | Bị bỏ | Log `info` |
| `logger.warning()` | Chỉ thông điệp | Log `warning` |
| `ValueError` trong route | Traceback từ uvicorn | Vấn đề |
| Giá trị path không phải số, 422 | Chỉ dòng truy cập | Span, không có vấn đề |
| `HTTPException`, 404 | Chỉ dòng truy cập | Span, không có vấn đề |

6 sự kiện trong FastAPI 0.165.0 chạy dưới uvicorn 0.54.0, rồi cũng các sự kiện đó với `basicConfig()` và logbrew-fastapi 0.1.14.

## Ghi log từ ứng dụng FastAPI

### Xem FastAPI in gì khi chưa thiết lập

Ứng dụng của chúng tôi có 1 logger tên `taproom` và 3 route. Chúng tôi chạy nó bằng `uvicorn main:app`. uvicorn chỉ thiết lập logger của riêng nó, nên Python in `warning` trở lên dưới dạng văn bản thô và bỏ `debug` cùng `info`.

```bash
import logging

from fastapi import FastAPI, HTTPException

app = FastAPI()
logger = logging.getLogger("taproom")


@app.get("/taps/{tap}")
def pour(tap: str):
    logger.debug("keg pressure read")
    logger.info("tap %s opened", tap)
    logger.warning("keg below 10%")
    logger.error("keg empty")
    logger.critical("cooler offline")
    return {"tap": tap}


@app.get("/kegs/{keg_id}")
def keg(keg_id: int):
    raise ValueError(f"keg {keg_id} is empty")


@app.get("/missing")
def missing():
    raise HTTPException(status_code=404, detail="no such tap")
```

Kết quả

```text
keg below 10%
keg empty
cooler offline
INFO:     127.0.0.1:51421 - "GET /taps/ipa HTTP/1.1" 200 OK
```

### Gọi basicConfig() trước khi tạo ứng dụng

`logging.basicConfig()` cho root logger một cấp độ và một định dạng. Các dòng `taproom` giờ hiện cấp độ, và `info` xuất hiện. uvicorn giữ định dạng riêng của nó.

```bash
import logging
import os

from fastapi import FastAPI, HTTPException

logging.basicConfig(
    level=os.environ.get("LOG_LEVEL", "INFO"),
    format="%(levelname)s %(name)s %(message)s",
)

app = FastAPI()
logger = logging.getLogger("taproom")
```

Kết quả

```text
INFO taproom tap ipa opened
WARNING taproom keg below 10%
ERROR taproom keg empty
CRITICAL taproom cooler offline
INFO:     127.0.0.1:51428 - "GET /taps/ipa HTTP/1.1" 200 OK
```

### Đọc cấp độ từ biến môi trường

Lời gọi `basicConfig()` ở trên đọc `LOG_LEVEL`. Khởi động uvicorn với `LOG_LEVEL=DEBUG`, dòng `debug` sẽ xuất hiện mà không cần sửa code.

```bash
LOG_LEVEL=DEBUG uvicorn main:app
```

Kết quả

```text
DEBUG taproom keg pressure read
INFO taproom tap ipa opened
WARNING taproom keg below 10%
ERROR taproom keg empty
CRITICAL taproom cooler offline
INFO:     127.0.0.1:51442 - "GET /taps/ipa HTTP/1.1" 200 OK
```

## Xử lý lỗi trong FastAPI

### Xem một exception chưa xử lý in ra gì

Client nhận `Internal Server Error` với status 500. uvicorn in `Exception in ASGI application` và traceback. Đường dẫn `/kegs/abc` trả về 422 với một danh sách `detail`, còn `HTTPException` trả về `detail` của nó với 404. Cả 2 đều không in traceback. Chúng tôi cắt 27 frame của uvicorn, Starlette và FastAPI.

```bash
curl localhost:8000/kegs/7
curl localhost:8000/kegs/abc
curl localhost:8000/missing
```

Kết quả

```text
INFO:     127.0.0.1:51422 - "GET /kegs/7 HTTP/1.1" 500 Internal Server Error
ERROR:    Exception in ASGI application
Traceback (most recent call last):
  …
  File "main.py", line 21, in keg
    raise ValueError(f"keg {keg_id} is empty")
ValueError: keg 7 is empty
INFO:     127.0.0.1:51423 - "GET /kegs/abc HTTP/1.1" 422 Unprocessable Content
INFO:     127.0.0.1:51424 - "GET /missing HTTP/1.1" 404 Not Found
```

### Thêm exception handler cho Exception

Handler ghi log lỗi và trả về JSON của riêng bạn, và client nhận `{"error":"internal"}`. uvicorn vẫn in traceback, vì Starlette ném lại exception sau khi gửi phản hồi của bạn. Nên traceback xuất hiện 2 lần.

```bash
from fastapi import Request
from fastapi.responses import JSONResponse


@app.exception_handler(Exception)
async def on_error(request: Request, exc: Exception):
    logger.exception("request failed")
    return JSONResponse({"error": "internal"}, status_code=500)
```

Kết quả

```text
ERROR taproom request failed
Traceback (most recent call last):
  …
  File "main.py", line 34, in keg
    raise ValueError(f"keg {keg_id} is empty")
ValueError: keg 7 is empty
INFO:     127.0.0.1:51436 - "GET /kegs/7 HTTP/1.1" 500 Internal Server Error
ERROR:    Exception in ASGI application
Traceback (most recent call last):
  …
  File "main.py", line 34, in keg
    raise ValueError(f"keg {keg_id} is empty")
ValueError: keg 7 is empty
```

## Gửi log và lỗi FastAPI đến LogBrew

### Cài gói

`logbrew-fastapi` cũng cài `logbrew-sdk`. Dùng một khóa server của dự án LogBrew của bạn.

```bash
python3 -m pip install logbrew-sdk logbrew-fastapi
```

### Gọi init_logbrew() sau khi tạo ứng dụng

`init_logbrew()` ghi một span cho mỗi request và ghi mỗi lỗi chưa xử lý thành một vấn đề. `logbrew.logging_handler` gửi các bản ghi của logger của bạn. Chúng tôi gửi đến một server LogBrew cục bộ, nên bản của chúng tôi cũng truyền một `transport`.

```bash
import logging
import os

from fastapi import FastAPI, HTTPException
from logbrew_fastapi import init_logbrew

logging.basicConfig(
    level=os.environ.get("LOG_LEVEL", "INFO"),
    format="%(levelname)s %(name)s %(message)s",
)

app = FastAPI()
logbrew = init_logbrew(
    app, api_key=os.environ["LOGBREW_API_KEY"], service_name="taproom"
)
logger = logging.getLogger("taproom")
logger.addHandler(logbrew.logging_handler)
```

### Đọc lại vấn đề và log

Chúng tôi gửi lại 4 request đó và đọc dự án bằng một khóa đọc. Lỗi 500 thành 1 vấn đề mang tên template của route. 4 log của `/taps/ipa` có chung 1 trace ID. 422 và 404 không tạo vấn đề nào.

```bash
logbrew issues --since 1h
logbrew read logs --since 1h
```

Kết quả

```text
Issues (1)
- b100cd3d-f932-57c7-8f23-38067f1c87d7 unresolved error priority=medium GET /kegs/{keg_id} failed occurrences=1 users=unknown last_seen=2026-11-21T06:44:18.663Z service=taproom trace=6b642297fc5d4259b1f17f2bf83b1abb assignee=unassigned [unversioned / production]
Logs (4)
- error keg empty service=taproom trace=fcc0eaf7997f4e0796c0b76e0678b455 [unversioned / production]
- warning keg below 10% service=taproom trace=fcc0eaf7997f4e0796c0b76e0678b455 [unversioned / production]
- critical cooler offline service=taproom trace=fcc0eaf7997f4e0796c0b76e0678b455 [unversioned / production]
- info tap ipa opened service=taproom trace=fcc0eaf7997f4e0796c0b76e0678b455 [unversioned / production]
```

### Kiểm tra vấn đề giữ những gì

Vấn đề giữ loại exception, route và 21 stack frame, nhưng không giữ thông điệp. LogBrew ghi `Unhandled exception` vào chỗ đó.

```bash
logbrew issues --since 1h --json | jq '.[0].attributes | {
  message, exception,
  route: .metadata.routeTemplate,
  frames: (.stackFrames | length)
}'
```

Kết quả

```text
{
  "message": "Unhandled exception",
  "exception": {
    "mechanism": {
      "handled": false,
      "type": "fastapi.middleware"
    },
    "type": "ValueError"
  },
  "route": "/kegs/{keg_id}",
  "frames": 21
}
```

### Giữ thông điệp bằng exception handler của bạn

Với exception handler ở trên, LogBrew vẫn ghi vấn đề, và log `request failed` giữ thông điệp mà vấn đề bỏ qua.

```bash
logbrew read logs --since 1h --severity error \
  --search "request failed" --json | jq '.[0] | {
  message,
  exceptionName: .attributes.metadata.exceptionName,
  exceptionMessage: .attributes.metadata.exceptionMessage
}'
```

Kết quả

```text
{
  "message": "request failed",
  "exceptionName": "ValueError",
  "exceptionMessage": "keg 7 is empty"
}
```

## Kết quả khi chúng tôi thử nghiệm

Chúng tôi chạy 1 ứng dụng FastAPI 0.165.0 với uvicorn 0.54.0 trên Python 3.13.5, gọi từng route bằng curl và đọc output của server. Sau đó chúng tôi thêm logbrew-fastapi 0.1.14 và đọc những gì một server LogBrew cục bộ đã lưu.

uvicorn in traceback của mọi exception chưa xử lý, dù có handler hay không. Các lỗi mà FastAPI biến thành phản hồi, như 422 hoặc `HTTPException`, chỉ in dòng truy cập.

| Request | `status_code` | Traceback được in | Vấn đề trong LogBrew |
| --- | --- | --- | --- |
| `/kegs/7` | `500` | Có | Có |
| `/kegs/abc` | `422` | Không | Không |
| `/missing` | `404` | Không | Không |

## Cấp độ log FastAPI và output của uvicorn

Python có 5 cấp độ, `DEBUG`, `INFO`, `WARNING`, `ERROR` và `CRITICAL`. Khi chưa thiết lập, root logger bỏ mọi bản ghi thấp hơn `WARNING`.

uvicorn in dòng truy cập và lỗi theo định dạng riêng, và `basicConfig()` không đổi chúng. LogBrew giữ nguyên `warning`, `error` và `critical`, còn `DEBUG` và `INFO` được lưu thành `info`.

|  | Chưa thiết lập | `basicConfig()` | LogBrew |
| --- | --- | --- | --- |
| `logger.debug()` | Không | Với `LOG_LEVEL=DEBUG` | Không |
| `logger.info()` | Không | Có | `info` |
| `logger.warning()` | Có | Có | `warning` |
| `logger.error()` | Có | Có | `error` |
| `logger.critical()` | Có | Có | `critical` |

## LogBrew ghi lại những gì

`init_logbrew()` ghi 1 span cho mỗi request, mang tên template của route, ví dụ `GET /kegs/{keg_id}`. Một exception chưa xử lý thêm một vấn đề với loại exception, cơ chế `fastapi.middleware`, `handled: false` và các stack frame.

Log được ghi trong một request mang trace ID của request đó. Các request 422 và 404 tạo span không có lỗi.

- `init_logbrew()`
  - Vấn đề: `GET /kegs/{keg_id} failed`
  - `exception.type`: `ValueError`
  - `mechanism`: `fastapi.middleware`
  - `handled`: `false`
  - Stack frame: 21
- `logbrew.logging_handler`
  - Thông điệp: `request failed`
  - `exceptionName`: `ValueError`
  - `exceptionMessage`: `keg 7 is empty`

## Câu hỏi thường gặp

### Làm sao thiết lập logging trong FastAPI?

Gọi `logging.basicConfig()` 1 lần ở đầu `main.py`, rồi dùng `logging.getLogger()` trong từng module. Khi chưa thiết lập, Python bỏ `info` và `debug`.

### Làm sao xử lý mọi exception trong FastAPI?

Thêm `@app.exception_handler(Exception)` và trả về phản hồi của riêng bạn. Client nhận phản hồi của bạn, còn uvicorn vẫn in traceback.

### Vì sao FastAPI trả về 422?

Một giá trị trong path, query hoặc body không khớp kiểu. `/kegs/abc` không qua được kiểm tra `keg_id: int`, nên FastAPI trả về danh sách `detail` với status 422.

### Exception in ASGI application nghĩa là gì?

Một exception thoát khỏi route của bạn và không handler nào chặn nó. uvicorn ghi log nó kèm traceback, và client nhận `Internal Server Error` với status 500.

## Xem mọi lỗi FastAPI cùng route của nó

logbrew-fastapi ghi mỗi lỗi chưa xử lý thành một vấn đề mang tên template của route, và gửi log của bạn kèm trace của request tương ứng. Bắt đầu với gói miễn phí rộng rãi, không cần thẻ.

[Bắt đầu miễn phí](https://logbrew.co/vi)

## Nguồn

- [FastAPI docs, Install custom exception handlers](https://fastapi.tiangolo.com/tutorial/handling-errors/#install-custom-exception-handlers)
- [FastAPI docs, Use HTTPException](https://fastapi.tiangolo.com/tutorial/handling-errors/#use-httpexception)
- [fastapi/fastapi#14071](https://github.com/fastapi/fastapi/discussions/14071)

## Thêm hướng dẫn cho agent, Python, Node.js và React

- [Thêm máy chủ MCP vào Claude Code và Codex](https://logbrew.co/vi/guides/mcp-server-claude-code-codex)
- [Dùng AGENTS.md trong Claude Code và Codex](https://logbrew.co/vi/guides/agents-md)
- [Khắc phục lỗi Claude overloaded 529 và lỗi rate limit 429](https://logbrew.co/vi/guides/claude-overloaded-rate-limit-error)
- [Thiết lập Python logging với đúng mức log và bắt ngoại lệ kèm traceback](https://logbrew.co/vi/guides/python-logging)
- [Structured logging với định dạng log và mức log bạn tìm được theo trường](https://logbrew.co/vi/guides/structured-logging)
- [Thiết lập log cho Node.js với Pino hoặc Winston mà không mất lỗi nào](https://logbrew.co/vi/guides/node-logging)
- [Thiết lập logging Django và giữ traceback của mọi lỗi 500](https://logbrew.co/vi/guides/django-logging)
- [Thêm error boundary cho React và ghi log những lỗi mà nó bỏ lọt](https://logbrew.co/vi/guides/react-error-boundary)
- [Trace ID và span ID, giải mã từ một header traceparent thật](https://logbrew.co/vi/guides/trace-id)
- [Hướng dẫn về lỗi, log, trace, chỉ số và bản phát hành](https://logbrew.co/vi/guides)
