使用SpartnerNL/Laravel-Excel批量导入CSV到数据库遇问题

针对你使用SpartnerNL/Laravel-Excel扩展时多文件导入失败的问题，结合提供的代码，以下是具体排查点和修复方案：

1. 表单文件输入name属性错误（核心问题） #

你的Blade表单中，文件输入的name属性为file，但开启multiple多文件上传时，必须将name设置为file[]，否则后端无法正确接收文件数组：

修正后的表单代码：

<form action="{{ route('admin.statements.importStatement') }}" method="POST" enctype="multipart/form-data">
{{ csrf_field() }}
     <div class="p-6 text-center">
          <!-- 把name="file"改为name="file[]" -->
          <input id="file" type="file" accept=".csv, application/vnd.openxmlformats-officedocument.spreadsheetml.sheet, application/vnd.ms-excel" multiple name="file[]">
          <button type="submit" >Import</button>
     </div>
</form>

2. 控制器代码增加合法性校验 #

修改控制器代码，先判断是否接收到有效文件数组，避免空循环或报错：

public function importStatement(Request $request) 
{
    // 校验是否有上传文件，且是数组格式
    if (!$request->hasFile('file') || !is_array($request->file('file'))) {
        return back()->withErrors('请选择至少一个文件');
    }

    foreach ($request->file('file') as $file) {
        // 校验单个文件是否有效
        if ($file->isValid()) {
            Excel::import(new StatementsImport, $file);
        }
    }
               
    return back()->with('success', '所有文件导入完成');
}

3. 排查StatementsImport类的状态残留问题 #

如果上述修改后仍失败，检查你的StatementsImport类是否存在状态污染：

• 若导入类中使用了类属性存储临时数据（如统计数、临时变量），需确保每次导入后重置这些属性，避免多文件导入时数据混乱
• 示例修复（在导入类的构造方法或beforeImport方法中重置状态）：

class StatementsImport implements ToModel, WithHeadingRow
{
    private $importCount = 0;

    public function __construct()
    {
        $this->importCount = 0;
    }

    // ... 其他导入逻辑
}

4. 添加错误捕获定位具体问题 #

为了精准定位错误，可在循环中添加异常捕获，记录或返回错误信息：

foreach ($request->file('file') as $index => $file) {
    try {
        if ($file->isValid()) {
            Excel::import(new StatementsImport, $file);
        }
    } catch (\Exception $e) {
        // 记录错误日志，或返回前端提示
        \Log::error("第{$index+1}个文件导入失败: " . $e->getMessage());
        return back()->withErrors("第{$index+1}个文件导入失败: " . $e->getMessage());
    }
}

5. 服务器配置检查 #

• 确认php.ini中的upload_max_filesize、post_max_size参数足够大，支持多文件总大小
• 检查max_execution_time，避免大文件导入时因超时失败

内容的提问来源于stack exchange，提问作者KrutSednar