微信公众号开发中,业务域名、JS接口安全域名和网页授权域名怎么配置?

2026-12-12
4549 浏览
3 评论
闻道君

以下是微信公众号开发中配置业务域名、JS接口安全域名和网页授权域名的完整流程及注意事项,按步骤操作即可完成配置:


一、配置前准备

  1. 域名要求

    • 已完成ICP备案(国内服务器必备)。

    • 已启用HTTPS协议(微信强制要求)。

    • 确保域名解析生效,可通过公网访问。

  2. 验证文件准备

    • 从微信公众平台下载验证文件(如 MP_verify_xxxxxx.txt)。

    • 将文件上传至域名根目录(如 https://example.com/MP_verify_xxxxxx.txt)。


二、配置流程

1. 业务域名配置

作用:标识公众号官方网页,避免用户访问钓鱼网站。
步骤:

  1. 登录微信公众平台 → 设置 → 公众号设置 → 功能设置 → 业务域名。

  2. 点击配置,输入域名(如 example.com),不支持子域名自动继承。

  3. 按提示下载验证文件,上传至域名根目录。

  4. 点击确认,等待系统自动验证(约1-2分钟)。

注意:

  • 最多配置3个域名,需逐个验证。

  • 域名必须为顶级域名(如 a.example.com 需单独配置)。


2. JS接口安全域名配置

作用:允许指定域名调用微信JS-SDK(如分享、支付等)。
步骤:

  1. 进入公众平台 → 设置 → 公众号设置 → 功能设置 → JS接口安全域名。

  2. 输入域名(如 example.com),支持子域名自动继承(如 api.example.com 无需单独配置)。

  3. 上传验证文件或通过DNS解析验证(推荐文件验证)。

  4. 点击保存,验证通过后生效。

注意:

  • 最多配置5个域名(部分账号可能限制为3个)。

  • 调用JS-SDK的页面需引入微信JS文件(如 https://res.wx.qq.com/open/js/jweixin-1.6.0.js)。


3. 网页授权域名配置

作用:用于OAuth2.0授权,获取用户信息(如OpenID、昵称)。
步骤:

  1. 进入公众平台 → 开发 → 接口权限 → 网页授权域名。

  2. 输入主域名(如 example.com),子域名自动生效(如 auth.example.com)。

  3. 上传验证文件至根目录(与业务域名文件可共用)。

  4. 点击保存,验证通过后生效。

注意:

  • 仅支持1个主域名,但包含所有子域名。

  • 授权回调地址必须与配置域名完全匹配(如 https://example.com/callback)。

  • 仅支持80(HTTP)或443(HTTPS)端口。


三、验证配置是否成功

  1. 业务域名:

    • 访问配置的域名,浏览器地址栏应显示公众号名称(绿色标识)。

  2. JS接口安全域名:

    • 在配置域名下的页面调用 wx.config(),无报错即成功。

  3. 网页授权域名:

    • 生成授权链接并访问,能正常跳转且获取到code即成功。

    • 授权链接示例:

      https://open.weixin.qq.com/connect/oauth2/authorize?
      appid=APPID&
      redirect_uri=REDIRECT_URI&
      response_type=code&
      scope=snsapi_userinfo&
      state=STATE#wechat_redirect

四、常见问题解决

  1. 验证失败

    • 检查HTTPS证书有效性(需受信任的CA签发)。

    • 确保验证文件可公开访问(无重定向或权限限制)。

  2. 授权回调报错(10003)

    • 确认 redirect_uri 的域名与网页授权域名完全一致(包括大小写)。

  3. JS-SDK调用无效

    • 检查域名是否在安全域名列表中,且页面引入的JS文件版本正确。


五、官方文档参考

  • 业务域名配置指南

  • JS-SDK使用说明

  • 网页授权文档

按以上步骤操作即可完成配置,若仍有问题可联系微信客服或提交工单。


****更多行业产品开发方案,请关注 加速度****

<以上资讯仅供参考,如需解决具体问题,建议您关注作者;如果有软件产品开发需求,可在线咨询获取产品开发方案和报价>

业务域名?? ??JS接口安全域名?? ??网页授权域名
微信客服二维码

加客服微信获取更多内容