---
title: "配置 Django 日志保留每个 500 错误的回溯信息"
description: "在 DEBUG = False 且没有 LOGGING 时，Django 遇到 500 错误不会打印任何回溯。这里有 LOGGING 配置、日志级别，以及把错误发到 LogBrew 的方法，全部在 Django 6.1 上实测。"
canonical: "https://logbrew.co/zh-Hans/guides/django-logging"
last_updated: "2026-11-21"
---

# 配置 Django 日志保留每个 500 错误的回溯信息

在 `DEBUG = False` 且没有 `LOGGING` 时，Django 遇到 500 错误不会打印任何回溯。这里有 `LOGGING` 配置、日志级别，以及把错误发到 LogBrew 的方法，全部在 Django 6.1 上实测。

2026年11月21日 用 Python 3.13.5、Django 6.1.3、logbrew-sdk 0.1.29、logbrew-django 0.1.12和logbrew CLI 0.1.96 实测

作者 [Furkan Erday](https://github.com/furkanerday). Furkan Erday 是 LogBrew 的创始人，每天用 Claude Code 和 Codex 开发 LogBrew。

Canonical: https://logbrew.co/zh-Hans/guides/django-logging

## 没有 `LOGGING` 时 Django 打印什么，LogBrew 又收到什么

| 事件 | 没有 `LOGGING` 时的打印 | LogBrew 中的问题或日志 |
| --- | --- | --- |
| `logger.debug()` | 被丢弃 | 在 `INFO` 级别被丢弃 |
| `logger.info()` | 被丢弃 | `info` 日志 |
| `logger.warning()` | 只有消息 | `warning` 日志 |
| `logger.exception()` | 消息和回溯 | 带异常的日志 |
| 视图里的 `ValueError` | 只有访问日志行 | 问题 |
| `Http404` | 只有访问日志行 | Span，没有问题 |

在 `DEBUG = False` 的 Django 6.1.3 上触发 6 个事件，再用我们的 `LOGGING` 字典和 logbrew-django 0.1.12 触发同样的事件。

## 配置 Django 日志

### 看看没有 LOGGING 时 Django 打印什么

我们的应用有 1 个名为 `taproom` 的记录器和 4 个视图。在 `DEBUG = False` 且没有 `LOGGING` 配置时，Django 把 `warning` 及以上级别打印成纯文本，丢弃了 `debug` 和 `info`。500 错误只打印了访问日志行，没有回溯。

```bash
import logging

from django.http import Http404, JsonResponse
from django.urls import path

logger = logging.getLogger("taproom")


class CardDeclined(Exception):
    pass


def pour(request, tap):
    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 JsonResponse({"tap": tap})


def keg(request, keg_id):
    raise ValueError(f"keg {keg_id} is empty")


def missing(request):
    raise Http404("no such tap")


def pay(request):
    try:
        raise CardDeclined("card declined")
    except CardDeclined:
        logger.exception("payment failed")
        return JsonResponse({"error": "card declined"}, status=402)


urlpatterns = [
    path("taps/<str:tap>/", pour),
    path("kegs/<int:keg_id>/", keg),
    path("missing/", missing),
    path("pay/", pay),
]
```

输出

```text
keg below 10%
keg empty
cooler offline
[21/Nov/2026 00:41:16] "GET /taps/ipa/ HTTP/1.1" 200 14
[21/Nov/2026 00:41:16] "GET /kegs/7/ HTTP/1.1" 500 145
[21/Nov/2026 00:41:16] "GET /missing/ HTTP/1.1" 404 179
payment failed
Traceback (most recent call last):
  File "urls.py", line 32, in pay
    raise CardDeclined("card declined")
urls.CardDeclined: card declined
[21/Nov/2026 00:41:16] "GET /pay/ HTTP/1.1" 402 26
```

### 在 settings.py 里加入 LOGGING 字典

把根记录器输出到控制台，并让 `disable_existing_loggers` 保持 `False`，这样 Django 自带的记录器会继续工作。现在 `django.request` 以 `ERROR` 级别打印了带回溯的 500 错误，以 `WARNING` 级别打印了 404。

```bash
LOGGING = {
    "version": 1,
    "disable_existing_loggers": False,
    "formatters": {
        "plain": {"format": "{levelname} {name} {message}", "style": "{"},
    },
    "handlers": {
        "console": {"class": "logging.StreamHandler", "formatter": "plain"},
    },
    "root": {
        "handlers": ["console"],
        "level": os.environ.get("LOG_LEVEL", "INFO"),
    },
}
```

输出

```text
INFO taproom tap ipa opened
WARNING taproom keg below 10%
ERROR taproom keg empty
CRITICAL taproom cooler offline
[21/Nov/2026 00:41:20] "GET /taps/ipa/ HTTP/1.1" 200 14
ERROR django.request Internal Server Error: /kegs/7/
Traceback (most recent call last):
  File "django/core/handlers/exception.py", line 56, in inner
    response = get_response(request)
  File "django/core/handlers/base.py", line 199, in _get_response
    response = wrapped_callback(request, *callback_args, **callback_kwargs)
  File "urls.py", line 23, in keg
    raise ValueError(f"keg {keg_id} is empty")
ValueError: keg 7 is empty
[21/Nov/2026 00:41:20] "GET /kegs/7/ HTTP/1.1" 500 145
WARNING django.request Not Found: /missing/
[21/Nov/2026 00:41:20] "GET /missing/ HTTP/1.1" 404 179
ERROR taproom payment failed
Traceback (most recent call last):
  File "urls.py", line 32, in pay
    raise CardDeclined("card declined")
urls.CardDeclined: card declined
WARNING django.request Payment Required: /pay/
[21/Nov/2026 00:41:20] "GET /pay/ HTTP/1.1" 402 26
```

### 从环境变量读取级别

上面的 `LOGGING` 字典会读取 `LOG_LEVEL`。用 `LOG_LEVEL=DEBUG` 启动服务器，不改代码就能看到 `debug` 那一行。

```bash
LOG_LEVEL=DEBUG python manage.py runserver
```

输出

```text
DEBUG taproom keg pressure read
INFO taproom tap ipa opened
WARNING taproom keg below 10%
ERROR taproom keg empty
CRITICAL taproom cooler offline
[21/Nov/2026 00:41:21] "GET /taps/ipa/ HTTP/1.1" 200 14
```

### 用 logger.exception() 记录捕获的异常

在 `except` 里调用 `logger.exception()`，会以 `ERROR` 级别记录并附上回溯。我们的 `pay` 视图还返回了 402 响应，所以 `django.request` 以 `WARNING` 级别记录了 `Payment Required`。

```bash
def pay(request):
    try:
        raise CardDeclined("card declined")
    except CardDeclined:
        logger.exception("payment failed")
        return JsonResponse({"error": "card declined"}, status=402)
```

输出

```text
ERROR taproom payment failed
Traceback (most recent call last):
  File "urls.py", line 32, in pay
    raise CardDeclined("card declined")
urls.CardDeclined: card declined
WARNING django.request Payment Required: /pay/
```

## 把 Django 日志和错误发到 LogBrew

### 安装依赖包

`logbrew-django` 为每个请求创建一个 Span，并把视图里每个未处理的错误记录为问题。`logbrew-sdk` 提供客户端和日志处理器。使用你的 LogBrew 项目里的服务端密钥。

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

### 在 settings.py 里加入中间件和处理器

把这段代码放在 `MIDDLEWARE` 和 `LOGGING` 之后。`LogBrewDjangoMiddleware` 必须排在 `MIDDLEWARE` 的第一位。`LogBrewLoggingHandler` 会发送 `taproom` 记录器的每条记录。我们发到的是本地 LogBrew 服务器，所以我们的代码给 `HttpTransport()` 传了 `endpoint=`。

```bash
import logging
import os

from logbrew_django import configure_logbrew
from logbrew_sdk import HttpTransport, LogBrewClient, LogBrewLoggingHandler

MIDDLEWARE = ["logbrew_django.LogBrewDjangoMiddleware", *MIDDLEWARE]

client = LogBrewClient.create(api_key=os.environ["LOGBREW_SERVER_API_KEY"])
logging.getLogger("taproom").addHandler(LogBrewLoggingHandler(client))
configure_logbrew(
    client=client, transport=HttpTransport(), service_name="taproom"
)
```

### 读回问题和日志

我们再次调用这 4 个视图，并用读取密钥读取项目。500 错误变成了 1 个以路由命名的问题。`taproom` 日志保留了各自的级别，因为根级别是 `INFO`，`debug` 没有进来。404 没有产生问题。

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

输出

```text
Issues (1)
- 4ca6e2fb-76d2-57d9-879a-5a4410756489 unresolved error priority=medium GET /kegs/<int:keg_id>/ failed occurrences=1 users=unknown last_seen=2026-11-21T06:44:49.579Z service=taproom trace=980168dd9976432da150838cb57f0f04 assignee=unassigned [unversioned / production]
Logs (5)
- error payment failed service=taproom trace=430c4481db414e84bec813f60aa9aa93 [unversioned / production]
- critical cooler offline service=taproom trace=a407e883564e4ab486dd9a4921971ad4 [unversioned / production]
- info tap ipa opened service=taproom trace=a407e883564e4ab486dd9a4921971ad4 [unversioned / production]
- warning keg below 10% service=taproom trace=a407e883564e4ab486dd9a4921971ad4 [unversioned / production]
- error keg empty service=taproom trace=a407e883564e4ab486dd9a4921971ad4 [unversioned / production]
```

### 看看问题和日志保存了什么

问题保存了异常类型和路由，但不保存消息。LogBrew 会在消息的位置写上 `Unhandled exception`。`logger.exception()` 产生的日志则保存了异常名称和消息、文件、函数和行号。

```bash
logbrew issues --since 1h --json | jq '.[0].attributes | {
  message, exception,
  route: .metadata.routeTemplate,
  frames: (.stackFrames | length)
}'
logbrew read logs --since 1h --severity error --search payment --json |
  jq '.[0].attributes.metadata | {
    exceptionName, exceptionMessage, fileName, functionName, lineNumber
  }'
```

输出

```text
{
  "message": "Unhandled exception",
  "exception": {
    "mechanism": {
      "handled": false,
      "type": "django.middleware"
    },
    "type": "ValueError"
  },
  "route": "/kegs/<int:keg_id>/",
  "frames": 2
}
{
  "exceptionName": "CardDeclined",
  "exceptionMessage": "card declined",
  "fileName": "urls.py",
  "functionName": "pay",
  "lineNumber": 34
}
```

## 我们实测看到的结果

我们在 Python 3.13.5 上用 `runserver` 和 `DEBUG = False` 运行了 1 个 Django 6.1.3 应用，用 curl 调用 4 个视图，并读取服务器输出。然后我们加入 logbrew-django 0.1.12，读取本地 LogBrew 服务器保存的内容。

在 `DEBUG = True` 且没有 `LOGGING` 时，Django 也打印了 500 错误的回溯。所以一个在开发环境里打印回溯的应用，到了生产环境可能什么都不打印。

|  | 没有 `LOGGING` | 有 `LOGGING` |
| --- | --- | --- |
| `logger.debug()` | 否 | 使用 `LOG_LEVEL=DEBUG` |
| `logger.info()` | 否 | 是 |
| `logger.warning()` | 是 | 是 |
| 500 错误的回溯 | 否 | 是 |
| 404 对应的行 | 否 | 是 |

## Django 日志级别与 django.request 记录器

Django 使用 Python 的 5 个级别，`DEBUG`、`INFO`、`WARNING`、`ERROR` 和 `CRITICAL`。`LOGGING` 里的根级别会丢弃低于它的每条记录。

`django.request` 以 `ERROR` 级别记录 5xx 响应，以 `WARNING` 级别记录 4xx 响应。只有由异常引起的 500 带有回溯。

LogBrew 原样保留 `warning`、`error` 和 `critical`，并把 `DEBUG` 和 `INFO` 存为 `info`。

| 响应 | `django.request` | 回溯 |
| --- | --- | --- |
| `500` | `ERROR` | 是 |
| `404` | `WARNING` | 否 |
| `402` | `WARNING` | 否 |

## LogBrew 记录了什么

中间件为每个请求记录 1 个 Span，以路由模板命名，例如 `GET /kegs/<int:keg_id>/`。视图里的异常会新增一个问题，带有异常类型、机制 `django.middleware` 和 `handled: false`。

问题不保存异常消息。要保留它，就像 `pay` 视图那样用 `logger.exception()` 记录错误。

请求期间写下的日志会带上该请求的链路 ID。`Http404` 和其他 4xx 异常会生成带有对应状态码的 Span，不会产生问题。

- `LogBrewDjangoMiddleware`
  - 问题: `GET /kegs/<int:keg_id>/ failed`
  - `exception.type`: `ValueError`
  - `mechanism`: `django.middleware`
  - `handled`: `false`
  - 堆栈帧: 2
- `LogBrewLoggingHandler`
  - 消息: `payment failed`
  - `exceptionName`: `CardDeclined`
  - `exceptionMessage`: `card declined`
  - `lineNumber`: `34`

## 常见问题

### 为什么 Django 不记录 500 错误？

在 `DEBUG = False` 时，默认配置只把 `django.request` 的错误发给 `mail_admins`，由它发邮件给 `ADMINS`。要打印这些错误，加一个在根记录器上配置了控制台处理器的 `LOGGING` 字典。

### 怎么在 Django 里设置日志级别？

在 `LOGGING` 里给根记录器设置 `level`。从 `LOG_LEVEL` 这样的环境变量读取它，不改代码就能切换。

### 怎么在 Django 里记录带回溯的异常？

在 `except` 里调用 `logger.exception()`。它以 `ERROR` 级别记录并附上回溯。

### disable_existing_loggers 有什么作用？

设为 `True` 时，你的 `LOGGING` 一生效，Django 自带的记录器就会停止，`django.request` 什么都不打印。保持 `False`。

## 查看每个 Django 错误及其请求

logbrew-django 把视图里每个未处理的错误记录为以路由命名的问题，并把你的日志和对应请求的链路一起发送。免费额度充足，无需绑卡。

[免费开始](https://logbrew.co/zh-Hans)

## 参考来源

- [Django docs, Configuring logging](https://docs.djangoproject.com/en/6.0/topics/logging/#configuring-logging)
- [Django docs, Default logging configuration](https://docs.djangoproject.com/en/6.0/ref/logging/#django-s-default-logging-configuration)
- [Django docs, django.request](https://docs.djangoproject.com/en/6.0/ref/logging/#django-request)
- [django/django, django/utils/log.py](https://github.com/django/django/blob/main/django/utils/log.py)

## 更多智能体、Python、Node.js 与 React 指南

- [在 Claude Code 和 Codex 中添加 MCP 服务器](https://logbrew.co/zh-Hans/guides/mcp-server-claude-code-codex)
- [在 Claude Code 和 Codex 中使用 AGENTS.md](https://logbrew.co/zh-Hans/guides/agents-md)
- [解决 Claude overloaded 529 错误和 rate limit 429 错误](https://logbrew.co/zh-Hans/guides/claude-overloaded-rate-limit-error)
- [配置 Python 日志用对日志级别并捕获异常和回溯](https://logbrew.co/zh-Hans/guides/python-logging)
- [结构化日志用能按字段搜索的日志格式和日志级别](https://logbrew.co/zh-Hans/guides/structured-logging)
- [用 Pino 或 Winston 配置 Node.js 日志一个错误都不丢](https://logbrew.co/zh-Hans/guides/node-logging)
- [配置 FastAPI 日志处理错误不丢失回溯](https://logbrew.co/zh-Hans/guides/fastapi-logging)
- [给 React 加上错误边界并记录它漏掉的错误](https://logbrew.co/zh-Hans/guides/react-error-boundary)
- [Trace ID 和 Span ID 的区别，用真实的 traceparent 请求头解读](https://logbrew.co/zh-Hans/guides/trace-id)
- [错误、日志、链路、指标和版本指南](https://logbrew.co/zh-Hans/guides)
