使用django-allauth对接GitHub时出现redirect_uri_mismatch错误求助

这个错误的核心逻辑非常明确：GitHub收到的回调URL，和你在GitHub OAuth应用中注册的授权回调URL完全不匹配。结合django-allauth的使用场景，以下是最常见的几个诱因和对应的排查/解决方法：

常见原因及解决办法 #

1. HTTP/HTTPS协议不一致 #

django-allauth会根据当前请求的协议自动生成回调URL。比如你本地开发用的是http://localhost:8000，但在GitHub应用里注册的回调URL是https://localhost:8000/accounts/github/login/callback/，这种协议差异会直接触发不匹配错误。

• 解决：本地开发时，确保GitHub里的回调URL用http协议；生产环境切换到https后，同步更新GitHub的配置。同时可以在Django的settings.py里明确指定：

  ACCOUNT_DEFAULT_HTTP_PROTOCOL = "http"  # 本地开发用http，生产环境替换为https
  

2. 域名或端口不匹配 #

很多开发者会混用localhost和127.0.0.1，或者本地开发的端口和GitHub里填写的不一致。比如你实际运行Django的端口是8080，但GitHub里填的是8000；或者用127.0.0.1:8000访问，但GitHub里注册的是localhost:8000，这些细微差异都会导致不匹配。

• 解决：统一使用同一个域名+端口组合，比如全程用localhost:8000，然后在GitHub应用的授权回调URL里填http://localhost:8000/accounts/github/login/callback/。

3. 回调路径的斜杠细节问题 #

django-allauth默认的GitHub回调路径是/accounts/github/login/callback/（注意末尾的斜杠）。如果GitHub里注册的路径漏掉了末尾斜杠（比如/accounts/github/login/callback），或者反过来，就会触发不匹配错误。

• 解决：仔细对比控制台报错里的请求路径（就是报错里的/accounts/github/login/callback部分）和GitHub里的配置，确保路径完全一致，包括末尾的斜杠。

4. django-allauth手动配置的redirect_uri冲突 #

如果你在settings.py的SOCIALACCOUNT_PROVIDERS里手动给GitHub指定了redirect_uri，这个值必须和GitHub应用里注册的完全一致，否则也会触发错误。

• 解决：检查以下配置，如果有手动设置的redirect_uri，确保和GitHub的回调URL完全一致；如果不需要手动指定，可以直接删除这个配置，让django-allauth自动生成：

  SOCIALACCOUNT_PROVIDERS = {
      'github': {
          # 若设置了这行，必须和GitHub的回调URL完全匹配
          # 'REDIRECT_URI': 'http://localhost:8000/accounts/github/login/callback/',
      }
  }
  

快速排查步骤 #

1. 从控制台报错里提取完整的回调URL：把请求中的域名+端口+路径拼接起来，比如http://localhost:8000/accounts/github/login/callback/；
2. 打开GitHub OAuth应用的设置页面，对比“授权回调URL”里的内容，检查协议、域名、端口、路径是否完全一致；
3. 核对Django settings.py里的ACCOUNT_DEFAULT_HTTP_PROTOCOL和SOCIALACCOUNT_PROVIDERS配置，确保没有冲突项。

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