Django 5退出登录时出现空白页面问题排查

核心原因 #

Django默认的logout视图（来自django.contrib.auth.urls）在接收GET请求时，会渲染一个退出确认页面，但如果未创建对应的registration/logged_out.html模板，就会显示空白页。而后台管理的退出操作是通过POST请求触发的，因此能直接执行跳转逻辑。

解决方法 #

方法1：改用POST请求触发退出（推荐） #

Django官方推荐用POST请求处理退出操作以避免CSRF风险，修改base.html中的退出链接为表单提交形式：

<form method="post" action="{% url 'logout' %}">
    {% csrf_token %}
    <button type="submit">退出登录</button>
</form>

点击按钮时会发送POST请求，触发logout视图执行退出逻辑，之后自动跳转到LOGOUT_REDIRECT_URL设置的页面。

方法2：创建退出确认模板 #

若坚持使用GET链接，需在项目templates目录下创建registration/logged_out.html模板，示例内容：

<!DOCTYPE html>
<html>
<head>
    <title>已退出登录</title>
</head>
<body>
    <p>你已成功退出登录。</p>
    <p><a href="{% url 'index' %}">返回首页</a></p>
</body>
</html>

访问/accounts/logout/时会显示该页面，而非空白。

方法3：自定义logout视图（可选） #

若需更灵活的控制逻辑，可在views.py中自定义退出视图：

from django.contrib.auth import logout
from django.shortcuts import redirect

def custom_logout(request):
    logout(request)
    return redirect('index')

随后在urls.py中替换默认的logout路由：

from . import views

urlpatterns = [
    path('accounts/logout/', views.custom_logout, name='logout'),
    # 其他路由配置...
]

验证配置 #

确认settings.py中的LOGOUT_REDIRECT_URL指向正确的路由名称：

LOGOUT_REDIRECT_URL = 'index'  # 确保'index'是你首页路由的name属性值

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