Django后端报错：Field.__init__()收到意外关键字参数'encoder'求助

一、解决Field.__init__() got an unexpected keyword argument 'encoder'错误 #

这个错误并非由你代码中直接传入的encoder参数导致，大概率是依赖包版本不兼容或第三方库隐式调用引发的，按以下步骤排查：

• 检查依赖版本兼容性
  重点核对Django与Django REST Framework（DRF）的版本匹配度，同时确认第三方序列化/认证库（如djangorestframework-simplejwt）的版本是否与当前DRF兼容。部分旧版DRF的Field类不支持encoder参数，但部分第三方库更新后会自动传递该参数，从而触发报错。
  建议创建新虚拟环境，安装固定版本的依赖进行测试：

  pip install django==4.2 djangorestframework==3.15.2
  

  若使用了JWT类库，同步调整其版本（如djangorestframework-simplejwt==5.2.2），确保与DRF版本适配。

• 排查间接引用的序列化类
  检查是否继承了第三方库提供的序列化基类，或使用了Django/DRF默认的序列化类（如User模型的序列化器），这些类内部可能存在携带encoder参数的字段。可以尝试自定义序列化器替代默认类，或查看第三方库源码确认参数传递逻辑。

• 检查DRF全局配置
  查看settings.py中的REST_FRAMEWORK配置项，确认是否在DEFAULT_RENDERER_CLASSES、DEFAULT_PARSER_CLASSES等配置中传入了encoder参数，这类全局配置可能会隐式传递给字段类。

二、解决Postman测试的CSRFToken错误 #

即便未使用session认证，DRF默认仍会对视图进行CSRF检查，可按以下方式处理：

• 类视图排除CSRF检查
  在注册视图类中明确禁用默认认证并允许匿名访问：

  from rest_framework.views import APIView
  from rest_framework.permissions import AllowAny
  
  class RegisterView(APIView):
      authentication_classes = []  # 禁用默认认证，避免CSRF检查
      permission_classes = [AllowAny]  # 允许匿名访问
  
      def post(self, request):
          # 注册逻辑代码
          pass
  

• 函数视图排除CSRF检查
  若使用函数视图，结合DRF装饰器与Django的csrf_exempt：

  from django.views.decorators.csrf import csrf_exempt
  from rest_framework.decorators import api_view, authentication_classes, permission_classes
  from rest_framework.permissions import AllowAny
  
  @csrf_exempt
  @api_view(['POST'])
  @authentication_classes([])
  @permission_classes([AllowAny])
  def register_view(request):
      # 注册逻辑代码
      pass
  

• 全局配置（不推荐）
  若所有API接口均无需CSRF检查，可从settings.py的MIDDLEWARE列表中移除django.middleware.csrf.CsrfViewMiddleware，但此方法会取消整个项目的CSRF防护，仅建议纯API项目使用。

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