使用mozilla-django-oidc集成Django与Keycloak后登录重定向异常求助

1. 确认LOGIN_REDIRECT_URL配置有效性 #

检查settings.py里的LOGIN_REDIRECT_URL是否拼写正确，建议使用绝对路径（比如/dashboard/）或完整URL，同时排查项目中是否有其他代码（视图、URL配置、中间件）覆盖了这个配置的行为。

2. 核对mozilla-django-oidc专属配置 #

• 若设置了OIDC_REDIRECT_URL，它会优先于LOGIN_REDIRECT_URL生效，不需要的话直接删除该配置
• 确认OIDC_AUTHENTICATION_CALLBACK_URL指向正确的回调端点（默认是/oidc/callback/），端点错误会导致重定向逻辑异常

3. Keycloak端重定向URL校验 #

Keycloak的Valid Redirect URIs必须包含Django的OIDC回调地址（比如http://localhost:8000/oidc/callback/），不能仅填写http://localhost:8000/。同时注意协议（http/https）、端口和末尾斜杠的一致性，任何不匹配都可能触发Keycloak默认跳转到根路径。

4. 排查自定义回调视图逻辑 #

如果自定义了继承OIDCAuthenticationCallbackView的回调视图，检查success_response方法里是否硬编码了重定向地址，或是修改了默认的重定向规则。

5. 清除缓存与会话 #

• 清空浏览器缓存和Cookie，避免旧会话干扰
• 在Keycloak控制台强制注销当前用户会话
• 重启Django服务，确保配置变更生效

6. 开启调试日志定位问题 #

在settings.py中添加日志配置，查看重定向过程的详细日志：

LOGGING = {
    'version': 1,
    'handlers': {
        'console': {'class': 'logging.StreamHandler'},
    },
    'loggers': {
        'mozilla_django_oidc': {
            'handlers': ['console'],
            'level': 'DEBUG',
        },
    },
}

启动服务后观察控制台日志，重点关注回调阶段的重定向地址计算过程。

内容的提问来源于stack exchange，提问作者El Mehdi Haddadi