CSV 导入出问题，不要只盯数据库，很多错位在读文件那一步就已经发生了。
一、表头异常：fgetcsv() 读到的第一列可能带 BOM
很多后台导入功能，测试用手写 CSV 一切正常，用户拿 Excel 导出的文件一传，字段映射就乱了。最常见的原因之一，是文件开头带了 UTF-8 BOM。
它肉眼看不见，但会混进第一列表头里。你以为表头是 name，程序拿到的可能是带隐藏字符的 name，数组映射自然对不上。
处理方式可以放在读第一行时：
$header = fgetcsv($handle);
if ($header !== false && isset($header[0])) {
$header[0] = preg_replace('/^/', '', $header[0]);
}
导入功能建议别直接相信表头。读完表头后，先和系统要求的字段做一次比对，字段缺失、重复、未知列都给出明确提示。
二、分隔符问题：separator 不一定是英文逗号
fgetcsv() 默认按逗号拆列，但真实文件不一定这么规矩。欧洲地区导出的 CSV 经常用分号，某些系统导出会用制表符。结果就是一整行被读成一列。
如果你能从业务上确定格式，就把参数显式写出来：
while (($row = fgetcsv($handle, 0, ';', '"', '\')) !== false) {
// 处理每一行
}
这里几个参数别含糊：
· separator 是字段分隔符，比如 , 或 ;。
· enclosure 是包裹字段的字符，常见是双引号。
· escape 建议显式传入，别依赖默认值。
使用 qbo-mileage CLI 及用户凭证，从 Airtable、Outlook 或 Google Calendar 记录生成 QuickBooks Online 里程 CSV 文件。
后台可以做一个小检测：读前几行，如果每行都只有一列，提示用户检查分隔符，而不是继续导入。
三、脏数据拦截：空行、列数异常、编码都要记录
fgetcsv() 读到文件结束会返回 false，但空行不是同一件事。空行可能返回包含单个 null 字段的数组，直接入库就会污染数据。
导入时我会先做一层行级校验：
if ($row === [null] || count($row) !== count($header)) {
$badRows[] = $lineNumber;
continue;
}
还要注意编码。用户上传的 CSV 可能是 GBK，页面和数据库通常用 UTF-8。如果中文导入后变乱码，先确认文件编码，再考虑转换。
实操上建议这么做：
· 预览前 5 行，让用户确认字段是否对齐。
· 记录跳过的行号和原因。
· 大文件分批处理，不要一次性读进内存。
· 导入失败不要只提示“格式错误”，要给出具体行号。
CSV 导入最怕悄悄错位。读文件、识别分隔符、清洗空行这几步做扎实，后面的数据库逻辑才靠得住。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
