系统一切正常,就是没人收到通知?
先还原一个特别常见的场景:
店铺营业中,小程序下单、支付、骑手配送全都正常,唯独骑手接单通知、商家新订单提醒、退款通知这些微信推送一条都收不到。后台排查半天,终于发现公众号接口报错,提示 “invalid ip, not in whitelist hint”(IP不在白名单内)。
问题出在微信公众号的一个安全机制上:公众号的接口调用凭证(access_token)只能用 AppSecret 换取,而微信规定,只有 IP 白名单内的服务器才有权限发起这个请求。海狐外卖系统要代替你的公众号给骑手、商家发消息,就必须先把服务器的 IP”报户口”——加进你公众号的白名单。没加、加错、或者加漏了,微信一律拒绝,消息自然全军覆没。
好消息是:配置一次,长期有效。这篇文章把完整的操作步骤拆开讲,跟着做五分钟内就能搞定。
配置 IP 白名单的完整步骤
第一步:登录微信公众平台
用电脑浏览器打开 mp.weixin.qq.com,用公众号管理员或运营者的微信扫码登录。
这里提醒一句:这一步需要公众号管理员配合。如果你是商家,建议直接把这篇文档转发给当初注册公众号的那个人,让他照着操作,比自己摸索快得多。
第二步:进入基本配置页面
登录后,在左侧菜单找到 设置与开发 → 基本配置(旧版界面叫”开发 → 基本配置”),进入页面后往下翻,找到 IP白名单 一栏。
第三步:发起修改
点击 IP白名单右侧的 “修改”,微信会弹出二维码,要求管理员扫码确认身份。这一步是微信的防篡改机制,确保只有管理员本人能改白名单。
第四步:填写海狐服务器 IP
扫码通过后进入编辑状态,在输入框中依次填入以下四个 IP,每个 IP 单独占一行,用回车键换行:
47.103.52.223
101.132.248.63
47.99.169.174
47.96.190.162
有两个细节千万不要忽略:
- 原有的 IP 不要删。 白名单是”允许名单”,多填不会让系统变危险,漏填才会让对应的服务掉线。如果你之前填过自己服务器的 IP,保留它们,把上面四个追加在下方即可。
- 一个 IP 一行。 四个 IP 之间用回车分隔,不要写成一长串,也不要用逗号或空格连写,微信会把整行识别成一个非法地址,保存时直接报错。
第五步:保存并验证
确认无误后点击保存,页面提示成功即配置完成。回到海狐外卖系统后台,重新触发一次消息推送——可以下一笔测试订单,或者重新保存一次公众号配置。骑手和商家能正常收到微信通知,就说明这条”神经”彻底通了。
配置前后的几个提醒
- 需要管理员权限:运营者微信号通常也能扫码确认,但如果公众号开启了安全保护、仅限管理员操作,就需要管理员本人到场。
- 修改次数有限:微信官方对 IP 白名单的修改次数有限制,不适合频繁改动。建议一次把四个 IP 全部填全,避免来回折腾。
- SaaS 版与独立部署的区别:SaaS 版本统一使用上面四个 IP;独立部署的客户,填的是自己服务器的公网出口 IP(可以在服务器上执行
curl ifconfig.me查看),按自己实际情况填写。 - 保存后即时生效:不需要重新审核,也不需要重启服务,保存后新的接口调用就按新白名单校验。
常见问题(FAQ)
一、不配置 IP 白名单会怎么样?
公众号的模板消息、类目消息推送全部依赖接口调用,而接口凭证只能用 AppSecret 换。IP 不在白名单里,微信会返回 40164(invalid ip)错误,系统发不出任何消息。外在表现就是”后台看着一切正常,就是没人收到通知”,且这类错误不会在小程序端暴露,很容易被忽略。
二、报错 “invalid ip, not in whitelist hint” 怎么解决?
这是典型的白名单缺失或填写错误。按上面的步骤进入 基本配置 → IP白名单,核对四个 IP 是否都在、每行是否只有一个 IP,修改保存后再试。如果报错信息里给出了具体 IP,说明服务器出口 IP 可能有变化,把报错中提示的 IP 一并补进白名单即可。
三、白名单里已有的旧 IP 要删掉吗?
不要删。白名单是叠加生效的,旧 IP 留着不影响新 IP 生效。贸然删掉旧 IP,可能导致之前配置的其他服务(比如你自己开发的功能)突然失效,排查起来更费劲。
四、我是代理商,要帮很多商家配置,能批量操作吗?
不能。IP 白名单在各家自己的公众号后台里,只能逐一登录配置。建议把这篇文档转发给商家,让商家转给公众号管理员按步骤操作,一家几分钟就能完成。代理商要做的就是提醒到位、填全四个 IP。
五、白名单配好了,还是收不到消息?
先别急着重复配置,按顺序排查:第一,重新打开白名单页面,确认四个 IP 都保存成功了;第二,检查公众号的 AppID、AppSecret 在系统后台是否填写正确;第三,确认类目消息或模板消息已经配置。三步都确认无误还不行,就联系海狐技术支持,附上报错截图,我们帮你定位。
相关功能推荐
- 微信公众号绑定配置指南:AppID、AppSecret 填写与常见报错排查:还没绑定公众号?先看这篇完成基础绑定,再回来配置白名单。
- 微信公众号类目消息配置:白名单配好后,接着配置类目消息,让骑手接单、商家新订单、退款提醒自动推送到微信。
- 申请微信支付和密钥、证书等:要在公众号体系里完成收款,支付商户号的申请与密钥、证书配置也不能少。
IP 白名单说穿了只有五个动作:登录 → 基本配置 → 修改 → 填 IP → 保存。配置一次,长期受益——消息推送这条”神经”通了,整个外卖系统的自动化提醒才算真正活了过来。