一键配网用于配置Wi-Fi模组连接上路由器，进而连入网络，开启相关网络服务。通过用户终端，如手机发送UDP广播包，广播包内容包含路由器名称、密码或其他信息。Wi-Fi模组在进入配网后，通过抓取广播包解析包内容，然后连接上路由器。
Wi-Fi一键配网通常在用户首次将智能设备加入家庭网络、用户更换家庭网络环境，或用户改变路由器名称密码等场景下使用。
一、常规原因
原因：虽然连接5G频段也可以让模块端拿到SSID和password，但是由于模块不支持5G频段，所以连接会失败。原因：信号较差的环境中，会出现丢包的情况，降低配网成功率。原因：2.4G频段，信道有1-13，如果在一个网络环境中存在很多路由器，则有可能出现配网路由器和其他路由器在同一个信道上传输数据的情况,导致丢包或者接收到太多非法数据包，导致配网失败。解决办法：将待配网路由器的信道设置为指定信道(1-13)。原因：当设备端触发配网模式之后，才会开始监听广播包。原因：设备触发配网模式之后，会有相应的指示灯状态显示，如果出现异常停止的情况，则需要重新触发。原因：配网过程中手机自动切换信号更好的网络，导致配网失败。3.2 APP端获取不到SSID和Password原因：由于安卓和IOS系统版本更新的原因，在未开启定位的情况下，APP会拿不到SSID。原因：当开启AP隔离之后，路由器不会将接收到的广播数据转发给局域网中的其它设备。原因：当路由器下只有一台用于配网的手机存在的时候，为了性能考虑，部分路由器不会将收到的广播包转发出去，导致丢包。路由器将待加入的设备的MAC加入了黑名单，导致连接失败。(一般出现在测试环境)原因：部分特殊设备不支持UDP广播，如Wi-Fi放大器。而一键配网依赖于广播包传输数据。解决办法：手机开启热点，SSID和password与待连接的路由器一致，并在配网成功之后关闭该热点。原因：部分路由器是默认关闭UDP广播功能，而关闭之后会导致发广播包失败，导致Wi-Fi设备无法获取到广播包。原因：如酒店或者火车站这种场景，由于终端设备需要使用手机号进行登录验证，否则无法连接外网。原因：大多数路由器和手机的默认编码都是UTF-8编码，但是极个别路由器的编码方式为GBK。解决办法：将路由器的SSID和PASSWORD都设置为非中文。4.9 2.4G频段和5G频段设置了相同的SSID和password原因：设置了相同的信息之后，会出现手机自动切换到5G频段的情况，导致设备配网失败。原因：目前市面上的新款路由器基本都支持2.4G频段和5G频段，而部分路由器支持'双频合一'功能,如离路由器较近，会切换至5G网络，反之会切换至2.4G网络。会导致设备出现配网失败或者频繁掉线的情况。原因：部分路由器（TP-LINK WDR5600）为了优化体验，导致网络包传输过程中出现融包问题。WPA3加密方式导致的路由器连接失败，可以将加密方式改为WPA2。
