Django REST Framework集成Django OAuth2.0出现未认证接口认证错误

嘿，我来帮你搞定这个认证问题！你遇到的{"detail": "Authentication credentials were not provided."}错误，本质是Django REST Framework（DRF）当前的权限/认证策略要求所有接口必须携带认证凭证，但你希望部分接口对未登录用户开放对吧？咱们一步步排查解决：

首先看你的settings.py里的REST_FRAMEWORK配置，如果DEFAULT_PERMISSION_CLASSES设置成了IsAuthenticated，那所有接口默认都会强制要求认证，这就会导致未认证请求报错。

修复方式： #

如果想全局允许未认证用户访问部分接口，可以把默认权限改成AllowAny，再给需要认证的视图单独设置权限：

REST_FRAMEWORK = {
    # 保留OAuth2认证类，这个是处理认证凭证的逻辑
    'DEFAULT_AUTHENTICATION_CLASSES': (
        'oauth2_provider.contrib.rest_framework.OAuth2Authentication',
    ),
    # 全局默认允许未认证访问，后续按需给特定视图加权限
    'DEFAULT_PERMISSION_CLASSES': (
        'rest_framework.permissions.AllowAny',
    )
}

如果不想全局开放，就不要修改DEFAULT_PERMISSION_CLASSES，直接给需要开放的视图单独配置权限即可。

如果只希望部分接口允许未认证用户访问，不需要改全局配置，直接在视图类/函数上指定permission_classes为AllowAny就行：

类视图示例： #

from rest_framework.permissions import AllowAny
from rest_framework.views import APIView
from rest_framework.response import Response

class PublicDataView(APIView):
    # 明确标记这个视图允许未认证访问
    permission_classes = [AllowAny]

    def get(self, request):
        return Response({"data": "这是公开数据，无需认证"})

函数视图示例： #

from rest_framework.decorators import permission_classes, api_view
from rest_framework.permissions import AllowAny
from rest_framework.response import Response

@api_view(['GET'])
@permission_classes([AllowAny])
def public_api(request):
    return Response({"message": "欢迎访问公开接口"})

确保你的settings.py里已经正确注册了相关应用，避免因为OAuth2配置缺失导致的认证逻辑异常：

INSTALLED_APPS = [
    # ... 你的其他应用
    'rest_framework',
    'oauth2_provider',  # 必须注册这个应用
]

# 可选：如果需要基于会话的OAuth2认证，添加中间件
MIDDLEWARE = [
    # ... 其他中间件
    'oauth2_provider.middleware.OAuth2TokenMiddleware',
]

确认你的公开接口没有被OAuth2的保护路由包裹，比如不要把公共接口放在oauth2_provider的protected路径下，示例正确的路由配置：

from django.urls import path
from .views import PublicDataView, PrivateDataView
from oauth2_provider.views import TokenView  # OAuth2获取token的接口本身是开放的

urlpatterns = [
    # 公开接口，无需认证
    path('public/', PublicDataView.as_view(), name='public-api'),
    # OAuth2获取token的接口，必须开放给所有用户
    path('oauth/token/', TokenView.as_view(), name='token'),
    # 需要认证的私有接口（继承默认权限或手动设置IsAuthenticated）
    path('private/', PrivateDataView.as_view(), name='private-api'),
]

如果还是报错，可以检查请求头是否不小心携带了错误的认证参数（比如无效的Token），或者通过DRF的调试界面（如果开启的话）查看当前视图的权限策略，确认permission_classes是否正确应用。

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