上传excel需验证mimes和max限制，显式指定xls/xlsx/csv类型并启用fileinfo扩展；store()生成随机名，storeas()可控命名但路径须安全；导入时应传storage_path绝对路径而非临时文件对象；php和nginx配置需同步调大上传限制；withheadingrow需校验空表头。
上传前必须验证 mimes 和 max 限制
Excel 文件看似是单一类型，但实际有 xls、xlsx、csv 三种常见格式，MIME 类型各不相同。仅靠扩展名判断极易被绕过，Laravel 的 file 验证规则必须显式指定：
-
'file' => 'required|mimes:xls,xlsx,csv|max:10240'（单位 KB，这里限制 10MB） -
mimes依赖服务器的fileinfo扩展识别真实 MIME，没启用会导致所有 Excel 上传失败并报The file must be a file of type: xls, xlsx, csv. - 不要只写
mimetypes:application/vnd.ms-excel—— 它不覆盖xlsx（对应application/vnd.openxmlformats-officedocument.spreadsheetml.sheet）
store() 和 storeAs() 路径写法差异直接影响文件可读性
用 $request->file('file')->store('imports') 会生成带哈希的随机文件名，存到 storage/app/imports/ 下；而 storeAs('imports', $filename) 可控命名，但要注意：
- 路径中不能含
../或绝对路径，否则 Laravel 会抛出Symfony\Component\HttpFoundation\File\Exception\AccessDeniedException - 若后续要用
Maatwebsite\Excel\Excel::import()读取，传入的路径必须是storage_path('app/...')下的绝对路径，不是 URL 或相对路径 - 别直接用
public/uploads这类公开磁盘路径存 Excel——除非你真想让任何人拼 URL 下载原始上传文件
用 Maatwebsite\Excel 导入时，临时文件生命周期极短
很多人在控制器里先 store() 再 import()，却忽略了一个关键点：Laravel 的上传文件对象（UploadedFile）底层是临时文件，move_uploaded_file() 后原 tmp_name 就失效了。所以以下写法是错的：
$file = $request->file('file');
$path = $file->store('temp'); // ✅ 已复制到 storage
(new UsersImport)->import($file); // ❌ $file 还指向已删除的 tmp 文件！
正确做法只有两种：
- 用
import($path, 'local')，其中$path是store()返回的相对路径（如temp/abc.xlsx），且 disk 名必须匹配配置 - 或直接传绝对路径：
import(storage_path('app/' . $path))
大文件导入卡死？不是内存问题，是 PHP 的 post_max_size 和 upload_max_filesize
即使你在 Laravel 层面设了 max:10240，如果 PHP 配置里 upload_max_filesize = 2M，大于 2MB 的 Excel 会在到达 Laravel 前就被 Nginx/Apache 拦截，返回 413 Request Entity Too Large 或空白响应。
检查方式：
- 运行
php -i | grep -E 'upload_max_filesize|post_max_size' - Nginx 还需确认
client_max_body_size是否同步调大 -
set_time_limit(0)和ini_set('memory_limit', '512M')只对导入解析阶段有效，救不了上传阶段失败
最易被忽略的一点：Excel 导入类里如果用了 WithHeadingRow，但用户上传的文件第一行为空或含不可见字符（比如 BOM），toArray() 会返回空数组且不报错——得手动加 if (empty($rows)) { throw new \Exception('Excel 内容为空或表头异常'); }。
