ThinkLink 批量导入设备前检查什么：身份、模板与更新范围

先区分新增与更新

批量导入并非只会新增设备。当前文档说明，相同 EUI 已存在时更新设备参数，不存在时才新增，因此每行身份必须先与目标组织的现有记录核对。名称相同不代表同一设备，名称不同也不能抵消 EUI 相同带来的更新行为。制作清单时明确本批新增数量、更新数量和预期修改字段，并把 EUI 列按文本处理，保留前导零和完整内容。不要将现场序号、资产编号或网关 EUI 误填成端设备 EUI，也不要凭导入后的总数量判断每行都按预期处理。

使用当前模板并缩小列范围

从目标版本的正式导出功能获取样例，再按文档填写 EUI 和需要变更的列，删除本次不修改的列。不要把旧表中大量空白字段当成“保持原值”，因为缺列、空值和默认值可能有不同含义。先查清具体字段规则，再用测试记录验证。导入文件若包含 LoRaWAN 密钥，应按凭据管理，避免放进公开资料或客户演示截图。设备记录和 LoRaWAN 档案属于不同对象，两者用途与必填项不同，不要把完成设备导入当作入网鉴权也已准备完成。

提前验证位置与模板

设备导入的 location_code 必须引用已存在的位置；文档说明无效编码会使位置为空但继续导入，所以成功提示不是位置关联正确的证据。模板也要先核对物模型、RPC、属性和转发规则。尤其“通过模板重置”会覆盖一组配置，不能当作普通增量更新使用。旧模板缺少转发规则时，重置后可能回到默认不转发。建议选择一台已配置测试设备和一条新记录，分别演练更新与新增，确认其他绑定和业务参数保留情况后再决定正式批次。

分批提交并逐项回读

将设备按型号或配置差异分组，每组先验证一个小样本。提交前记录目标 EUI、预期字段值和现值，提交后从设备详情或正式接口重新读取，检查身份、位置、模型及本次变更内容。遇到超时或不明确的结果，先查现状和导入反馈，再判断哪些行需要处理；不要直接重传整个文件，以免已成功部分再次覆盖。批量修改参数中的勾选字段与导入表格的列规则也不完全相同，应分别按当前操作说明使用，不能把一种操作的行为推断到另一种操作。

1. 按 EUI 标记新增和更新记录。
2. 删除本次不修改的列并检查模板。
3. 用小样本覆盖新增与更新两种情况。
4. 回读后再处理失败记录和后续批次。

交付变更清单而非成功截图

保留批次名称、执行时间、使用的模板版本、成功与失败记录以及回读结果。导出文件可以辅助恢复配置，但不应宣传为设备历史、所有关联与密钥的完整系统备份。若只修改名称或位置，验收重点是这些配置及查询范围；若同时改动模型，则补做一条真实上报的解析验证。若发现意外覆盖，应先停止后续批次并对比现值，按照已确认的恢复方案处理。这样的交付能让运维人员准确知道本次改变了什么，而不是只看到一个没有对象明细的成功提示。