thinkphp数据导入需严控文件解析、校验、批量写入与异常兜底四环节：用filesystem安全存文件，按类型（excel/csv）差异化解析并编码转换，动态映射字段+清洗数据，分批insertall插入，失败时精准定位错误并回滚清理。
ThinkPHP 实现数据导入接口，核心不是“写个上传就完事”，而是要控制文件解析、数据校验、批量写入和异常兜底这四个环节。直接用 insertAll 往数据库塞 Excel 表格原始行，90% 的线上事故都出在这一步。
上传后怎么安全保存临时文件
别用 copy() 或 move_uploaded_file() 手动挪文件——路径拼错、权限不足、Windows/Linux 斜杠不一致都会导致失败。ThinkPHP 6 推荐走 Filesystem 统一管理：
-
Filesystem::disk('public')->putFile('import', $file)自动处理命名、目录创建、唯一性； - 返回的是相对路径（如
import/20260425/xxx.xlsx），需再调用path()拿到绝对路径供后续读取； - 如果项目禁用了
public磁盘，必须先在config/filesystem.php中配好，否则putFile返回 false 且无提示； - 上传后立刻验证文件头（magic number），仅靠后缀名（
.xlsx）判断类型不安全，恶意用户可伪造后缀绕过。
Excel 和 CSV 解析不能混用同一套逻辑
PhpSpreadsheet 读 Excel 是对象式操作，fgetcsv 读 CSV 是流式逐行，二者内存占用、错误表现、编码处理完全不同：
- Excel：用
IOFactory::load($filePath)，但必须捕获\PhpOffice\PhpSpreadsheet\Reader\Exception，比如加密 Excel 或损坏文件会直接抛出而非返回空数组； - CSV：用
fopen($filePath, 'r')+fgetcsv()，注意默认分隔符是逗号，遇到含逗号的字段（如地址）会错位，应显式传入str_getcsv($line, ';', '"')； - 编码统一用 UTF-8：Excel 文件本身可能存为 ANSI（Windows 默认），读出来是乱码，需在
toArray()前调用$worksheet->getDefaultColumnDimension()->setWidth(15)无用，真正有效的是设置读取器编码：$reader->setReadDataOnly(true); $reader->setLoadAllSheets();并在 PHP 层用mb_convert_encoding()转； - CSV 行末可能有空行或 BOM 头，
fgetcsv会返回false或空数组，需过滤：if (empty($row) || $row === [null]) continue;。
批量插入前必须做字段映射和数据清洗
Excel 表头可能是中文（“姓名”、“邮箱”），数据库字段却是 name、email，硬编码下标（$row[0]）极不可靠：
- 先取首行作为表头：
$header = array_shift($rows);，再建立映射数组：$map = ['姓名' => 'name', '邮箱' => 'email']； - 对每行执行
array_combine($header, $row)转成关联数组，再用array_intersect_key()提取目标字段； - 数值类字段（如年龄、金额）必须强制类型转换：
'age' => (int)$data['年龄']，否则 MySQL 可能存成 0； - 空字符串、
null、"N/A"要统一转成数据库允许的默认值（如NULL或''），避免触发 NOT NULL 约束失败； - 别在循环里调
insert()，哪怕加了事务，1000 行就是 1000 次 SQL 请求，超时风险极高；坚持用insertAll()，但单次不超过 500 行，大文件拆成批次。
导入失败时日志和回滚必须到位
用户看到“导入失败”毫无意义，开发查不到哪一行、哪个字段、什么错误，等于没做异常处理：
- 用
try...catch包住整个流程，捕获\think\exception\PDOException、\PhpOffice\PhpSpreadsheet\Reader\Exception、InvalidArgumentException三类； - 记录详细上下文：
Log::error('导入失败，文件：'.$filePath.'，第'.($i+1).'行，原始数据：'.json_encode($row))； - 数据库写入中途失败，必须手动
Db::rollback()，否则部分数据已落库，下次重试会重复； - 临时文件不能留着：无论成功失败，最后都要
Filesystem::disk('public')->delete($path)，否则磁盘迟早被占满； - 前端返回结构要带具体错误位置，例如：
['code'=>1001, 'msg'=>'第5行邮箱格式错误', 'row'=>5, 'field'=>'email']，而不是笼统的“数据格式不正确”。
最常被跳过的其实是「字段映射动态化」和「错误行精准定位」——多数人图省事用下标取值，结果 Excel 列序一调，全表数据错位入库，还查不出问题在哪。真要稳，就得把表头识别、字段校验、错误标记做成可配置的模块，而不是写死在控制器里。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
