微信公众号(服务号)配置说明
从服务号准备到后台参数填写:服务器配置、网页授权域名、模板消息与 IP 白名单一次配通。
一、账号选择与准备
本系统的公众号相关能力(关注引导、网页授权登录、模板消息通知、素材导出)基于微信服务号实现。订阅号没有网页授权与模板消息权限,无法用于站内登录与通知。
需要准备:
- 一个已完成主体认证的服务号(企业或个体工商户主体)
- 后台「微信设置」的填写权限
- 站点使用的已备案域名(微信要求授权域名已备案)
二、填写基础参数
进入后台 → 微信设置 → 公众号配置,依次填写:
| 参数 | 取值来源 | 说明 |
|---|---|---|
| AppID | 公众平台 → 开发 → 基本配置 | 公众号唯一标识 |
| AppSecret | 同上 | 仅显示一次,重置后需同步更新 |
| 服务器地址(URL) | 站点提供的回调地址 | 指向站点的微信回调入口 |
| Token | 自行设置一串随机字符 | 需与公众平台服务器配置一致 |
| EncodingAESKey | 公众平台生成 | 选择兼容模式或安全模式时必填 |
保存后回到公众平台点击「提交」,显示配置成功即为打通。
三、配置网页授权域名
网页授权登录要求把站点域名加入公众平台的授权域名列表:
- 公众平台 → 设置与开发 → 公众号设置 → 功能设置。
- 分别填写网页授权域名、JS 接口安全域名与业务域名。
- 按提示下载校验文件,放到站点根目录,确认可通过浏览器访问后提交。
授权域名有数量上限,站点较多时需按主域与子域规划,或用借权方式处理(见《微信接口权限与多站共用一个公众号》)。
四、模板消息与 IP 白名单
- 模板消息:在公众平台选用行业模板,把模板编号填入后台对应字段;系统会在信息审核、置顶成功与到期等节点通知用户,并提醒站长有待审内容。
- IP 白名单:调用微信接口的服务器 IP 需加入公众平台的 IP 白名单,否则接口直接返回错误。
- 消息频率:管理端通知类消息存在频率限制,短时间内多条待审内容会合并为一次提醒,属于正常现象。
五、常见问题
- AppSecret 重置后未同步,表现为登录报错、素材导出失败。
- 回调地址使用 http 或带端口,微信只接受 https 且不带端口。
- 授权域名校验文件未上传,或被伪静态规则拦截,提交时报校验失败。
- 更换域名后未更新授权域名,表现为手机端登录后跳回首页。