船说 CMSQQ 登录接口怎么配置

照着做完，你的船说 CMS 就能在登录页出现「QQ 一键登录」按钮，用户点一下授权即可自动注册并登录。

船说 CMS 的 QQ 登录本质是把腾讯 QQ 互联的 OAuth2 接口接到站内。整套动作分两半：一半在腾讯那边申请应用拿密钥，一半在你自己站里填参数。下面按顺序来。

第一步：在 QQ 互联申请网站应用，拿到 APP ID 和 APP KEY

这一步做完，你会得到两个字符串——APP ID（纯数字）和 APP KEY（32 位字母数字），它们是后面所有配置的基础。

1. 用你的 QQ 号登录 https://connect.qq.com，点右上角「头像 → 开发者中心」。
2. 左侧菜单点「应用管理 → 网站应用」，再点蓝色按钮「创建应用」。
3. 应用类型选「网站应用」，填写应用名称（写你的站点名）、网站地址（例如 https://www.你的域名.com）。
4. 关键一栏是「网站回调地址」，填 https://www.你的域名.com/qqcallback.php（具体路径见第三步，这里先按船说 CMS 默认的写）。
5. 提交后进入审核，通常 1–3 个工作日。审核通过后在应用详情页能看到 APP ID 和 APP KEY。

注意：回调地址必须和你站里实际处理回调的文件路径一字不差，包括 http 还是 https、带不带 www、结尾有没有斜杠。90% 的「redirect_uri 参数错误」都是这里对不上。

注意：QQ 互联要求网站域名已备案，未备案域名提交会被直接驳回。

第二步：把参数填进船说 CMS 后台

这一步做完，CMS 就知道该用哪个 QQ 应用去发起授权了。

登录你的站点后台，地址通常是 https://你的域名/admin.php（部分版本是 /admin/ 或 /manage/）。

• 船说 CMS 2.x / 3.x 常见路径是：左侧菜单「系统」→「登录设置」→「第三方登录」标签页。
• 如果找不到，去「网站设置」→「会员设置」里找「QQ 登录」分组。
• 部分精简版把这项放在「插件管理」→「QQ 登录插件」里，点「配置」。

在对应输入框里填：

• 启用 QQ 登录：勾选（开关拨到「开」）
• APP ID：粘贴第一步拿到的纯数字
• APP KEY：粘贴那串 32 位密钥
• 回调地址：https://你的域名/qqcallback.php

填完点页面底部「保存」或「提交」。

注意：如果你的版本后台没有第三方登录入口，说明该版本把配置写在文件里。打开 config/config.php（或 application/config.php），搜索 qq_appid、qq_appkey 这类字段，没有就手动加两行，然后去 application/index/controller/Login.php 里确认有读取这两个字段的逻辑。改文件前先备份。

第三步：确认回调文件存在

这一步做完，能避免用户授权后被丢到 404 页面。

在网站根目录找 qqcallback.php。船说 CMS 常见位置有三个：

• 根目录 qqcallback.php
• public/qqcallback.php
• application/index/controller/Qqcallback.php（走框架路由，此时回调地址要写成 https://你的域名/index/qqcallback）

哪个存在就用哪个，并把第一步 QQ 互联后台的回调地址改成一致的写法。

第四步：清缓存并测试

这一步做完就能验证是否真的通了。

1. 后台「系统」→「清除缓存」，把「数据缓存」「模板缓存」都点一遍。
2. 用 FTP 或宝塔面板删掉网站根目录下 runtime/ 文件夹里的内容（删内容，别删文件夹本身）。
3. 打开浏览器无痕窗口，访问前台登录页，应该能看到 QQ 图标按钮。
4. 点击后跳转到 QQ 授权页，确认后跳回站内并显示已登录，说明成功。

如果报错，按下面对照：

• 「redirect_uri 参数错误」→ 回调地址三处不一致（互联后台、CMS 后台、实际文件路径）。
• 「appid 无效」→ APP ID 填错，或应用还在审核中未上线。
• 点了没反应 → 浏览器控制台看有没有 JS 报错，通常是模板里 {php} 标签没被解析，需要重新生成首页缓存。
• 授权后跳回首页但没登录 → 检查 runtime 目录和 data 目录是否有写入权限，Linux 下一般设 755，属主设为 www。

注意：APP KEY 等同于密码，别写进前端模板，也别贴到论坛求人排查。一旦泄露，去 QQ 互联后台点「重置密钥」。

小结

• 先在 connect.qq.com 创建网站应用，拿到 APP ID 和 APP KEY，应用需审核通过。
• 回调地址在 QQ 互联后台、CMS 后台、实际文件路径三处必须完全一致。
• 船说 CMS 的配置入口一般在后台「系统 → 登录设置 → 第三方登录」，找不到就查 config/config.php。
• 改完必须清后台缓存并删 runtime/ 内容，否则配置不生效。
• 报错优先查回调地址和目录权限，其次查应用审核状态。