DRF：APIView重写finalize_response无效，如何捕获500内部错误并日志？

你遇到的这个问题很常见——当DRF内部抛出未捕获的异常时，finalize_response确实不会被调用，因为流程还没走到这一步就被异常中断了。下面给你几个靠谱的解决方案，按实用性排序：

方案1：重写APIView的handle_exception方法 #

这是最直接的方式，DRF的APIView在捕获到异常时会调用handle_exception生成错误响应，我们可以在这里先完成日志记录，再继续原有逻辑：

from rest_framework.views import APIView
import logging

logger = logging.getLogger(__name__)

class MyApiView(APIView):
    def handle_exception(self, exc):
        # 记录异常相关的请求和错误栈信息
        logger.error(
            f"Internal Server Error - Path: {self.request.path}, Method: {self.request.method}",
            exc_info=exc,
            extra={"request": self.request}
        )
        # 调用父类方法生成标准的500响应
        response = super().handle_exception(exc)
        # 这里也可以按需修改响应内容或添加额外日志字段
        return response

    def finalize_response(self, request, response, *args, **kwargs):
        # 正常请求的日志逻辑保持不变
        logger.info(
            f"Request processed - Path: {request.path}, Method: {request.method}, Status: {response.status_code}"
        )
        return super().finalize_response(request, response, *args, **kwargs)
    
    # 你的其他视图方法...

这样不管是正常响应还是500错误，日志都能被覆盖：handle_exception处理异常场景，finalize_response处理正常请求场景。

方案2：自定义DRF全局异常处理器 #

如果你想一次性处理所有视图的500错误日志，不用逐个视图修改，可以定义全局异常处理器：

# 在项目的utils模块或自定义文件中
from rest_framework.views import exception_handler
import logging

logger = logging.getLogger(__name__)

def custom_exception_handler(exc, context):
    # 获取请求对象并记录异常详情
    request = context["request"]
    logger.error(
        f"Global API Error - Path: {request.path}, Method: {request.method}",
        exc_info=exc,
        extra={"request": request}
    )
    # 调用DRF默认处理器生成标准响应
    response = exception_handler(exc, context)
    return response

然后在settings.py中配置生效：

REST_FRAMEWORK = {
    'EXCEPTION_HANDLER': 'your_project.utils.custom_exception_handler',
}

这个方案的好处是一次配置全局通用，适合项目级的统一日志需求。

方案3：使用Django全局中间件 #

如果需要捕获所有Django请求的错误（包括非DRF接口），可以写一个自定义中间件：

# middlewares.py
import logging
from django.utils.deprecation import MiddlewareMixin

logger = logging.getLogger(__name__)

class ErrorLoggingMiddleware(MiddlewareMixin):
    def process_exception(self, request, exception):
        # 记录异常的请求路径、方法和完整栈信息
        logger.error(
            f"Server Error - Path: {request.path}, Method: {request.method}",
            exc_info=exception,
            extra={"request": request}
        )
        # 返回None让Django继续处理异常生成响应
        return None

在settings.py的MIDDLEWARE列表中添加这个中间件（注意顺序，尽量放在靠前位置）：

MIDDLEWARE = [
    # 其他中间件...
    'your_project.middlewares.ErrorLoggingMiddleware',
]

关键提示 #

• exc_info=exc会让日志记录完整的异常栈，方便后续排查问题
• extra={"request": request}可以在日志中携带请求的额外上下文信息（需要你的日志配置支持）
• 如果需要记录响应内容，在handle_exception或全局处理器中，生成response后可直接访问response.data来记录

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