Django Allauth 整合 Google 登录时 redirect_uri_mismatch 错误解决方案

在使用 Django Allauth 进行 Google 第三方登录集成时，开发者经常会遇到 redirect_uri_mismatch 错误。这个问题看似简单，但涉及多个配置环节，需要系统性地排查和解决。

错误原因分析

redirect_uri_mismatch 错误的本质是 Google OAuth 服务端接收到的回调地址与开发者控制台中配置的授权重定向 URI 不匹配。这种不匹配可能由以下几个因素导致：

1. 协议不一致：开发环境使用 HTTP 而生产环境使用 HTTPS
2. 域名/子域名不完整：特别是部署在子域名下的应用
3. 路径差异：回调路径末尾是否包含斜杠
4. 参数问题：某些情况下 Google 会附加额外参数
5. 代理配置问题：Nginx 等反向代理可能导致实际 URI 变化

完整解决方案

1. 基础配置检查

首先确保 Django 设置中的基本配置正确：

INSTALLED_APPS = [
    # ...其他应用
    'django.contrib.sites',
    'allauth',
    'allauth.account',
    'allauth.socialaccount',
    'allauth.socialaccount.providers.google',
]

SITE_ID = 1  # 确保与你的站点匹配

AUTHENTICATION_BACKENDS = [
    'django.contrib.auth.backends.ModelBackend',
    'allauth.account.auth_backends.AuthenticationBackend',
]

2. Google 提供商配置优化

在 settings.py 中添加以下优化配置：

SOCIALACCOUNT_PROVIDERS = {
    'google': {
        'SCOPE': [
            'profile',
            'email',
        ],
        'AUTH_PARAMS': {
            'access_type': 'online',
        },
        'OAUTH_PKCE_ENABLED': True,
    }
}

3. 重定向 URI 的多环境配置

针对不同环境，需要在 Google 开发者控制台添加所有可能的 URI 变体：

• 开发环境：

  • http://127.0.0.1:8000/accounts/google/login/callback/
  • http://localhost:8000/accounts/google/login/callback/
  • 带参数的变体：http://127.0.0.1:8000/accounts/google/login/callback/?flowName=GeneralOAuthFlow

• 生产环境：

  • https://yourdomain.com/accounts/google/login/callback/
  • https://sub.yourdomain.com/accounts/google/login/callback/ (如果有子域名)

4. Nginx 代理配置要点

如果使用 Nginx 作为反向代理，确保配置正确处理请求：

server {
    listen 80;
    server_name yourdomain.com;

    location / {
        proxy_pass http://127.0.0.1:8000;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

关键点在于 X-Forwarded-Proto 头部，这能确保 Django 识别正确的协议。

5. Django 协议设置

确保 Django 能正确识别 HTTPS：

# 生产环境设置
SECURE_PROXY_SSL_HEADER = ('HTTP_X_FORWARDED_PROTO', 'https')
SESSION_COOKIE_SECURE = True
CSRF_COOKIE_SECURE = True
ACCOUNT_DEFAULT_HTTP_PROTOCOL = "https"

调试技巧

1. 查看实际请求：使用浏览器开发者工具查看 OAuth 流程中实际发送的 redirect_uri
2. 日志检查：启用 Django 调试日志查看 Allauth 的处理过程
3. 逐步测试：先在简单环境测试，再逐步增加复杂度
4. 清除缓存：有时浏览器或 Django 的缓存会导致旧配置生效

总结

解决 Django Allauth 的 Google 登录 redirect_uri_mismatch 问题需要系统性地检查三个关键环节：Django 配置、Google 控制台设置和服务器代理配置。特别要注意环境差异和多变体 URI 的配置。通过以上方法，开发者可以有效地解决这一常见但棘手的集成问题。