踩坑实录：Flarum怎么绑定QQ登录？别再用错包名了！

老板一句话：“论坛加个QQ登录吧。”
结果 Composer 直接甩脸：
Could not find a matching version of package flarum/auth-qq
别慌，这篇Flarum QQ登录教程把正确包名、回调地址、常见翻车点一次打包，复制就能跑通。

目录

1. QQ互联后台：先把钥匙拿到手
2. 装插件：别再敲 flarum/auth-qq
3. 面板后台填密钥
4. 回调地址填什么？一次写对
5. 翻车点合集

1 QQ互联后台：先把钥匙拿到手

没钥匙，后面全是白搭。

1. 打开 QQ互联官网 → 登录 → 应用管理 → 创建应用。
2. 填资料：

   应用名称：随便写，比如「NERVCN社区」
   应用地址：https://你的域名
   回调地址：https://你的域名/api/auth/qq
   

3. 提交审核（秒过）。复制 AppID 和 AppKey，待会儿用。

2 装插件：别再敲 flarum/auth-qq

官方仓库早改名，敲错包名当然找不到。

# 进站点根目录
cd /home/www/flarum

# 真正支持 Flarum 1.x 的 QQ 登录插件
/www/server/php/82/bin/php /usr/local/bin/composer require hehongyuanlove/flarum-auth-qq

# 跑迁移+清缓存
/www/server/php/82/bin/php flarum migrate
/www/server/php/82/bin/php flarum cache:clear

3 面板后台填密钥

路径：Admin → Extensions → QQ Auth → Enable

• AppID：粘贴刚才拿到的
• AppKey：同上
• 保存即可

4 回调地址填什么？一次写对

QQ 互联后台需要填两条：

• PC端：https://你的域名/api/auth/qq
• 手机端：https://你的域名/api/authh5/qq

末尾斜杠别丢，别手滑写成 http。

5 翻车点合集

收工！刷新登录页，蓝色 QQ 按钮已经出现。

Flarum QQ登录、Flarum绑定QQ、Flarum第三方登录一次到位，妈妈再也不担心我踩坑了。