第三方登录
标准版及以上商业版功能
校对日期:2026-11-16。需要商业版标准版及以上。
开启后,会员可以用微信、QQ 或微博账号登录网站前台。三个平台各自独立,按需开启。
一、在开放平台申请应用
先到要接入的平台创建应用,取得应用的 ID 和密钥:
| 平台 | 申请地址 | 取得的凭据 |
|---|---|---|
| 微信 | 微信开放平台,创建“网站应用”(扫码登录) | AppID、AppSecret |
| QQ 互联,创建“网站应用” | APP ID、APP Key | |
| 微博 | 微博开放平台 | App Key、App Secret |
申请时平台会要求登记回调地址,这个地址在下一步的设置页面里可以直接复制。
二、在后台填写并开启
进入 配置 → 全局设置 → 第三方登录。每个平台有一个开关、两项凭据和一个只读的回调地址:

- 把页面上的回调地址登记到对应的开放平台:微信登记其中的域名(“授权回调域”),QQ 和微博登记完整的地址,须完全一致。
- 填入上一步取得的两项凭据,打开开关,保存。保存后立即生效,不需要重启。
回调地址由程序按默认站点的协议、域名和端口生成,不能手工修改。地址不对(如还是 localhost)时,先到 配置 → 站点设置 → 基础设置 把协议和域名改成网站的正式地址。
三、同时开启会员注册
第一次用第三方账号登录的访客,需要注册一个本站的用户名来绑定。会员注册没有开启时,这一步无法完成,设置页面上方会有提示。 到 配置 → 全局设置 → 注册设置 开启注册。
四、前台的登录入口
使用默认主题时,开启了的平台会自动出现在前台的会员登录页和注册页上,不需要改模板。自己制作的主题需要在登录页放上入口, 地址为 /oauth/、/oauth/login/qq、/oauth/。
五、常见问题
- 从 13.1 之前的版本升级后,第三方登录失效。 旧版本写在
application.里的yaml oauth.client.*配置已不再使用,也不会自动迁移, 需要在上面的设置页面重新填写一次。 - 在开放平台授权后回到网站报错。 多数是回调地址与平台上登记的不一致,重新核对“在后台填写并开启”一节第 1 步;微信登记的是域名,不带
http://和路径。 - 授权后出现 404。 会员注册没有开启,见“同时开启会员注册”一节。
- 用 Docker 或无人值守方式安装时,能否在安装时就配好? 可以,在安装清单里提供各平台的凭据,见安装向导与无人值守安装。