Tolan/项目文档/微信QQ开放平台配置指南.md

微信/QQ开放平台配置指南

一、微信开放平台配置

1. 注册并创建应用

步骤	操作
1	访问 微信开放平台
2	注册/登录账号（需要企业认证）
3	进入「管理中心」→「网站应用」→「创建网站应用」
4	填写应用信息： - 应用名称：Lyrria 英语语音助手 - 应用简介：AI英语学习助手 - 应用官网：你的网站地址
5	设置授权回调域名： - 开发环境：localhost、127.0.0.1 - 生产环境：你的实际域名（如 lyrria.com）
6	提交审核（通常1-3个工作日）

2. 获取凭证信息

审核通过后，在应用详情页获取：

配置项	说明	位置
AppID	应用唯一标识	应用详情页
AppSecret	应用密钥	应用详情页 → 开发信息

3. 配置环境变量

在 backend/.env 中添加：

# 微信开放平台配置
WECHAT_APP_ID=你的AppID
WECHAT_APP_SECRET=你的AppSecret
WECHAT_REDIRECT_URI=http://www.chengyantek.cn/api/wechat/mp/verify

4. 授权流程说明

用户点击微信登录
    ↓
跳转到微信授权页面
    ↓
用户授权后回调到后端
    ↓
后端获取access_token和openid
    ↓
调用登录API完成登录

---

二、QQ开放平台配置

1. 注册并创建应用

步骤	操作
1	访问 QQ互联开放平台
2	注册/登录账号（需要企业认证）
3	进入「应用管理」→「创建应用」
4	选择应用类型：网站应用
5	填写应用信息： - 应用名称：Lyrria 英语语音助手 - 应用简介：AI英语学习助手 - 应用官网：你的网站地址
6	重要：设置授权回调域名： - 网站地址：填写完整的网站首页URL，如 https://www.chengyantek.cn/register - 网站回调域：填写完整的回调地址URL，如 https://www.chengyantek.cn/api/qq/mp/verify - ⚠️ 回调地址必须与代码中的 QQ_REDIRECT_URI 完全一致（包括协议、域名、路径）
7	提交审核（通常1-3个工作日）

2. 获取凭证信息

审核通过后，在应用详情页获取：

配置项	说明	位置
AppID	应用唯一标识	应用详情页
AppKey	应用密钥	应用详情页 → 开发信息

3. 配置环境变量

在 backend/.env 中添加：

# QQ开放平台配置
QQ_APP_ID=你的AppID
QQ_APP_KEY=你的AppKey
QQ_REDIRECT_URI=http://www.chengyantek.cn/api/qq/mp/verify

4. 授权流程说明

用户点击QQ登录
    ↓
跳转到QQ授权页面
    ↓
用户授权后回调到后端
    ↓
后端获取access_token和openid
    ↓
调用登录API完成登录

---

三、开发环境配置

本地开发回调地址

平台	回调地址格式
微信	http://www.chengyantek.cn/api/wechat/mp/verify
QQ	http://www.chengyantek.cn/api/qq/mp/verify

生产环境配置

配置项	说明
回调域名	在开放平台设置你的实际域名（不含协议和端口）
回调URI	http://www.chengyantek.cn/api/wechat/mp/verify（微信） http://www.chengyantek.cn/api/qq/mp/verify（QQ）

---

四、常见问题

Q1: 审核需要多长时间？

• 微信：通常1-3个工作日
• QQ：通常1-3个工作日

Q2: 个人开发者可以申请吗？

• 微信：需要企业认证，个人无法申请网站应用
• QQ：需要企业认证，个人无法申请网站应用

Q3: 开发环境如何测试？

• 在开放平台添加 localhost 和 127.0.0.1 到回调域名白名单
• 使用 http://localhost:8000 作为回调地址

Q4: 授权后如何获取用户信息？

• 微信：通过 access_token 调用 https://api.weixin.qq.com/sns/userinfo 获取
• QQ：通过 access_token 调用 https://graph.qq.com/user/get_user_info 获取

Q5: QQ登录跳转到错误页面（回调地址常见问题）？

问题现象：登录后跳转到 https://wiki.connect.qq.com/回调地址常见问题及修改方法

可能原因：

1. 回调地址不匹配：QQ应用配置的"网站回调域"与代码中的 QQ_REDIRECT_URI 不完全一致
2. 协议不匹配：配置使用 https 但代码使用 http（或反之）
3. 路径不一致：回调地址路径与配置不一致（如多了/少了斜杠）

解决方法：

1. 检查QQ应用配置的"网站回调域"是否为：https://www.chengyantek.cn/api/qq/mp/verify
2. 检查 backend/.env 中的 QQ_REDIRECT_URI 是否为：https://www.chengyantek.cn/api/qq/mp/verify
3. 确保两者完全一致（包括协议、域名、路径，不能有多余的斜杠）
4. 修改配置后，等待5-30分钟让配置生效
5. 查看后端日志，确认实际发送的回调地址是否正确

---

五、安全注意事项

1. AppSecret/AppKey 保密：不要提交到代码仓库
2. HTTPS 生产环境：生产环境必须使用 HTTPS
3. 回调域名验证：确保回调域名与开放平台配置一致
4. Token 有效期：access_token 有时效性，需要及时使用