Django REST Framework中self.request与request的区别及适用场景

核心结论 #

绝大多数场景下二者是完全相同的对象，你打印输出一致就是最直接的证明，不存在功能差异。

二者的底层关联 #

DRF 的 APIView 在请求分发（dispatch）阶段会先把 Django 原生的 HttpRequest 实例，包装成 DRF 自己扩展的 Request 实例。这个包装后的对象会同时做两个操作：

1. 赋值给视图实例的 request 属性，也就是你访问的 self.request
2. 作为第一个参数传递给对应的请求处理方法（get/post/put 等），也就是方法签名里的 request 参数

所以二者本质指向同一个实例，功能完全等价，你在请求方法里写 self.request.data 和 request.data 拿到的结果没有任何区别，只是写法习惯的差异。

两种写法存在的原因 #

参数 request 的作用 #

这是 Django 生态类视图的统一约定：不管是 Django 原生的类视图，还是 DRF 的类视图，请求处理方法的第一个参数固定为请求对象，符合所有 Django 开发者的通用认知，降低学习和适配成本。

self.request 的作用 #

主要是为了方便在非请求处理方法的类内逻辑中访问请求对象：比如你在视图类里封装了自定义的参数校验、权限判断、数据预处理方法，不需要每次调用都把 request 作为参数传递，直接通过 self.request 就能获取，代码更简洁。
示例如下：

class MyView(APIView):
    # 自定义的类内方法，没有request参数传入
    def get_current_tenant(self):
        return self.request.query_params.get("tenant_id")

    def get(self, request, format=None):
        tenant_id = self.get_current_tenant()
        # 此处用request.query_params或self.request.query_params效果完全一致
        return Response({"tenant_id": tenant_id})

示例代码的用法说明 #

你示例中 self.request.data 取数据、把参数 request 传入 login 方法的写法没有任何强制要求，换成 request.data 和 login(self.request, user) 运行结果完全一致。
额外补充：Django 原生的 auth.login 方法要求传入 Django 原生的 HttpRequest 实例，但 DRF 的 Request 实现了 __getattr__ 魔法方法，会自动把不存在的属性代理到内部包装的原生 HttpRequest 实例上，所以不管传入哪个都能正常运行，不会报错。

适用场景总结 #

• 在 get/post 等请求处理方法内部：两种写法均可，遵循团队编码规范即可
• 在视图类的自定义方法、属性中访问请求对象：只能使用 self.request

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