TP-Link普联商云添加设备常见报错可能原因及排查指导.pdf

问题介绍

通过手机APP或者商云WEB平台，输入设备ID/MAC/扫描二维码等方式添加设备时候出现报错，导致无法成功添

加设备到商云平台管理。请根据错误提示的内容参考下文解决。

商云添加错误提示：”设备不在线”

在添加时候报错设备不在线，属于设备端无法连接TP-LINK的云服务器的常见报错，常见原因及排查：

1、设备未启用云管理功能导致无法连云

检查设备的WEB页面查看是否正常开启了设备的云管理功能，如果没有需要将设备的云管理功能配置开启。

2、设备没有正确的配置网络参数导致无法连接云平台

路由器需要查看WAN口的网关是否填写正确，WAN口是否正常配置了DNS服务器IP地址；

AC控制器、二层交换机（2/3系列）以及FATAP等设备需要在接口配置页面确认填写了正确的IP地址网关地址以

及DNS信息；

三层交换机需要确认管理VLAN配置正确的IP地址，有正确配置全0的静态路由，以及DNS服务器；

我们还可以通过设备的诊断工具Ping外网测试看看连通性，需要保障设备能够正确访问外网，如果以上几点排查

都正确，诊断工具依旧无法通外网，建议排查前端网络的限制情况。

3、设备的DNS服务器IP无法正常解析到云平台域名

如果以上参数排查都正常，诊断工具也可ping通外网，则可能的特定的DNS服务器无法解析云平台的域名，可以

尝试修改设备的DNS服务器为常用的DNS服务器，比如223.5.5.5/119.29.29.29等。

商云添加错误提示：“设备从未连接过云“

设备从未连过云的报错，属于设备出厂状态下没有接入网络，云端没有设备的任何连云记录，需要从以下几个方面

排查：

设备为出厂状态

对于刚拆箱上电的设备，设备还未任何配置，需要登录设备页面配置用户名密码完成初始化，然后配置相关设备联

网的参数，确认设备云管理功能是开启状态，保障设备自身可以连接云平台网络。

设备自身联网异常

参考以上报错“设备不在线”几个方面排查，确认设备自身的参数可以正常连接互联网。

商云添加错误提示：“用户不存在“

商云输入的用户名和设备本地的登录用户名不一致，建议检查两处的用户名确保本地用于登录设备的用户名和商云

添加设备使用的用户名一致。

商云添加错误提示：“请求参数非法“

设备出厂状态下不能通过MAC地址添加设备，如果使用MAC地址添加设备会报错请求参数非法；建议将设备本地

登录设备配置用户名密码后完成初始化后再通过MAC地址添加，出厂状态下添加可以使用设备底部标签的Device

ID或者扫描二维码添加。

商云添加错误提示：“无效密码“

当商云添加设备页面输入的密码和设备本地的密码不匹配会有此报错，请核对商云添加时候的密码和设备本地密码

是否一致。

商云添加错误提示：“设备已经绑定到项目“

当设备已经添加到其它项目中时候会有此报错，如果知道设备绑定在对应的项目账号下，可以登录此账号管理设备。

如果不知道设备已绑定的账号，可以通过登录设备本地的WEB界面关掉云管理再开启云管理来解绑，也可通过复

位设备来解绑原项目。

商云添加错误提示：“无法通过MAC或者SN找到设备“

在添加设备时候如果错误输入了设备的MAC地址或者DeviceID会出现此报错，需要准确核对填写的参数和设备底

部标签的参数是否一致，如不一致需要保障和设备底部参数一致。