django-allauth 不是开箱即用的“一键登录”，需手动配置认证后端、模板路径、回调域名；socialaccount 默认不自动创建用户，须设 socialaccount_auto_signup=true 且正确配置邮箱验证与自定义用户适配；google oauth redirect_uri_mismatch 需严格匹配 cloud console 授权路径；社交登录按钮需手动添加并使用 {% url 'socialaccount_login' %}；微信登录需 https 回调及 app id/secret；跨域场景下需自行实现 login_by_token 等逻辑。
直接说结论：django-allauth 不是开箱即用的“一键登录”，它需要你手动配置认证后端、适配模板路径、处理社交登录回调域名限制，否则 socialaccount_login 会卡在重定向或报 AuthenticationFailed。
为什么 allauth 的 SocialAccount 无法自动创建本地用户？
默认行为是只允许已存在用户绑定第三方账号，新用户首次登录会被拒绝——这不是 bug，而是安全策略。你需要显式启用自动注册：
- 确保
ACCOUNT_EMAIL_VERIFICATION = "optional"或"mandatory"（否则邮箱为空时创建失败） - 设置
SOCIALACCOUNT_AUTO_SIGNUP = True，否则SocialAccountAdapter.pre_social_login会跳过用户创建 - 如果用了自定义
User模型，必须在SOCIALACCOUNT_ADAPTER中重写new_user()方法，否则get_user_model()创建的仍是AbstractUser
GoogleOAuth2Adapter 报错 redirect_uri_mismatch 怎么修？
这是最常卡住的点：Django 开发时用 http://localhost:8000，但 Google Cloud Console 要求精确匹配，且不接受 localhost 带端口以外的变体。
- 在 Google Cloud Console 的 OAuth 凭据页，
Authorized redirect URIs必须填http://localhost:8000/accounts/google/login/callback/（注意结尾斜杠和完整路径） - 生产环境务必换成真实域名，比如
https://example.com/accounts/google/login/callback/，且 Django 的ALLOWED_HOSTS和SECURE_SSL_REDIRECT要同步开启 - 检查
SOCIALACCOUNT_PROVIDERS['google']['SCOPE']是否包含'https://www.googleapis.com/auth/userinfo.email'，缺了就拿不到邮箱，导致用户创建失败
如何让 login.html 同时支持本地登录 + 微信/ GitHub 登录按钮？
allauth 默认只渲染表单，社交登录入口要自己加，且路径必须用 {% url 'socialaccount_login' %} 而不是硬编码。
{% load socialaccount %}
<a href="%7B%%20url%20'socialaccount_login'%20%%7D?provider=github">GitHub 登录</a>
<a href="%7B%%20url%20'socialaccount_login'%20%%7D?provider=weixin">微信登录</a>
-
weixin是 allauth 内置 provider 别名，不是wechat或wechatpay - 微信需额外配置
WEIXIN_APP_ID和WEIXIN_APP_SECRET，且回调地址必须是 HTTPS（开发时可用 ngrok 临时代理） - 按钮样式靠 CSS 控制，allauth 不提供默认 UI，别指望它自动加载 Bootstrap 类
真正麻烦的是跨域场景下 session 和 CSRF 的协同——比如前端 Vue 独立部署时调用 Django 登录接口，django-allauth 的 login_by_token 流程得自己补全，官方文档几乎没提这部分。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
