### Django实现QQ第三方授权登录教程 要在Django项目中实现QQ授权登录功能，需要完成以下内容的开发和配置： #### 1. 模型设计 创建一个模型类用于存储用户的QQ openid与本地用户的关系。可以参考以下代码示例[^1]： ```python from django.db import models class OAuthQQUser(models.Model): """ QQ登录用户数据 """ create_time = models.DateTimeField(auto_now_add=True, verbose_name="创建时间") update_time = models.DateTimeField(auto_now=True, verbose_name="更新时间") user = models.ForeignKey('users.User', on_delete=models.CASCADE, verbose_name='用户') openid = models.CharField(max_length=64, verbose_name='openid', db_index=True) class Meta: db_table = 'tb_oauth_qq' verbose_name = 'QQ登录用户数据' verbose_name_plural = verbose_name ``` #### 2. 配置腾讯开放平台应用 在腾讯开放平台注册并申请appid和appkey，具体流程可参考腾讯官方文档[^1]。将申请到的appid和appkey保存到项目的配置文件中： ```python # settings.py QQ_APP_ID = 'your_app_id' QQ_APP_KEY = 'your_app_key' QQ_REDIRECT_URI = 'http://your_domain/callback' # 回调地址 ``` #### 3. 获取授权码（Code） 当用户点击“QQ登录”按钮时，重定向到QQ的授权页面，获取授权码。URL格式如下[^3]： ``` https://graph.qq.com/oauth2.0/authorize?response_type=code&client_id={APP_ID}&redirect_uri={REDIRECT_URI}&state={STATE} ``` `state`参数是可选的，用于防止CSRF攻击。 #### 4. 获取Access Token 用户授权后，QQ服务器会重定向到指定的回调地址，并附带一个`code`参数。通过该`code`可以向QQ服务器请求`access_token`。以下是获取`access_token`的代码示例： ```python import requests def get_access_token(code): url = f"https://graph.qq.com/oauth2.0/token?grant_type=authorization_code&client_id={QQ_APP_ID}&client_secret={QQ_APP_KEY}&code={code}&redirect_uri={QQ_REDIRECT_URI}" response = requests.get(url) data = response.text.split('&') # 返回的是类似 "access_token=xxx&expires_in=7776000" 的字符串 token_dict = {item.split('=')[0]: item.split('=')[1] for item in data if '=' in item} return token_dict['access_token'] ``` #### 5. 获取OpenID 通过`access_token`可以进一步获取用户的`openid`。以下是获取`openid`的代码示例： ```python def get_openid(access_token): url = f"https://graph.qq.com/oauth2.0/me?access_token={access_token}" response = requests.get(url) data = response.text # 返回的是类似 "callback( {\"client_id\":\"YOUR_APP_ID\",\"openid\":\"YOUR_OPENID\"} );" 的字符串 start = data.find("{") end = data.rfind("}") json_data = data[start:end+1] openid_info = json.loads(json_data) return openid_info['openid'] ``` #### 6. 绑定用户与OpenID 根据获取到的`openid`，查询数据库中是否存在对应的记录。如果存在，则直接登录；如果不存在，则需要引导用户绑定本地账户或创建新账户。 ```python from .models import OAuthQQUser def bind_user(openid, user): oauth_qq_user, created = OAuthQQUser.objects.get_or_create(openid=openid) if created: oauth_qq_user.user = user oauth_qq_user.save() return oauth_qq_user ``` #### 7. 视图函数实现 以下是完整的视图函数实现示例： ```python from django.shortcuts import redirect from django.contrib.auth import login def qq_login(request): code = request.GET.get('code') access_token = get_access_token(code) openid = get_openid(access_token) try: oauth_qq_user = OAuthQQUser.objects.get(openid=openid) except OAuthQQUser.DoesNotExist: # 如果没有找到绑定关系，则需要用户绑定账号 return redirect('/bind_account/?openid=' + openid) else: # 如果找到绑定关系，则直接登录 login(request, oauth_qq_user.user) return redirect('/') ``` --- ### 注意事项 1. **安全性**：确保回调地址的安全性，避免被恶意攻击者利用。 2. **错误处理**：在实际开发中，需对网络请求、异常情况等进行充分的错误处理。 3. **用户体验**：提供清晰的提示信息，帮助用户顺利完成绑定或登录过程。 ---