Django/DRF – DELETE操作中的405 Method Not Allowed

在本文中，我们将介绍Django和Django REST Framework（DRF）中DELETE操作时可能出现的405 Method Not Allowed错误，并提供解决方法和示例说明。

阅读更多：Django 教程

介绍

Django是一个流行的Python Web框架，而Django REST Framework（DRF）是在Django基础上构建的强大而灵活的Web API框架。DELETE操作是一种常用的HTTP方法，用于删除资源。但是，在使用Django和DRF开发Web应用时，可能会遇到405 Method Not Allowed错误。本文将探讨这个问题，并提供解决方案。

问题分析

当我们使用DRF的ModelViewSet或APIView视图类进行DELETE操作时，如果出现405 Method Not Allowed错误，可能有以下几个原因：

1. Django路由配置错误：首先，请确保Django的URL配置正确，包括正确配置URL路由和指定正确的视图处理程序。

2. CSRF保护：Django中默认启用CSRF保护，这是为了防止跨站请求伪造。对于DELETE操作，Django要求在请求中包含有效的CSRF令牌。如果未包含令牌或令牌无效，则会出现405错误。

3. 未正确配置权限：在DRF中，权限定义和认证是非常重要的。如果未正确配置权限，尤其是未授权用户或未授权的请求，将导致405错误。

解决方案

1. 检查Django的URL配置

首先，请确保在Django的URL配置文件（通常是urls.py）中正确配置了URL路由和视图处理程序。

例如，对于一个名为”api/”的URL路由，它可能指向一个继承自DRF的视图类的方法：

from myapp import views

urlpatterns = [
    ...
    path('api/', views.MyAPIView.as_view()),
    ...
]

2. 处理CSRF保护

对于DELETE操作，我们需要在请求中包含有效的CSRF令牌，以通过Django的CSRF保护。有几种方法可以处理这个问题：

方法1：使用Django CSRF令牌

在进行DELETE请求时，可以在请求头中添加CSRF令牌。

const csrftoken = getCookie('csrftoken');

fetch(url, {
    method: 'DELETE',
    headers: {
        'Content-Type': 'application/json',
        'X-CSRFToken': csrftoken
    },
    ...
})

方法2：禁用CSRF保护

如果你确定DELETE操作不需要CSRF保护，可以选择在视图类中禁用CSRF检查。

from rest_framework.views import APIView
from rest_framework.authentication import SessionAuthentication

class MyAPIView(APIView):
    authentication_classes = [SessionAuthentication]
    ...

    def delete(self, request, format=None):
        ...

3. 配置权限和认证

在DRF中，我们可以通过配置权限和认证来限制访问和操作。要确保DELETE操作具有合适的权限，可以使用DRF提供的权限类。

from rest_framework import permissions

class MyAPIView(APIView):
    permission_classes = [permissions.IsAuthenticated]
    ...

    def delete(self, request, format=None):
        ...

在这个示例中，只有经过身份验证的用户可以执行DELETE操作。

示例说明

假设我们有一个简单的博客应用，其中包含文章（Article）和评论（Comment）两个资源。我们将使用DRF的ModelViewSet视图类来处理这两个资源的CRUD操作。

from rest_framework import viewsets
from myapp.models import Article, Comment
from myapp.serializers import ArticleSerializer, CommentSerializer

class ArticleViewSet(viewsets.ModelViewSet):
    queryset = Article.objects.all()
    serializer_class = ArticleSerializer

class CommentViewSet(viewsets.ModelViewSet):
    queryset = Comment.objects.all()
    serializer_class = CommentSerializer

在这个例子中，我们可以使用这两个视图类来执行DELETE操作。

DELETE /api/articles/1/ HTTP/1.1
Host: example.com
Authorization: Bearer <token>

如果你按照上述解决方案配置了URL、CSRF保护和权限，这个DELETE操作应该可以正常工作，而不会出现405错误。

总结

在开发使用Django和DRF的Web应用时，DELETE操作可能会出现405 Method Not Allowed错误。在本文中，我们介绍了这个问题的可能原因，并提供了解决方法和示例说明。通过正确配置URL、处理CSRF保护和配置权限，可以解决这个问题，确保DELETE操作的顺利执行。