Docker环境下Django无法删除JWT认证Cookie的解决方法

核心原因 #

删除Cookie时未完全匹配设置Cookie时的所有属性（httponly、secure、samesite），导致Docker环境中浏览器无法识别并删除目标Cookie。

解决方案 #

1. 同步删除Cookie的所有属性 #

修改登出视图，确保delete_cookie的参数和设置Cookie时完全一致：

@api_view(['GET'])
def LogoutUser(request):
    response = Response("logging out", status=status.HTTP_200_OK)
    response.delete_cookie(
        "jwt_token",
        path="/",
        httponly=settings.JWT_HTTPONLY,
        secure=settings.JWT_SECURE,
        samesite=settings.JWT_SAMESITE
    )
    return response

2. 验证Docker环境的配置参数 #

检查settings.py中Cookie相关配置：

• 若Docker部署使用HTTPS，JWT_SECURE需设为True；HTTP测试环境设为False
• JWT_SAMESITE值要与设置Cookie时一致（如'Lax'或'Strict'）

3. 备选方案：主动设置过期Cookie #

如果delete_cookie仍不生效，直接设置同名Cookie并强制过期，同样匹配所有属性：

@api_view(['GET'])
def LogoutUser(request):
    response = Response("logging out", status=status.HTTP_200_OK)
    response.set_cookie(
        "jwt_token",
        "",
        httponly=settings.JWT_HTTPONLY,
        secure=settings.JWT_SECURE,
        samesite=settings.JWT_SAMESITE,
        max_age=0,
        expires=0,
        path="/"
    )
    return response

4. 检查反向代理配置（若使用） #

如果Docker前端有Nginx等反向代理，需确保传递X-Forwarded-Proto头，让Django识别请求协议：
在settings.py中添加：

SECURE_PROXY_SSL_HEADER = ('HTTP_X_FORWARDED_PROTO', 'https')

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