应分批+事务+选对方法：数据需清洗则用saveAll(['validate'=>false])，纯搬运用insertAll()；每批200–400条，用array_chunk切片；必须Db::transaction包裹，避免数据残缺。
你需要把几千条用户数据一次性导入 MySQL 数据库，但直接用循环逐条 save() 会导致超时、内存爆掉、插到一半失败——问题不在数据量本身，而在没选对方法、没分批、没包事务、没关验证。
先选对方法：saveAll() 还是 insertAll()
模型层逻辑强（要验证、要事件、要自动时间戳）就用 saveAll()；纯数据搬运、字段已对齐、不走模型逻辑，直接上 Db::name('table')->insertAll($data)。
saveAll() 会读取模型配置、触发 before_write 钩子、走验证器——若数据已清洗干净，加 ['validate' => false] 能提速 30% 以上；insertAll() 不查模型、不初始化验证器，内存占用低，适合日志归档、后台导入等场景。
两者都不支持自动类型转换（如把字符串 '2026-04-24' 转成日期），字段值必须是数据库能直接受纳的格式。
立即学习“PHP免费学习笔记（深入）”；
必须分批：200–400 条/批才安全
别信“越多越好”。MySQL 默认 max_allowed_packet=4M，按平均每行 200 字节算，500 条就逼近极限；PHP CLI 下内存也容易爆。
超量的典型报错是：Packets larger than max_allowed_packet are not allowed，或者 PHP 报 Allowed memory size exhausted。
用 array_chunk($data, 400) 主动切片，别依赖框架自动分批。
Web 请求中严禁一次性处理 >1 万条——Nginx 默认超时 30 秒，应改用队列（如 think-worker）；CLI 脚本记得加 set_time_limit(0) 和 gc_collect_cycles()，尤其循环处理多批次时。
事务包裹是硬要求
批量写入中途出错，默认是“前面成功、后面失败”，数据残缺且无法回滚。不加事务的 insertAll() 就是埋雷。
正确姿势只有一种：Db::transaction(function () use ($chunks) { foreach ($chunks as $chunk) { Db::name('user')->insertAll($chunk); } });。异常时自动回滚，不用手动写 rollback()。
别在事务里调外部 API、发邮件、写文件——锁表时间拉长，高并发下极易阻塞其他请求。
字段映射与常见错误避坑
方法一：用 saveAll() 时，确保二维数组键名与数据库字段完全一致；若字段名不一致，需显式传 field 参数映射，例如 $model->saveAll($data, ['field' => ['excel_name' => 'name', 'excel_age' => 'age']])。
方法二：用 insertAll() 时，字段名必须严格匹配数据库列名——模型里的 type 映射、json 类型自动序列化等功能全部失效。
常见错误是混用：比如在 insertAll() 里传带 id 的数组却没建唯一索引，结果重复插入失败；或在 saveAll() 里传了非法字段名，触发模型验证直接报错中断。
Excel 导入时最容易漏掉的三件事：不是读完 Excel → 组数组 → insertAll() 就完事。
