DRF项目自定义HTTP错误响应替代默认Bad Request提示

• 当前前端弹窗显示固定“Bad Request”的本质是，前端通常会优先读取HTTP响应头中固定的状态描述文本，而非自动解析响应体里携带的自定义内容。
• 直接使用Django原生HttpResponseBadRequest类返回REST接口响应，不符合DRF的响应规范，极易出现前端无法正确读取自定义提示内容的问题。

结构化返回自定义业务提示 #

替换原有的Django原生响应类为DRF内置的Response，按统一格式返回错误提示，示例代码如下：

from rest_framework import viewsets, status
from rest_framework.response import Response
import logging

logger = logging.getLogger(__name__)

class SaleViewSet(viewsets.ModelViewSet):
    def create(self, request, *args, **kwargs):
        data = request.data
        try:
            # 原有业务逻辑代码
            return Response(
                {"code": 0, "message": "销售单创建成功", "data": response},
                status=status.HTTP_201_CREATED
            )
        except ValueError as e:
            # 业务校验类异常，返回400状态码+对应业务提示
            logger.error(f"销售单创建参数校验失败：{str(e)}")
            return Response(
                {"code": 400, "message": f"销售单创建失败：{str(e)}", "data": None},
                status=status.HTTP_400_BAD_REQUEST
            )
        except Exception as e:
            # 系统级未知异常，记录日志后返回通用友好提示，禁止把原始异常栈直接暴露给前端
            logger.error(f"销售单创建系统异常：{str(e)}", exc_info=True)
            return Response(
                {"code": 500, "message": "系统繁忙，请稍后再试", "data": None},
                status=status.HTTP_500_INTERNAL_SERVER_ERROR
            )

配套前端调整要求 #

• 前端请求拦截器不要直接把HTTP状态文本作为弹窗展示内容，需要优先读取响应体中自定义的message字段做提示渲染。
• 如确实需要修改HTTP状态对应的固定描述文本，可通过HttpResponse的reason_phrase参数自定义，但不推荐这种写法，会破坏HTTP协议的语义规范。

常见踩坑提示 #

• 禁止直接把异常对象e的原始内容返回给前端，一方面可能泄露系统路径、SQL语句等敏感信息，另一方面非结构化的异常文本无法被前端稳定解析。
• 需要对异常做分类捕获，不要所有异常都笼统用顶层Exception捕获，否则无法针对不同错误场景匹配对应的业务提示。
• 上述实现逻辑同样适配update、partial_update等其他视图方法，也可以通过DRF自定义全局异常处理器统一实现异常捕获，减少重复编码量。

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