常见问题

最近更新时间:2025-12-04 17:25:32

我的收藏

一键接入小程序后,是否还需要小程序发版?

不需要小程序发版,不需要修改小程序代码,小程序流量将按照您的配置接入小程序加速网关,受小程序加速网关微信私有链路保护和优化。

如果接入的小程序流量大于小程序加速网关套餐规格,超出的流量怎么处理?

对于一键接入的小程序,超出的流量将走原业务公网链路,不再受小程序加速网关微信私有链路保护和优化,建议升级小程序加速网关套餐,小程序加速网关不会阻塞或丢弃正常的小程序流量。对于手动接入的小程序,超出的请求将返回错误码。

为什么接入业务配置后,小程序对应的版本访问还是原生链路,没有走安全链路?

小程序加速网关链路生效一般在1分钟之内,如果用户正在访问该小程序,则需要等待下一次启动打开才可以。如果开发者测试验证,则建议退出微信后台,重新进入再试。如果仍然不可以,则删除掉小程序然后重新加载尝试(删除掉小程序主要是清除缓存)。

接入小程序后,经过小程序加速网关的请求耗时明显增加了?

小程序加速网关接入地域与小程序服务端部署地域存在跨域情况,导致因请求跨域而耗时增加。目前小程序加速网关当前支持选择北京、上海、深圳、中国香港4个地域。为避免远距离跨域而导致请求耗时延长,请就近选择接入网关地域。例如,小程序服务端部署在深圳,请选择深圳地域;小程序服务端部署在沈阳,请就近选择北京地域。
业务请求带宽超出套餐版本的带宽额度,可前往查看 监控视图,并调整业务请求回包大小,以避免带宽超额。

手动接入有什么局限性?

手动接入请务必自行将网关域名添加到 request 合法域名中,否则网关将触发链路切换,导致请求变慢或出现异常。
手动接入时无法使用如下网关能力:原生加解密优化,网关性能根据业务场景,会有一定影响。
如果网关到期或者超过流量限制,会进入 fail 回调,需要开发者手动处理。

常见错误码

errCode
说明
102003
触发用户频率限制
102006
非法请求
102016
路由错误。请求地址不在微信网关的小程序 URL 里
102020
触发微信网关套餐 QPS 限制
102021
触发微信网关套餐带宽限制
102022
请求地址不在微信网关的小程序 URL 里,或本地网关配置版本较低
104100
请求重放拦截
-601001
系统失败
-601008
请求超时
-601069
微信网关访问源站时连接失败