QQ 互聯(QQ Connect)提供 OAuth 2.0 授權體系,讓網站用戶無需註冊即可使用 QQ 帳號登入。本文基於官方 JS SDK,詳細說明前端接入流程、按鈕渲染、登入回調、用戶資訊獲取與登出實作,並附上完整可執行程式碼範例。
appid,即可開始前端開發。<!-- 在 <head> 中引入,非同步載入 -->
<script type="text/javascript"
src="https://qzonestyle.gtimg.cn/qzone/openapi/qc_loader.js"
data-appid="YOUR_APP_ID"
data-redirecturi="YOUR_CALLBACK_URL" <!-- 必須帶 http(s):// -->
charset="utf-8">
</script>
參數說明:
data-appid:申請到的 App ID。data-redirecturi:授權回調地址(需 URL 編碼),例如 https://www.example.com/qq-callback。charset:建議 utf-8。<div id="qqLoginBtn"></div> <!-- 按鈕容器,SDK 會自動渲染 -->
<script>
window.onload = function () {
QC.Login({
btnId: 'qqLoginBtn' // 按鈕容器 ID
}, function (reqData, opts) {
// 登入成功回調
var dom = document.getElementById(opts.btnId);
var logoutTpl = [
'<span><img src="{figureurl}" class="{size_key}" /></span>', // 頭像
'<span>{nickname}</span>', // 暱稱
'<span><a href="javascript:QC.Login.signOut();">退出</a></span>' // 登出連結
].join('');
dom && (dom.innerHTML = QC.String.format(logoutTpl, {
nickname: QC.String.escHTML(reqData.nickname), // XSS 過濾
figureurl: reqData.figureurl
}));
// 可在此發送 reqData 到後端換取 access_token、綁定帳號等
console.log('QQ 登入成功:', reqData);
}, function (opts) {
// 登出成功回調
alert('已登出');
// 重置按鈕 UI
document.getElementById(opts.btnId).innerHTML = '';
// 重新初始化登入按鈕(可選)
QC.Login({ btnId: opts.btnId });
});
};
</script>
// 檢測是否已登入並獲取 openid、access_token
QC.api('get_user_info', {
oauth_consumer_key: 'YOUR_APP_ID' // 可選,SDK 會自動補全
}).success(function (response) {
if (response.ret === 0) {
console.log('用戶資訊:', response);
// response 包含:nickname, figureurl, figureurl_1, figureurl_2, gender, vip 等
} else {
console.error('API 調用失敗:', response.msg);
}
});
// 另一種方式:直接獲取 openid/access_token(需用戶已授權)
if (QC.Login.check()) {
QC.Login.getMe(function (openId, accessToken) {
console.log('openId:', openId, 'accessToken:', accessToken);
// 將 openId、accessToken 送往後端換取用戶資料、綁定本地帳號
});
}
<!DOCTYPE html>
<html><head><meta charset="utf-8"><title>QQ 登入 Demo</title></head><body>
<div class="login-area">
<h3>QQ 登入示例</h3>
<div id="qqLoginBtn"></div>
<div id="user-info" style="margin-top:20px; display:none;"></div>
</div>
<script src="https://qzonestyle.gtimg.cn/qzone/openapi/qc_loader.js"
data-appid="YOUR_APP_ID"
data-redirecturi="https://YOUR_DOMAIN/qq-callback"
charset="utf-8"></script>
<script>
QC.Login({
btnId: 'qqLoginBtn'
}, function (reqData, opts) {
var dom = document.getElementById(opts.btnId);
var tpl = '<img src="{figureurl}" style="width:32px;height:32px;border-radius:50%"/> '
+ '<span>{nickname}</span> '
+ '<button onclick="QC.Login.signOut()">退出登入</button>';
dom.innerHTML = QC.String.format(tpl, {
nickname: QC.String.escHTML(reqData.nickname),
figureurl: reqData.figureurl_qq_1 || reqData.figureurl
});
document.getElementById('user-info').style.display = 'block';
document.getElementById('user-info').innerHTML = '<pre>' + JSON.stringify(reqData, null, 2) + '</pre>';
}, function (opts) {
document.getElementById(opts.btnId).innerHTML = '';
document.getElementById('user-info').style.display = 'none';
QC.Login({ btnId: opts.btnId }); // 重新渲染登入按鈕
});
</script>
</body></html>
| 問題 | 原因 | 解決方案 |
|---|---|---|
| 按鈕不顯示/點擊無反應 | SDK 載入失敗、appid 錯誤、redirecturi 不匹配 | Console 檢查網路請求;確認 redirecturi 與後台設定完全一致(含協議、域名、路徑) |
| redirect_uri_mismatch | 回調地址不在白名單 | QQ 互聯後台「應用配置」→「授權回調域」新增完整域名 |
| 獲取不到用戶頭像/暱稱 | reqData 字段名變更 | Console log reqData 確認實際字段;優先用 figureurl_qq_1/2 |
| 登出後按鈕不恢復 | 未重新初始化 QC.Login | 登出回調中呼叫 QC.Login({ btnId }) 重新渲染 |
| HTTPS 站點引入 HTTP SDK | 混合內容被瀏覽器阻擋 | SDK 網址已支援 HTTPS,確保使用 https://qzonestyle.gtimg.cn/... |
https://graph.qq.com/oauth2.0/me?access_token=... 獲取 openid,再呼叫 get_user_info 獲取用戶資料。state 參數,回調時驗證。掌握以上流程,您就能在半小時內為網站接入 QQ 登入,顯著降低用戶註冊門檻,提升轉化率。