物联网云平台设备批量导入怎么操作

物联网云平台主流平台如阿里云IoT、OneNET、ThingsBoard、JetLinks等，设备批量导入通用操作流程逻辑大体一致，均采用下载模板→填写设备信息→上传导入→查看导入结果流程。

而如聚英云、有人云等轻量化物联网平台，简化了设备接入云平台的方式，可直接采用输入设备ID、扫描设备唯一二维码的方式，傻瓜式操作。

一、前置准备

1. 先建好产品：批量设备必须归属同一个产品，产品下已经定义好物模型/点位、通信协议(MQTT/Modbus等)。

2. 收集设备原始信息：设备SN、MAC、设备名称、鉴权秘钥、别名、分组、位置等。

3. 文件格式：绝大多数平台只接受 CSV，少数支持xlsx;不要修改模板表头，从第二行开始填数据。

二、标准操作步骤

1. 登录平台控制台，进入【设备管理】【设备列表】。

2. 点击 批量添加 / 批量导入 / Import 按钮。

3. 下载官方模板文件，不要自己新建表格，表头字段平台强校验。

4. 打开模板填写设备信息

设备名称/DeviceName：产品内唯一，字母数字、`-_@.:`，432字符，不能中文特殊符号;

SN/MAC： 设备硬件序列号;

鉴权信息：DeviceSecret / AccessToken / MQTT账号密码(预导入存量设备需要填);

别名、分组、经纬度：选填;

> 注意：不要留中文逗号，日期、编号不要带多余空格;不要合并单元格。

5. 保存CSV，编码选 UTF8(Windows Excel保存CSV容易乱码，建议用WPS或记事本另选编码)。

6. 在弹窗上传文件，确认所属产品，执行导入。

7. 查看导入结果：

- 全部成功：直接回到设备列表查看，导出设备列表获取全部秘钥用于烧录设备。

- 部分失败：下载错误明细列表，看哪一行哪个字段非法，修正后重新导入，不要整表重复上传避免重复创建设备。

三、各平台差异要点

1. 阿里云IoT

- 入口：设备管理 → 设备 → 批量添加;两种模式：自动生成DeviceName / CSV上传自定义名称。

- 上限：普通实例单次最多1000台;尊享实例支持上万台。

- 存量设备迁移：模板可填入自定义DeviceSecret，实现预注册自有秘钥设备。

2. 中国移动OneNET

- 入口：设备接入与管理 → 设备管理 → 添加设备 → 批量添加，下载模板。

- 支持查看导入批次记录;不同协议模板字段不一样(MQTT、Modbus模板不同)。

3. ThingsBoard(开源私有化)

- 入口：EntitiesDevices → Import按钮。

- 需要手动做列映射：把CSV每一列映射到平台字段(name、accessToken、自定义属性)。

- 勾选`更新属性`：遇到重名设备会更新，不勾选则重名直接报错终止导入。

4. 聚英云(国内轻量化化IoT)

- 支持单台填写fUNID(设备唯一ID)添加。

- 支持设备二维码扫描，一键接入云平台。

四、常见踩坑与注意事项

1. 设备名称重复：同一个产品下DeviceName不能重复，导入报错最常见原因。

2. CSV乱码：Windows直接另存CSV会GBK，平台识别乱码;记事本打开csv，另存为，编码选UTF8。

3. 模板表头改动：删除、修改表头字段会直接解析失败，必须原样保留表头。

4. 秘钥保管：批量导入成功后导出设备清单妥善保存秘钥，用于设备固件配置联网，丢失无法找回。

5. 数量上限：注意平台单次导入条数限制，超量拆分多个文件分批导入。

6. 子设备网关场景：网关下子设备批量导入，部分平台需要先创建网关，再导入子设备列表。