必须人工核对Excel第一行是否为纯文本标准表头，再硬编码中文表头到英文字段的严格映射，逐列校验转换类型后，在事务中批量插入。
ThinkPHP导入Excel时，表头是“客户姓名”“下单日期”“是否VIP”，而数据库字段却是customer_name、order_at、is_vip，不手动建立映射就会插错列或报SQL错误。
确认Excel第一行为标准表头
打开Excel文件，确保第1行是纯文本表头（不能合并单元格、不能有空行、不能含公式），且每个单元格内容唯一、无前后空格。若第1行被误设为数据行，后续映射将整体偏移——【必须人工核对，不可依赖自动探测】。
用PhpSpreadsheet读取后，调用$worksheet->rangeToArray('A1:'.$lastColumn.'1')提取表头数组，打印出来验证是否与预期一致。
硬编码中文→英文字段映射规则
在导入逻辑开始前，定义一个严格的一对一映射数组，键为Excel表头原文，值为数据库字段名：
立即学习“PHP免费学习笔记（深入）”；
$headerMap = [
'客户姓名' => 'customer_name',
'下单日期' => 'order_at',
'是否VIP' => 'is_vip',
'手机号' => 'mobile'
];
注意：键名必须与Excel中实际显示的汉字完全一致（包括标点、空格），哪怕只差一个全角/半角符号都会匹配失败。
不要用array_flip()反向生成，也不要尝试用strtolower()统一转小写——中文不适用。
逐列校验并转换数据类型
遍历每一行数据时，对每个字段执行三步操作：
Excel/WPS 公式大师。用大白话描述需求，直接给出可用的公式、函数组合和数据处理方案，并解释每一段的作用。当用户提到"Excel 公式"、"表格函数"、"VLOOKUP 怎么用"、"XLOOKUP"、"LET"、"LAMBDA"、"动态数组"、"这个公式报错了"、"#N/A"、"#REF!"、"
① 用表头值查$headerMap，获取目标字段名；若查不到，跳过该列或抛出异常提示“Excel列【xxx】未配置映射”；
② 根据目标字段类型做清洗：字符串trim()去空格；日期列用\PhpOffice\PhpSpreadsheet\Shared\Date::excelToDateTimeObject()转为DateTime对象；布尔类字段（如“是/否”“Y/N”）统一转为0或1；
③ 将清洗后的值存入临时数组，键为目标字段名，例如['customer_name' => '张三', 'order_at' => $dateTimeObj, 'is_vip' => 1]。
这一步不能省略清洗——Excel里看似是数字的“123”，可能实际存储为文本格式，直接入库会触发类型不匹配错误。
事务内批量插入并绑定映射后数据
使用ThinkPHP Db::transaction()包裹插入逻辑，每批100条提交一次：
Db::name('orders')->insertAll($mappedRowsBatch);
插入前必须用Schema::getFields('orders')检查目标表字段是否存在，避免因字段名拼写错误导致整批失败。
若某批次插入失败，事务会自动回滚，但已移动的Excel文件不会自动删除——【需在catch块中手动unlink($filePath)】。
