文档产品文档
数据导入导出功能说明
导入导出是数据交换的主要手段。本文说明导入的校验机制、导出的大数据处理、模板管理与安全控制。
百百华产品团队2026-08-28阅读 129有用 22
模块定位
导入导出功能支撑数据初始化、批量维护和数据交换。
导入功能
导入流程
上传文件 → 校验 → 预览 → 确认导入 → 结果报告
"预览"环节很重要：让用户在真正写入前看到会导入什么，避免误操作。
校验机制
| 层次 | 内容 |
|---|---|
| 格式校验 | 文件类型、列数、表头 |
| 数据校验 | 必填、类型、范围、唯一性 |
| 业务校验 | 引用完整性、业务规则 |
| 权限校验 | 是否有导入权限、数据范围 |
校验失败时，应给出明确的错误行号和原因，而不是笼统的"导入失败"。
示例输出：
| 行号 | 问题 |
|---|---|
| 15 | 物料编码 M0012 已存在 |
| 23 | 计量单位不能为空 |
| 41 | 工艺路线 XX 不存在 |
导入模式
| 模式 | 说明 |
|---|---|
| 仅新增 | 已存在的跳过或报错 |
| 仅更新 | 不存在的跳过或报错 |
| 新增或更新 | upsert 模式 |
| 覆盖 | 先删后加（危险） |
"覆盖"模式要谨慎，容易误删数据。建议默认用"新增或更新"。
事务与回滚
| 策略 | 说明 |
|---|---|
| 全量事务 | 全成功或全失败 |
| 分批事务 | 每批独立提交，部分成功 |
建议用分批事务，尤其数据量大时。全量事务失败后要全部重来，体验差。
但要给用户明确的结果：成功多少条、失败多少条、失败原因。
导出功能
导出格式
| 格式 | 优点 | 缺点 |
|---|---|---|
| CSV | 体积小、通用 | 无格式、需注意编码 |
| Excel | 有格式、易读 | 体积大、行数限制 |
| 版式固定 | 不便二次处理 |
CSV 要注意编码：中文用 UTF-8 with BOM，否则 Excel 打开乱码。
大数据量导出
单次导出行数有限制（建议 5 万行内）。超过则用异步导出：
- 用户提交导出请求
- 后台生成文件
- 生成完成后通知用户
- 用户下载
异步导出能避免请求超时，是大数据量导出的标准做法。
导出内容控制
| 控制项 | 说明 |
|---|---|
| 字段范围 | 按角色隐藏敏感字段 |
| 行数限制 | 单次最大行数 |
| 频率限制 | 防止大量导出 |
| 留痕 | 记录谁导出了什么 |
导出必须留痕。数据导出是数据泄露的主要途径。
模板管理
导入模板要集中管理：
| 要求 | 说明 |
|---|---|
| 统一版本 | 避免用旧模板导致失败 |
| 提供下载 | 用户从系统下载最新模板 |
| 内嵌校验 | 模板里带条件格式校验 |
| 示例数据 | 含示例行 |
| 说明页 | 字段说明和填写要求 |
"模板里带校验"能大幅降低导入失败率。
安全控制
| 风险 | 措施 |
|---|---|
| 越权导出 | 校验数据权限 |
| 敏感数据泄露 | 字段级脱敏 |
| 大量导出 | 频率和行数限制 |
| 恶意文件 | 上传文件类型校验、病毒扫描 |
| 公式注入 | 导出时转义 csv 中的 = + - @ 开头内容 |
"公式注入"容易被忽略：如果导出的 csv 里某个字段以 = 开头，Excel 打开时会当公式执行，可能造成风险。
处理方式：给这类字段值前加单引号或空格。
常见问题
| 问题 | 原因与处理 |
|---|---|
| 导入失败 | 见"数据导入失败的常见原因" |
| 导出乱码 | 用 UTF-8 with BOM |
| 导出超时 | 改用异步导出 |
| 导入部分成功 | 查看错误报告，修正后重新导入失败部分 |
使用建议
- 大变动前先备份
- 先用小批量测试（10 条）
- 关注错误报告，不要忽略部分失败
- 导入后核对条数
- 不要用导出-修改-导入的方式做批量更新，容易出错（建议用专门的批量更新功能）
导入模板清单与导出权限配置，[待补充：产品团队补齐]。
这篇内容对你有帮助吗？
当前为游客态，投票按设备去重