如何在Laravel中用Query Builder实现单Excel文件导入多数据表？

阿华AIGC实验室

2026-5-9

实现无模型的多表Excel导入（结合Query Builder）

当然可以实现！Laravel Excel的导入机制支持完全自定义的数据处理逻辑，哪怕不用Eloquent模型，直接用Query Builder来插入多表数据也完全没问题。下面是具体的实现步骤和示例代码：

1. 创建自定义导入类

首先你需要生成一个导入类（Laravel Excel推荐这种方式来处理导入逻辑，比直接在Excel::import里写查询更清晰易维护）：

php artisan make:import MultiTableImport

2. 编写导入逻辑（结合Query Builder）

打开生成的app/Imports/MultiTableImport.php文件，实现ToCollection接口（这样可以获取Excel的所有行数据），然后在collection方法里用Query Builder分别插入到不同的数据表：

namespace App\Imports;

use Illuminate\Support\Collection;
use Maatwebsite\Excel\Concerns\ToCollection;
use Illuminate\Support\Facades\DB;

class MultiTableImport implements ToCollection
{
    public function collection(Collection $rows)
    {
        // 跳过Excel的表头行（如果你的Excel第一行是字段名称的话）
        $rows->shift();

        // 开启数据库事务，避免部分数据插入成功、部分失败的情况
        DB::beginTransaction();
        
        try {
            foreach ($rows as $row) {
                // 1. 插入第一个数据表（示例：users表），用insertGetId获取自增ID
                $userId = DB::table('users')->insertGetId([
                    'name' => $row[0], // 对应Excel第1列（索引从0开始）
                    'email' => $row[1], // 对应Excel第2列
                    'created_at' => now(),
                    'updated_at' => now(),
                ]);

                // 2. 插入第二个数据表（示例：orders表），关联上面的user_id
                DB::table('orders')->insert([
                    'user_id' => $userId,
                    'product_name' => $row[2], // 对应Excel第3列
                    'amount' => $row[3], // 对应Excel第4列
                    'created_at' => now(),
                    'updated_at' => now(),
                ]);

                // 如果还有更多数据表，继续添加DB::table()->insert()语句即可
            }

            DB::commit(); // 事务提交
        } catch (\Exception $e) {
            DB::rollBack(); // 出错回滚事务
            throw $e; // 抛出异常，也可以自定义错误提示
        }
    }
}

3. 在控制器中调用导入

在你的导入控制器方法里，调用Excel::import并传入刚才的自定义导入类：

use App\Imports\MultiTableImport;
use Maatwebsite\Excel\Facades\Excel;
use Illuminate\Http\Request;

public function importExcel(Request $request)
{
    // 验证上传的文件格式
    $request->validate([
        'file' => 'required|mimes:xlsx,xls',
    ]);

    // 存储临时文件并执行导入
    $tempFilePath = $request->file('file')->store('temp');
    Excel::import(new MultiTableImport, $tempFilePath);

    return back()->with('success', '多表数据导入完成！');
}

额外注意事项

列索引对应：确保$row[index]的索引和你Excel里的列顺序完全对应，比如Excel第一列是姓名就用$row[0]，别搞混顺序。

大文件处理：如果导入的Excel文件很大，建议改用ToChunkCollection接口分块处理，避免内存溢出。只需要把导入类的实现改成：

use Maatwebsite\Excel\Concerns\ToChunkCollection;

class MultiTableImport implements ToChunkCollection
{
    public function chunkSize(): int
    {
        return 100; // 每次处理100行，可根据服务器配置调整
    }

    public function chunkCollection(Collection $rows)
    {
        // 这里放之前的事务和插入逻辑
    }
}