微信公众号(服务号)配置说明

分类:微信与小程序 · 更新于 2026-11-05 · 约 887 字

从服务号准备到后台参数填写:服务器配置、网页授权域名、模板消息与 IP 白名单一次配通。

一、账号选择与准备

本系统的公众号相关能力(关注引导、网页授权登录、模板消息通知、素材导出)基于微信服务号实现。订阅号没有网页授权与模板消息权限,无法用于站内登录与通知。

需要准备:

  • 一个已完成主体认证的服务号(企业或个体工商户主体)
  • 后台「微信设置」的填写权限
  • 站点使用的已备案域名(微信要求授权域名已备案)

二、填写基础参数

进入后台 → 微信设置 → 公众号配置,依次填写:

参数取值来源说明
AppID公众平台 → 开发 → 基本配置公众号唯一标识
AppSecret同上仅显示一次,重置后需同步更新
服务器地址(URL)站点提供的回调地址指向站点的微信回调入口
Token自行设置一串随机字符需与公众平台服务器配置一致
EncodingAESKey公众平台生成选择兼容模式或安全模式时必填

保存后回到公众平台点击「提交」,显示配置成功即为打通。

三、配置网页授权域名

网页授权登录要求把站点域名加入公众平台的授权域名列表:

  1. 公众平台 → 设置与开发 → 公众号设置 → 功能设置。
  2. 分别填写网页授权域名、JS 接口安全域名与业务域名。
  3. 按提示下载校验文件,放到站点根目录,确认可通过浏览器访问后提交。
授权域名有数量上限,站点较多时需按主域与子域规划,或用借权方式处理(见《微信接口权限与多站共用一个公众号》)。

四、模板消息与 IP 白名单

  • 模板消息:在公众平台选用行业模板,把模板编号填入后台对应字段;系统会在信息审核、置顶成功与到期等节点通知用户,并提醒站长有待审内容。
  • IP 白名单:调用微信接口的服务器 IP 需加入公众平台的 IP 白名单,否则接口直接返回错误。
  • 消息频率:管理端通知类消息存在频率限制,短时间内多条待审内容会合并为一次提醒,属于正常现象。

五、常见问题

  • AppSecret 重置后未同步,表现为登录报错、素材导出失败。
  • 回调地址使用 http 或带端口,微信只接受 https 且不带端口。
  • 授权域名校验文件未上传,或被伪静态规则拦截,提交时报校验失败。
  • 更换域名后未更新授权域名,表现为手机端登录后跳回首页。

相关教程

文档对不上实际界面?可在常见问题中查找排查步骤,或按「安装部署」中的环境要求核对版本。