如何在Django中仅对特定URL路径启用Basic认证？

排查核心原因 #

/api路径返回403，大概率是以下两种情况：

• 你可能在项目中启用了django-basicauth的全局中间件，导致所有请求都被拦截，包括/api路径；
• Django REST Framework（DRF）自带的认证机制与django-basicauth产生冲突。

解决方案 #

方案1：仅用装饰器模式（避免全局拦截） #

如果你的初衷是仅给特定视图加Basic认证，先检查项目的MIDDLEWARE配置，确保没有添加basicauth.middleware.BasicAuthMiddleware。如果之前加了，直接从MIDDLEWARE列表中移除即可。

这样只有你手动添加@basic_auth_required装饰器的视图（比如places/views.py里的index视图）会被保护，/api路径的DRF视图不受影响。

方案2：用中间件模式+排除路径（更高效） #

如果想一次性保护除/api外的所有路径，推荐用中间件配合排除规则，不用逐个视图加装饰器：

1. 确保MIDDLEWARE中添加了basicauth.middleware.BasicAuthMiddleware；
2. 在candc/localsettings.py中添加排除路径配置：

BASICAUTH_EXCLUDE_PATHS = (
    '/api/',
    '/api/1.0/',  # 可以根据实际API路径调整，支持前缀匹配
)

这样中间件会自动跳过所有/api开头的请求，只保护其他路径。

方案3：调整DRF的认证配置（解决冲突问题） #

如果/api路径的403是DRF自带认证导致的，检查项目的DRF设置（通常在settings.py或localsettings.py中）：

REST_FRAMEWORK = {
    'DEFAULT_AUTHENTICATION_CLASSES': [
        # 如果你不需要DRF的Basic认证，可以移除下面这行
        # 'rest_framework.authentication.BasicAuthentication',
        'rest_framework.authentication.SessionAuthentication',
        # 其他你需要的认证类
    ]
}

移除DRF的BasicAuthentication类后，就不会和django-basicauth的认证逻辑冲突。

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