在 Django 中，当发生 500 错误时默认仅显示简单的错误页面（不包含堆栈跟踪等详细信息），这通常是因为 生产环境配置禁用了调试模式（DEBUG = False）。以下是逐步解决方案，帮助你显示更详细的错误信息：
1. 启用调试模式（仅限开发环境！）
在 settings.py 中设置 DEBUG = True，并确保 ALLOWED_HOSTS 包含你的访问域名或 IP：
# settings.py
DEBUG = True # 开启调试模式
ALLOWED_HOSTS = ['localhost', '127.0.0.1', '你的服务器IP'] # 允许访问的主机
• 效果：错误页面将显示完整的堆栈跟踪、局部变量、请求信息等。
• 警告：切勿在生产环境中启用 DEBUG = True，否则会暴露敏感信息（如密钥、代码路径）。
2. 强制显示错误详情（即使 DEBUG = False）
如果需要在生产环境临时查看错误详情（不推荐长期开启），可以修改 settings.py：
# settings.py
DEBUG_PROPAGATE_EXCEPTIONS = True # 传播异常到服务器（如Gunicorn/Uvicorn）
然后通过服务器日志（如 gunicorn.error 或 nginx error.log）查看完整错误。
3. 配置日志记录（推荐用于生产环境）
在 settings.py 中配置日志记录，将错误信息写入文件：
# settings.py
LOGGING = {'version': 1,'disable_existing_loggers': False,'handlers': {'file': {'level': 'ERROR','class': 'logging.FileHandler','filename': '/var/log/django/error.log', # 日志文件路径},},'loggers': {'django': {'handlers': ['file'],'level': 'ERROR','propagate': True,},},
}
• 查看日志：
tail -f /var/log/django/error.log # 实时监控错误日志
4. 自定义错误视图（生产环境友好）
创建自定义错误页面，在发生 500 错误时记录详细信息：
# views.py
from django.views.decorators.csrf import requires_csrf_token
from django.template import RequestContext
import logginglogger = logging.getLogger(__name__)@requires_csrf_token
def server_error(request, template_name='500.html'):# 记录错误信息logger.error("500 Error: %s", request.path, exc_info=True)return render(request, template_name, status=500)
在 urls.py 中注册：
# urls.py
handler500 = 'myapp.views.server_error' # 指向自定义视图
5. 使用中间件捕获异常
创建中间件捕获所有异常并记录详细信息：
# middleware.py
import traceback
import logginglogger = logging.getLogger(__name__)class ExceptionLoggingMiddleware:def __init__(self, get_response):self.get_response = get_responsedef __call__(self, request):response = self.get_response(request)return responsedef process_exception(self, request, exception):# 记录完整的堆栈跟踪logger.error("Unhandled Exception: %s\n%s",str(exception),traceback.format_exc())return None # 继续返回默认500响应
在 settings.py 中添加中间件：
MIDDLEWARE = [# ...'myapp.middleware.ExceptionLoggingMiddleware',
]
6. 服务器配置（Nginx/Apache）
确保服务器不会覆盖 Django 的错误响应。例如在 Nginx 中，关闭对 500 错误的拦截：
# nginx.conf
server {...error_page 500 502 503 504 /500.html; # 注释或删除此行以允许 Django 处理错误location / {proxy_intercept_errors off; # 禁止Nginx拦截错误proxy_pass http://django_app;}
}
7. 使用 Django Debug Toolbar（仅限开发）
安装调试工具栏以实时查看请求详情：
pip install django-debug-toolbar
在 settings.py 中配置：
# settings.py
INSTALLED_APPS = [# ...'debug_toolbar',
]MIDDLEWARE = ['debug_toolbar.middleware.DebugToolbarMiddleware',# ...
]INTERNAL_IPS = ['127.0.0.1'] # 允许访问的IP
总结
• 开发环境：直接启用 DEBUG = True 查看完整错误。
• 生产环境：
• 配置日志记录（LOGGING）。
• 使用自定义错误视图和中间件记录详细信息。
• 检查服务器配置是否拦截了错误响应。
• 通过监控工具（如 Sentry）实时捕获错误。