云简网络配置微信公众号认证配置

参考2.7 微信公众号认证

https://www.h3c.com/cn/d_202512/2714211_30005_0.htm

登录微信公众平台在原有IP白名单的基础上增加以下IP地址，

IP地址明细：

40.73.22.36，40.73.30.73，40.73.24.183，40.73.22.84，40.73.23.226，101.36.161.141，101.36.161.143，101.36.161.146，101.36.161.135，101.36.161.120，101.36.161.81，101.36.161.145，101.36.161.154，101.36.161.137，101.36.161.44。

# 云简网络微信公众号认证，弹窗【白名单配置错误】完整排错

>
> 报错根源：**不是在 AP / 网关设备上配白名单！是微信公众号后台，必须填入【云简平台公网出口 IP】作为 IP 白名单**。云简是云端 Portal，是云简的云端服务器去调用微信接口，不是本地设备公网 IP。

## 1、公众号硬性前提条件（不满足直接报错）

1. 必须是**已认证的微信服务号**；订阅号（无论是否认证）**不支持微信公众号 WiFi 认证**，直接报白名单错误。
2. AppSecret 必须已经启用复制正确，复制不要带空格换行。

## 2、获取云简平台官方出口 IP（关键）

云简网络 Portal 页面，微信公众号认证配置区域，找到【同步微信官方白名单】按钮：
✅点击按钮，会自动复制云简全部出口公网 IP 列表。

>
> 如果页面没有该按钮，查看云简帮助文档，获取云简认证服务出口 IP 段，**不要填自己 AP / 网关的公网 IP，填了也无效**。

## 3、微信公众号后台配置 IP 白名单操作路径

1. 登录【微信公众平台】→【设置与开发】→【开发】→【基本配置】→`IP白名单`【修改】
2. 将云简给出的所有公网 IP 粘贴进去，**每个 IP 单独换行，不能逗号分隔**。
3. 需要公众号管理员微信扫码确认提交保存。

>
> ⚠️注意：这里叫`IP白名单`，不是 JS 接口安全域名，很多人混淆填错位置。

## 4、云简平台页面操作

1. 公众号 AppID、AppSecret 完整粘贴，不要多余空格换行。
2. 点击【导入公众号】，再点【同步微信官方白名单】。
3. 保存，完成。弹出 “白名单配置错误” 就是微信侧 IP 白名单缺少云简云端 IP，导致云简服务器拿不到 access_token。

## 高频踩坑清单

1. ❌坑 1：填了自己防火墙 / AP 设备的公网出口 IP。云简 Portal 是云端，调用微信接口的是云简服务器，不是本地设备 IP，填本地 IP 无效。
2. ❌坑 2：用订阅号，订阅号没有该接口权限，直接报白名单配置错误，必须认证服务号。
3. ❌坑 3：IP 之间用逗号分隔，微信只识别**换行分隔**多个 IP。
4. ❌坑 4：AppSecret 复制带空格、已经重置过 AppSecret，云简页面没更新密钥。重置 secret 之后，微信旧 secret 立刻失效，云简页面必须重新粘贴新 secret。
5. ❌坑 5：公众号管理员没有扫码确认 IP 白名单修改，IP 白名单修改不生效。
6. ❌坑 6：网络 NAT 内网私网地址（192.168.x.x）填进微信 IP 白名单，微信拒绝内网 IP。

## 额外配套配置（不影响这个弹窗，但认证会失败）

微信公众号后台【公众号设置】-【功能设置】，**JS 接口安全域名填入`***.***`**；

>
> 同时云简模板高级配置，设备放通微信域名、云简域名免认证域名白名单。