直接用django-allauth而非手写OAuth2流程，因其已封装主流平台provider，强制state校验、安全session存储、敏感token隔离，并无缝对接Django用户体系；手写易致CSRF、token泄露及维护坑。
为什么直接用 django-allauth 而不是自己手写 OAuth2 流程
因为 OAuth2 授权码流程涉及重定向、state 校验、token 交换、用户信息获取等多个环节，稍有疏漏就会导致 CSRF 漏洞、重放攻击或 token 泄露。django-allauth 已经封装了 Google、GitHub、Twitter（现 X）、Microsoft 等主流平台的 provider，并强制校验 state、使用安全的 session 存储、隔离敏感 token（不存入数据库默认），还能和 Django 的 User / AccountAdapter 无缝对接。自己实现不仅耗时，还容易在 refresh_token 处理、scope 变更、provider 接口升级时掉坑里。
配置 GitHub 登录时必须注意的四个参数
以 GitHub 为例，settings.py 中需配置：
-
SOCIALACCOUNT_PROVIDERS下的github字典必须显式声明"scope": ["read:user", "user:email"]—— 缺少user:email会导致allauth拿不到邮箱，进而无法匹配或创建用户 -
SITE_ID = 1必须存在且对应django_site表中 id=1 的记录，否则socialaccount关联失败，后台报Site matching query does not exist -
LOGIN_REDIRECT_URL和LOGOUT_REDIRECT_URL建议设为相对路径（如"/"），避免硬编码域名引发重定向失败 - GitHub App 的
Authorization callback URL必须严格匹配：开发环境填http://127.0.0.1:8000/accounts/github/login/callback/，线上则用实际域名，末尾斜杠不能少 —— 少了会返回redirect_uri_mismatch
自定义登录后跳转逻辑不能只改 LOGIN_REDIRECT_URL
LOGIN_REDIRECT_URL 是全局兜底，但第三方登录常需差异化处理：比如新用户跳引导页，老用户回上次访问路径，或者根据 provider 类型跳不同 dashboard。这时要覆盖 allauth 的 DefaultAccountAdapter：
from allauth.account.adapter import DefaultAccountAdapter
class CustomAccountAdapter(DefaultAccountAdapter):
def get_login_redirect_url(self, request):
if request.user.is_new:
return "/onboard/"
if "next" in request.GET:
return request.GET["next"]
return super().get_login_redirect_url(request)
再在 settings.py 中设置：ACCOUNT_ADAPTER = "myapp.adapters.CustomAccountAdapter"。注意：这个方法在用户对象已保存、session 已建立后才调用，所以可安全访问 request.user 和 request.GET；但别在里面做耗时操作，否则阻塞登录响应。
图片提示词生成器？不止如此。 马甲系统 —— 把脑海中的画面，翻译成AI能理解的专业表达。 用得越多，它越懂你：首次需要多问几句确认方向，用久了几乎一说就懂。 用得越多，它越快：缓存机制让后续对话越来越省。 RAG进化：成功案例持续入库，越跑越聪明。 输入「新手指南」查看完整功能介绍
立即学习“Python免费学习笔记（深入）”；
调试 socialaccount 登录失败时先查这三个表
常见现象是点击登录按钮后跳回首页，无错误提示，也未创建用户。此时不要急着翻日志，先查数据库：
-
socialaccount_socialapp：确认client_id和secret是否粘贴正确（GitHub secret 是「Client secrets」，不是「Client ID」） -
socialaccount_socialtoken：如果已有记录但登录仍失败，说明 token 过期或权限不足，可手动删掉该记录触发重新授权 -
socialaccount_socialaccount：检查是否有重复uid（如用户用同一 GitHub 账号在不同 site_id 下登录过），会导致IntegrityError: duplicate key value violates unique constraint
另外，DEBUG=True 时，所有 OAuth2 请求的完整 URL 和响应体都会打印在终端，重点看是否出现 "error": "bad_verification_code" 或 "access_token": null —— 基本就是 callback URL 不匹配或 client_secret 错了。
