CSV：常见错误
CSV 导入失败的常见原因、产品提示与处理方式。
integrationcsv
受众：机构管理员 / 教务 · 适用：SaaS / 私有
目标：根据校验或批次错误快速修正文件。
错误对照表
| 现象 / 提示 | 可能原因 | 处理 |
|---|---|---|
| 邮箱已存在 | 同机构重复账号，或历史导入残留 | 改邮箱；确认是否本应更新已有账号 |
| 邮箱格式无效 | 含空格、中文符号、缺 @ | 清理格式后重导 |
| 班级代码无效 / 找不到班级 | 班级未创建，或代码大小写/空格不一致 | 先导班级；统一代码 |
| 角色不匹配 | 填了模板不允许的值 | 按模板枚举修改 |
| 必填为空 | 漏填或列错位 | 检查是否改动了表头或合并了单元格 |
| 编码乱码 | 非 UTF-8 | 另存为 UTF-8 CSV 后重传 |
| 密码不符合策略 | 过短或含非法字符 | 按策略修改初始密码列 |
| 成员关系失败 | 人已存在但班级代码错，或人尚未导入 | 按「班 → 人 → 成员」顺序重来 |
| 权限不足 | 当前管理员角色只读 | 换 owner/admin 角色账号操作 |
界面具体文案可能略有差异，以批次详情中的行级错误为准。
排查顺序
- 先看 行号，只改失败行。
- 确认没有改表头。
- 确认导入类型与文件内容匹配（勿用学生文件选老师类型）。
- 小样本验证通过后再全量。
仍失败时请提供
- 导入批次号
- 导入类型
- 脱敏后的 1～2 行样例（去掉真实姓名电话可保留）
- 完整错误原文