CSV：常見錯誤
CSV 導入失敗的常見原因、產品提示與處理方式。
integrationcsv
受眾：機構管理員 / 教務 · 適用：SaaS / 私有
目標：根據校驗或批次錯誤快速修正檔案。
錯誤對照表
| 現象 / 提示 | 可能原因 | 處理 |
|---|---|---|
| 信箱已存在 | 同機構重複帳號，或歷史導入殘留 | 改信箱；確認是否本應更新已有帳號 |
| 信箱格式無效 | 含空格、中文符號、缺 @ | 清理格式後重導 |
| 班級代碼無效 / 找不到班級 | 班級未創建，或代碼大小寫/空格不一致 | 先導班級；統一代碼 |
| 角色不匹配 | 填了範本不允許的值 | 按範本枚舉修改 |
| 必填為空 | 漏填或列錯位 | 檢查是否改動了表頭或合併了單元格 |
| 編碼亂碼 | 非 UTF-8 | 另存為 UTF-8 CSV 後重傳 |
| 密碼不符合策略 | 過短或含非法字符 | 按策略修改初始密碼列 |
| 成員關係失敗 | 人已存在但班級代碼錯，或人尚未導入 | 按「班 → 人 → 成員」順序重來 |
| 權限不足 | 當前管理員角色只讀 | 換 owner/admin 角色帳號操作 |
介面具體文案可能略有差異，以批次詳情中的行級錯誤為準。
排查順序
- 先看 行號，只改失敗行。
- 確認沒有改表頭。
- 確認導入類型與檔案內容匹配（勿用學生檔案選老師類型）。
- 小樣本驗證通過後再全量。
仍失敗時請提供
- 導入批次號
- 導入類型
- 脫敏後的 1～2 行樣例（去掉真實姓名電話可保留）
- 完整錯誤原文