数据导入失败的常见原因

现象

导入基础数据时报错，或者导入后数据不完整、有乱码。

四类原因

一、文件格式问题

1. 文件类型不对

模板要求 .xlsx，实际给了 .xls 或 .csv。

注意：有些系统对 .xls（老格式）支持不好，建议统一用 .xlsx。

2. 列顺序或列名被改动

用户觉得某列没用就删了，或者调整了顺序。

解决：模板列不得增删改。如果确实不需要某列，可以清空内容，但不能删除列。

3. 多了空行或空列

Excel 里常有隐藏的空行、空列。导入程序读到空行可能报错。

解决：导入前删除多余空行、空列。或者在导入程序中跳过全空行。

4. 合并单元格

合并单元格会导致读取时只有第一个单元格有值，其余为空。

解决：导入前取消所有合并，把值填满。

5. 多个 Sheet

模板只有一个 Sheet，用户复制了多个。

解决：明确只读第一个 Sheet，或要求删除多余 Sheet。

二、编码与字符问题

1. 文件编码不对

CSV 文件如果是 GBK 编码，某些系统按 UTF-8 读取就会乱码。

解决：统一用 UTF-8（带 BOM 更保险），或者明确配置编码。

2. 特殊字符

数据里包含引号、逗号、换行符时，CSV 格式会被破坏。

解决：

• 字段值用双引号包裹
• 内部的引号用两个引号转义
• 或者改用 Excel 格式而非 CSV

3. 全角半角混用

数字或标点用了全角（比如中文逗号），系统识别不了。

解决：导入前统一替换为半角。

4. 前后空格

" 物料A" 和 "物料A" 在系统里会被当成两个不同的值。

解决：导入程序要自动 trim，或者预先清理。

三、数据内容问题

1. 必填项为空

最基础也最常见。

解决：模板里做条件格式校验，空值标红。

2. 主键重复

同一文件内有两个相同的编码。

解决：用 Excel 条件格式 + COUNTIF 找出重复项。

3. 引用的数据不存在

比如 BOM 里引用了物料编码 M001，但物料表里没有 M001。

解决：按依赖顺序导入。先导物料，再导 BOM。导入前用 VLOOKUP 校验引用完整性。

4. 数据类型不符

数字列里填了文本，或者日期格式不对。

常见：Excel 里数字被自动转成了日期（比如 1-2 被识别成 1月2日）。

解决：导入前把相关列的格式设为"文本"再粘贴数据。

5. 数值超范围

比如数量填了负数、比例填了 150%。

解决：模板里加数据验证，限定取值范围。

6. 枚举值不在字典里

状态字段填了系统不认识的值。

解决：用下拉列表限定取值。

四、系统约束问题

1. 权限不足

导入账号没有导入功能的权限。

2. 数据量超限

一次导入 5 万条，超过系统限制。

解决：分批导入，每批 1000-5000 条。

3. 唯一性约束冲突

导入的数据与库里已有数据冲突。

解决：明确导入策略是"新增"还是"更新"。如果是更新，要保证主键匹配。

4. 事务超时

数据量大时事务执行时间长，超过数据库的超时阈值。

解决：分批提交事务。

排查步骤

1. 看错误提示的具体行号（好的导入功能会提示第几行出错）
2. 定位到具体行，检查该行的每个字段
3. 常见错误先排除：空值、重复、格式
4. 小批量测试：先导 10 条，成功了再导全部
5. 二分法定位：如果有问题的行不明确，取一半数据导入，逐步缩小范围

一个实用技巧

先导 10 条测通，再导全部。

很多人一上来就导 5000 条，报错了不知道从哪查。花 5 分钟先导 10 条，能提前发现 90% 的格式问题。

导入后的核对

导入成功不代表数据正确。导入后必须核对：

• 导入条数与文件条数是否一致
• 抽查若干条，字段值是否正确
• 关键字段（编码、名称）有无乱码
• 关联关系是否正确建立

建议每次导入后都做一次条数核对。少了 5 条可能意味着 5 条数据有问题被跳过了，而不是真的只有那么多。

预防：模板与工具

如果导入是常态工作（比如每周都要导），建议做几件事：

1. 模板加校验：条件格式标出错误
2. 提供预检查工具：导入前先跑一遍校验，列出所有问题
3. 错误报告：导入失败时导出错误明细，标明行号和原因
4. 导入日志：记录每次导入的时间、操作人、条数、结果

"错误报告"这一项价值最高。有了它，业务人员可以自己修正数据，不用每次都找 IT。

导入模板与校验规则，[待补充：百华智造 MES 数据导入模板与校验工具说明]。