给业务系统加 Excel 批量导入时，真正的难点通常不是“选文件”按钮，而是如何保证字段对应正确、重复数据有明确处理方式、导入到一半失败时看得懂结果。开发前先把业务表头、字段规则和重复判定写清楚，再决定采用“全部成功才入库”还是“有效行逐行导入”。
下面以把产品资料导入管理后台为例。客户数据、库存、价格、订单等业务的容错要求不同，不能把一个项目的规则直接套用到另一个项目。
一、先准备一份官方导入模板
由系统提供空白模板，并在说明页标出每列含义、是否必填、允许格式和示例。建议同时附一份不含真实客户资料的样例文件，避免每个操作人员各自改列名和顺序。
先和使用方确定以下映射：产品编码对应哪个系统字段，分类使用分类名称还是系统编号，价格含不含税，日期用哪种格式，空白单元格代表“保持原值”还是“清空”。模板发生变化时也要标注版本，旧文件不能默默按新规则解释。
二、让用户先上传预览，再确认写入
推荐流程是：选择文件 → 检查文件结构 → 预览前几行 → 展示有效行、错误行和可能重复项 → 用户选择重复处理规则 → 确认导入 → 下载错误清单。预览阶段不要已经写入正式数据。
预览至少展示系统识别出的列名、有效记录数、错误记录数和重复记录数，并允许用户看到问题所在的行号与原因。不要只弹一句“导入失败”，也不要把数百行堆在一条长错误提示里。
三、把数据规则按字段写清楚
- 产品编码：确定必填、唯一规则和大小写是否敏感；带前导零的编码应按文本处理，不能被表格自动改成数字。
- 名称和分类：限定长度；规定不存在分类时拒绝、跳过还是由管理员先维护分类，避免程序擅自新建。
- 价格和数量：明确小数位、单位和合法范围；不要把逗号分隔的文本、空值和零值混为一谈。
- 日期：确定时区及格式，检查 Excel 日期序号和日期字符串的转换规则，并拒绝不可能的日期。
- 必填信息：逐列说明空白如何处理。更新已有资料时，“未填写”可能表示不更新，也可能表示清空，必须事先确定。
系统可以帮助找出格式异常，不能猜业务含义。无法识别的字段应让用户修正模板或确认映射，不要自动把相似列名强行对应。
四、重复行必须先约定，再显示给用户
确定哪一列或哪几列组成“同一条产品”，并让用户在导入前选择符合本业务的方式：遇到重复即停止、忽略重复，或按批准字段更新。不同选项可能覆盖已有内容，更新方式必须展示将会改变的字段并由有权限的人员确认。
还要处理文件内部重复。例如同一产品编码在文件里出现两次，不能一边随机保留一行、一边报告成功。预览应明确指出两行位置及冲突字段，按已确认规则保留、合并或要求用户修正。
五、决定失败时是一条不入库，还是部分成功
两种模式都可以成立，但结果必须能解释：
- 整批模式：只要存在阻止导入的错误，就不写入任何一行；修正后重新预览。
- 逐行模式：通过验证的行可以导入，错误行保留在报告中；页面必须显示成功数、失败数和重试方式。
对于重要业务资料，可评估使用数据库事务保证一组数据要么全部写入、要么全部回滚；若需求选择逐行导入，则需清楚标记每行结果并防止重复重试造成重复数据。数据库和应用程序实现不同，应由开发者根据实际存储方式设计。
六、上传与预览也要考虑权限和文件安全
只允许经过授权的人员访问导入功能，并限制文件类型、大小、行数和处理时长。不要仅凭文件扩展名或浏览器提供的类型字符串就认定文件安全；服务端仍要按允许的格式解析并处理错误文件。含宏文件、压缩包或公式的工作簿需有明确支持边界。
导入文件可能含企业或客户资料。确认上传位置、访问人、保存期限和清理方式；临时文件处理完成后应按项目规则删除或受控保存。记录操作人、时间、文件摘要和导入结果，日志避免保存不必要的完整敏感行。
七、用边界样例验收功能
- 按模板正确填写的文件能够预览并按约定导入。
- 缺必填列、列名错误、文件为空或格式不支持时，系统指出具体原因。
- 前导零编码、日期、空值、零值和小数按照业务规则保留。
- 文件内部重复和系统已有编码重复时，按预设策略显示并处理。
- 某行有错时，页面结果符合已确认的整批或逐行模式。
- 重复点击确认、请求超时后重试，不会产生难以识别的重复写入。
- 没有导入权限的账号无法通过直接访问地址或接口执行导入。
- 失败报告包含行号和原因，但不把完整敏感数据暴露给无权限的人。
验收使用虚构样例文件，并先在测试环境演练恢复过程。拿业务现有 Excel 直接导入生产环境前，应保留原始文件、备份目标数据并明确负责人；如果系统不支持回滚，不要把“重新上传”当成恢复方案。
八、可以复制给开发者或 AI 的需求说明
我要在［后台页面］增加［资料类型］Excel 导入。请先只阅读现有项目并确认数据表、字段映射和权限入口。需求：模板版本［版本］；必填列［列名］；重复唯一键［字段］；重复处理规则［策略］；失败模式［整批 / 逐行］；预览字段［内容］；最大文件大小和行数［范围］。请先列出待确认问题、影响文件、数据备份与恢复办法、测试用例，不要直接操作生产数据。确认方案后再在测试环境实现。
文件上传应使用允许列表并在服务端校验格式与大小。可参考OWASP 文件上传安全指南。如果选用事务处理，具体数据库的回滚行为应对照对应官方文档；例如 PostgreSQL 介绍了事务提交与回滚的全有或全无特性。
本文是功能需求和验收方法示例，不构成任何系统的数据迁移承诺。涉及库存、订单、金额或客户资料时，应先与业务负责人核对字段、重复和恢复规则。