Laravel批量导入Excel用户数据后如何批量绑定角色关联关系？

问题原因 #

User::insert() 是 Laravel 底层查询构造器提供的批量写入方法，执行后仅返回布尔值代表写入成功/失败，既不会返回写入的模型实例，也不会返回模型集合，因此无法链式调用模型定义的roles()关联方法，就是你遇到的报错根源。

另外insert方法会跳过模型的访问器、修改器、事件触发逻辑，也不会维护关联关系，所以天然不支持直接调用关联的attach方法。

解决方案 #

方案1：批量插入+批量写入中间表（推荐，性能最优，适合数据量大的场景） #

不需要逐条调用attach，直接批量写入关联表role_user即可，修改后的控制器代码如下：

public function import_student(Request $request) 
{
    $this->validate($request, [
        'file' => 'required|mimes:csv,xls,xlsx'
    ]);

    $import = Excel::toArray(new UserImport(), $request->file('file'));
    $arr = [];
    // 提前收集唯一标识用来后续查插入的用户ID，这里用nisn，你也可以换成username等其他唯一字段
    $nisnArr = [];
    // 提前拿到Student角色ID，避免重复查询
    $studentRoleId = Role::where('name', 'Student')->value('id');

    foreach($import[0] as $row) {
        $nisn = $row[1];
        $nisnArr[] = $nisn;
        $arr[] = [
            'nisn' => $nisn,
            'name' => $row[2],
            'username' => $row[3],
            'email' => $row[4],
            'kelas' => $row[5],
            'jabatan' => $row[6],
            'tempat_lahir' => $row[7],
            'tgl_lahir' => $row[8],
            'bulan_lahir' => $row[9],
            'tahun_lahir' => $row[10],
            'jenis_kelamin' => $row[11],
            'agama' => $row[12],
            'tahun_masuk' => $row[13],
            'no_telp' => $row[14],
            'password' => Hash::make($row[15]),
        ];
    }

    if(!empty($arr)){
        // 批量插入用户
        User::insert($arr);
        // 拿到所有刚插入的用户ID
        $insertedUserIds = User::whereIn('nisn', $nisnArr)->pluck('id');
        // 构造中间表批量写入数据
        $roleUserData = $insertedUserIds->map(fn($userId) => [
            'role_id' => $studentRoleId,
            'user_id' => $userId
        ])->toArray();
        // 批量写入关联表
        \DB::table('role_user')->insert($roleUserData);
    }    

    return redirect()->back()->with(['success' => '数据导入成功!']);
}

方案2：逐条创建绑定（适合数据量小的场景，代码更简洁） #

如果导入数据量不大，直接用create方法逐条创建模型，再绑定关联即可：

if(!empty($arr)){
    $studentRoleId = Role::where('name', 'Student')->value('id');
    foreach ($arr as $userData) {
        $user = User::create($userData);
        $user->roles()->attach($studentRoleId);
    }
}

额外说明 #

你当前代码中定义的UserImport实现了ToModel接口，但实际调用的是Excel::toArray()，这个方法不会触发UserImport的model逻辑，属于冗余代码。如果要使用Maatwebsite Excel的模型导入能力，可以替换为Excel::import(new UserImport(), $request->file('file'))，再配合导入完成的事件做关联绑定即可。

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