Django调试模式下JWT接口curl错误输出简化方案咨询

完全懂你的痛点——用curl调试JWT接口时，一碰到错误就收到一大坨HTML，翻半天才能找到关键错误信息。下面是几个实用方案，既能保留debug=True的调试便利，又能让错误输出变得清爽：

方法1：自定义全局异常处理函数（推荐） #

Django允许替换默认的异常处理逻辑，我们可以针对API请求（比如curl调用、AJAX请求）返回纯文本格式的错误追踪：

1. 在项目根目录或常用工具app里创建utils.py，添加以下代码：

import traceback
import sys
from django.http import HttpResponse
from django.conf import settings
from django.views.debug import ExceptionReporter
from django.views import debug

def api_exception_handler(request, exception):
    # 识别API请求：可根据路径、请求头或User-Agent灵活调整
    is_api_request = request.path.startswith('/api/') or \
                     'application/json' in request.META.get('HTTP_ACCEPT', '') or \
                     'curl' in request.META.get('HTTP_USER_AGENT', '')
    
    if settings.DEBUG and is_api_request:
        # 生成纯文本格式的错误追踪信息
        reporter = ExceptionReporter(request, None, *traceback.extract_tb(sys.exc_info()[2]))
        error_content = reporter.get_traceback_text()
        return HttpResponse(error_content, content_type='text/plain', status=500)
    
    # 非API请求或非Debug模式，沿用默认异常处理
    return debug.default_exception_handler(request, exception)

2. 在settings.py中配置这个自定义处理函数：

DEBUG = True

# 替换默认异常处理逻辑
EXCEPTION_HANDLER = 'your_project_name.utils.api_exception_handler'

这样配置后，用curl调用API出错时，终端会直接收到简洁的纯文本错误日志，再也不用翻几千行HTML了。

方法2：用中间件拦截API异常 #

如果不想修改全局异常处理，可以写一个专属中间件，只处理API请求的异常：

1. 创建middleware.py文件：

import traceback
from django.http import HttpResponse
from django.conf import settings

class APIErrorMiddleware:
    def __init__(self, get_response):
        self.get_response = get_response

    def __call__(self, request):
        response = self.get_response(request)
        return response

    def process_exception(self, request, exception):
        if not settings.DEBUG:
            return None
        
        # 识别API请求
        is_api_request = request.path.startswith('/api/') or 'curl' in request.META.get('HTTP_USER_AGENT', '')
        if is_api_request:
            # 生成纯文本错误追踪
            error_trace = ''.join(traceback.format_exception(type(exception), exception, exception.__traceback__))
            return HttpResponse(error_trace, content_type='text/plain', status=500)
        
        # 其他情况交给默认处理
        return None

2. 在settings.py的MIDDLEWARE列表中添加这个中间件（建议放在靠前位置）：

MIDDLEWARE = [
    # ... 其他中间件
    'your_project_name.middleware.APIErrorMiddleware',
]

方法3：临时调试技巧（无需改代码） #

如果只是临时调试，不想改动项目代码，可以在curl请求时指定Accept头，配合简单的配置修改：

在settings.py末尾添加：

import traceback
import sys
from django.http import HttpResponse
from django.views.debug import ExceptionReporter
from django.views import debug

def custom_traceback_response(request, exception):
    if 'text/plain' in request.META.get('HTTP_ACCEPT', ''):
        reporter = ExceptionReporter(request, None, *traceback.extract_tb(sys.exc_info()[2]))
        return HttpResponse(reporter.get_traceback_text(), content_type='text/plain', status=500)
    return debug.default_exception_handler(request, exception)

EXCEPTION_HANDLER = 'your_project_name.settings.custom_traceback_response'

然后用curl调用时加上Accept: text/plain头：

curl -H "Authorization: Bearer your_jwt_token" -H "Accept: text/plain" http://your-api-endpoint/

就能直接收到纯文本格式的错误日志了。

注意事项 #

• 以上方案都仅在debug=True时生效，生产环境（debug=False）仍会返回默认的安全错误响应，不用担心泄露敏感信息。
• 你可以根据自己的API路径规则，灵活调整is_api_request的判断逻辑，比如只针对特定业务模块的接口生效。

内容的提问来源于stack exchange，提问作者vidstige