微信小程序 网络
作者: --时间: 2025-05-17 20:32:38 阅读量:
微信小程序-更高效的网络通讯

1. 服务器域名配置

为了保证小程序与服务器间正常通信,需要在小程序后台进行**服务器域名配置**。具体步骤请参考官方文档。同时需要注意:

  • 只支持 HTTPS 和 WSS 协议;
  • 不允许使用 IP 地址或 localhost, 除非是小程序的局域网 IP;
  • 可以配置端口号,但请求的 URL 不能包含端口号;
  • 域名必须经过 ICP 备案;
  • API.weixin.qq.com不能作为服务器域名配置。

2. 网络请求

网络请求是小程序中重要的一部分,在使用过程中需了解以下几点:

超时时间

默认超时时间和最大超时时间都是 60s。

使用限制

最大并发数:wx.request、wx.uploadFile、wx.downloadFile的最大并发限制是10个;wx.connectSocket的最大并发限制是5个。

如果小程序进入后台运行,并且5秒内网络请求没有结束,会回调错误信息 ";fail interrupted",在回到前台之前,网络请求接口调用都无法发起。

返回值编码

建议服务器返回值使用 UTF-8 编码。对于非 UTF-8 编码,小程序会尝试进行转换,但可能会出现转换失败的情况。

小程序会自动对 BOM 头进行过滤(只过滤一个BOM头)。

回调函数

只要成功接收到服务器返回,无论statusCode是多少,都会进入success回调。请根据实际业务逻辑对返回值进行判断。

3. 常见问题

HTTPS 证书

小程序必须使用 HTTPS/WSS 发起网络请求。请求时系统会对服务器域名使用的 HTTPS 证书进行校验,如果校验失败,则请求不能成功发起。为了保证小程序的兼容性,建议开发者按照最高标准进行证书配置,并使用相关工具检查现有证书是否符合要求。

对证书的要求如下:

  • 证书必须有效;
  • 证书必须被系统信任,即根证书被已系统内置部署 SSL 证书的网站域名必须与证书颁发的域名一致证书必须在有效期内证书的信任链必需完整(需要服务器配置);
  • iOS 不支持自签名证书;
  • iOS 下证书必须满足苹果 App Transport Security (ATS) 的要求;
  • TLS 必须支持 1.2 及以上版本。部分旧 Android 机型还未支持 TLS 1.2,请确保 HTTPS 服务器的 TLS 版本支持 1.2 及以下版本。

除了网络请求 API 外,小程序中其他 HTTPS 请求如果出现异常,也请按上述流程进行检查。

跳过域名校验

在微信开发者工具中,可以临时开启开发环境不校验请求域名、TLS 版本及 HTTPS 证书选项,跳过服务器域名的校验。此时,在微信开发者工具中及手机开启调

一套系统全搞定
  • 商家管理
  • 商品管理
  • 订单管理
  • 会员管理
  • 营销中心
  • 供应链入驻
  • 财务管理
  • 支付分账
  • 商城直播
免费试用
更多产品任你选
B2B2C多用户商城系统

类天猫&京东模式系统

了解更多
B2B2B电商交易系统

全渠道订货/采购及经销商管
理数字化系统

了解更多
S2B2B电商交易系统

上下游资源整合数字化解决方

了解更多
企业集采商城系统

中大型企业数字化采购与交易
系统

了解更多
员工福利商城系统

集福利管理、发放于一体的员
工福利商城

了解更多

电话咨询 微信咨询 0元开店